OptimistFi

OptimistFi Perps Data API

Funding, open interest, prices and leverage caps for perpetual futures across venues, in one schema. The live API needs no key; the historical dataset of…

Finance & banking#cryptocurrency

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Funding, open interest, prices and leverage caps for perpetual futures across venues, in one schema. The live API needs no key; the historical dataset of stock, commodity, FX and index perps needs an API key.

Endpoints 11

Live

  • GETSnapshot/api/perps/snapshotEverything at once: venue health, market totals and every matched asset with its quote on each venue. Rebuilt every 4 seconds (Hyperliquid and its builder…
  • GETList assets/api/perps/assetsMatched assets, one row per underlying across venues, filtered, sorted and paged. Rebuilt every 4 seconds (Hyperliquid and its builder venues every 10);…
  • GETGet an asset/api/perps/assets/:assetOne underlying on every venue, with each venue's funding history and statistics: average, range and the share of hours longs paid. Funding history refreshes…
  • GETList funding gaps/api/perps/fundingThe widest carry between two venues on each asset, widest first: the cheapest venue to hold a long, the richest to hold a short, and the thinner side's open…
  • GETList markets/api/perps/marketsEvery matched venue listing as its own row, largest open interest first: the shape for joins and screens. Rebuilt every 4 seconds (Hyperliquid and its builder…
  • GETList venues/api/perps/venuesThe venue registry (network, settlement, funding interval, source endpoint) joined to each venue's live health, size and known gaps. Rebuilt every 4 seconds…
  • GETWhale trades/api/perps/whalesThe newest large taker orders of the last hour: $100K or more in crypto, $25K or more in stock, commodity, FX and index perps, on Lighter, Aster and…
  • GETMarket overview/api/perps/liveThe perps front page in one payload: the market strip, trending stock and macro perps, cost to hold at 10x, top gainers and losers, each row with its leverage…

Historical dataset

  • GETList dataset markets/api/perps/data/marketsEvery stock, commodity, FX and index perp the dataset serves: venue, symbol, underlying, leverage cap, funding interval and when its record starts. Private,…
  • GETHourly history/api/perps/data/history?base=stringThe hourly record of an underlying on every served venue: mark and index price, premium, open interest in total and by side, 24-hour volume, funding and…
  • GETFunding history/api/perps/data/funding?base=stringEvery funding settlement of an underlying on every served venue, as a rate per hour, back to each listing where the venue publishes it. At most 366 days a…

API details

Base URL
https://optimistfi.com
Authentication
A bearer token in the Authorization header
Operations
11 operations on 11 pathsGET 11
Main resources
Live 8Historical dataset 3
Response formats
application/json text/csv
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the OptimistFi Perps Data API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the OptimistFi Perps Data API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Snapshot” (GET /api/perps/snapshot), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the OptimistFi Perps Data API?

Funding, open interest, prices and leverage caps for perpetual futures across venues, in one schema. The live API needs no key; the historical dataset of… It is listed under Finance & banking and has 11 endpoints.

Who publishes the OptimistFi Perps Data API?

It is listed from OptimistFi's public API description (an OpenAPI document), not published by OptimistFi on Swastik Codes. Anyone who controls optimistfi.com can claim the profile by adding a DNS TXT record.

What is the base URL of the OptimistFi Perps Data API?

Requests go to https://optimistfi.com. Endpoint paths are added to this base URL.

How do I authenticate with the OptimistFi Perps Data API?

With A bearer token in the Authorization header.

How many endpoints does the OptimistFi Perps Data API have?

11 operations on 11 paths (11 GET). The largest groups are Live, Historical dataset.

Is forking the OptimistFi Perps Data API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.