# Funding Rates API > Live crypto perpetual funding rates and derivatives data as an API, streamed from the Bybit v5 public market feed. For every USDT perpetual futures contract: its symbol, last / mark / index price, the current funding rate (per interval, plus percentage and annualised), the next funding time, open interest, 24-hour volume and turnover, and 24-hour price change. Look a contract up by symbol or base coin, rank contracts by funding, open interest, turnover or price move — a ready-made signal for crowded longs and shorts — search, or list them all. Built for trading, quant, dashboard and signal apps. Distinct from spot-price and on-chain data. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/fundingrates-api/..." ``` ## Pricing - **Free** (Free) — 200 calls/Mo, 3 req/s - **Trader** ($13/Mo) — 10,000 calls/Mo, 10 req/s - **Pro** ($37/Mo) — 50,000 calls/Mo, 25 req/s - **Desk** ($89/Mo) — 250,000 calls/Mo, 50 req/s ## Endpoints ### Funding #### `GET /v1/funding` — Funding + derivatives data for a contract **Parameters:** - `symbol` (query, optional, string) — Contract symbol (preferred) Example: `BTCUSDT` - `base` (query, optional, string) — Base coin, e.g. BTC **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fundingrates-api/v1/funding?symbol=BTCUSDT" ``` **Response:** ```json { "data": { "contract": { "symbol": "BTCUSDT", "last_price": 62800.6, "mark_price": 62800.6, "volume_24h": 85295.789, "index_price": 62831.8, "funding_rate": -5.56e-6, "turnover_24h": 5400095478.3836, "open_interest": 54721.884, "funding_rate_pct": -0.000556, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 3436567148.33, "price_change_24h_pct": -0.31, "funding_rate_annualized_pct": -0.61 } }, "meta": { "timestamp": "2026-06-09T03:03:45.644Z", "request_id": "1e38ed5d-367e-492e-b7fb-496bc4b98d30" }, "status": "ok", "message": "Funding rate retrieved successfully", "success": true } ``` #### `GET /v1/list` — List all perpetuals **Parameters:** - `limit` (query, optional, string) — Max 1-1000 Example: `50` - `offset` (query, optional, string) — Offset Example: `0` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fundingrates-api/v1/list?limit=50&offset=0" ``` **Response:** ```json { "data": { "count": 50, "total": 688, "contracts": [ { "symbol": "BTCUSDT", "last_price": 62800.6, "mark_price": 62800.6, "volume_24h": 85295.793, "index_price": 62831.8, "funding_rate": -5.56e-6, "turnover_24h": 5400095729.586, "open_interest": 54721.884, "funding_rate_pct": -0.000556, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 3436567148.33, "price_change_24h_pct": -0.31, "funding_rate_annualized_pct": -0.61 }, { "symbol": "ETHUSDT", "last_price": 1665.04, "mark_price": 1665.03, "volume_24h": 2249780.68, "index_price": 1666.05, "funding_rate": -0.0002355, "turnover_24h": 3777987088.3854, "open_interest": 905678.11, "funding_rate_pct": -0.02355, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 1507981223.49, "price_change_24h_pct": -0.93, "funding_rate_annualized_pct": -25.79 }, { "symbol": "SOLUSDT", "last_price": 65.79, "mark_price": 65.798, "volume_24h": 10094251 …(truncated, see openapi.json for full schema) ``` #### `GET /v1/search` — Search contracts by symbol **Parameters:** - `q` (query, required, string) — Symbol fragment Example: `ETH` - `limit` (query, optional, string) — Max 1-100 Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fundingrates-api/v1/search?q=ETH&limit=25" ``` **Response:** ```json { "data": { "count": 13, "query": "ETH", "total": 13, "contracts": [ { "symbol": "ETHUSDT", "last_price": 1665.04, "mark_price": 1665.03, "volume_24h": 2249780.68, "index_price": 1666.05, "funding_rate": -0.0002355, "turnover_24h": 3777987088.3854, "open_interest": 905678.11, "funding_rate_pct": -0.02355, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 1507981223.49, "price_change_24h_pct": -0.93, "funding_rate_annualized_pct": -25.79 }, { "symbol": "ETHPERP", "last_price": 1665.17, "mark_price": 1665.17, "volume_24h": 6174.06, "index_price": 1665.82, "funding_rate": -0.00011029, "turnover_24h": 10364759.8113, "open_interest": 21907.47, "funding_rate_pct": -0.011029, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 36479661.82, "price_change_24h_pct": -0.89, "funding_rate_annualized_pct": -12.08 }, { "symbol": "ETHFIUSDT", "last_price": 0.2997, "mark_price": 0.2997, …(truncated, see openapi.json for full schema) ``` ### Rankings #### `GET /v1/rank` — Rank contracts by a metric **Parameters:** - `by` (query, optional, string) — funding_rate | open_interest | turnover | volume | price_change Example: `funding_rate` - `order` (query, optional, string) — desc or asc Example: `desc` - `limit` (query, optional, string) — Max 1-200 Example: `10` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fundingrates-api/v1/rank?by=funding_rate&order=desc&limit=10" ``` **Response:** ```json { "data": { "count": 10, "order": "desc", "metric": "funding_rate", "ranking": [ { "value": 0.00454155, "symbol": "MBOXUSDT", "position": 1, "last_price": 0.005841, "mark_price": 0.005832, "volume_24h": 188003894, "index_price": 0.005814, "funding_rate": 0.00454155, "turnover_24h": 1305869.9614, "open_interest": 51999282, "funding_rate_pct": 0.454155, "next_funding_time": "2026-06-09T04:00:00.000Z", "open_interest_value": 303259.81, "price_change_24h_pct": -16.5, "funding_rate_annualized_pct": 497.3 }, { "value": 0.00327489, "symbol": "1000BTTUSDT", "position": 2, "last_price": 0.0002683, "mark_price": 0.000265, "volume_24h": 725937000, "index_price": 0.0002636, "funding_rate": 0.00327489, "turnover_24h": 197037.6889, "open_interest": 1575558400, "funding_rate_pct": 0.327489, "next_funding_time": "2026-06-09T08:00:00.000Z", "open_interest_value": 417522.98, "price_change_24h_pct": -1.58, "funding_rate_annualized_pct": 358.6 …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/fundingrates-api/v1/meta" ``` **Response:** ```json { "data": { "source": "Bybit v5 linear tickers (live)", "service": "fundingrates-api", "endpoints": { "GET /v1/list": "List all perpetuals by turnover (limit, offset).", "GET /v1/meta": "This document.", "GET /v1/rank": "Rank contracts by metric (by=funding_rate|open_interest|turnover|volume|price_change, order, limit).", "GET /v1/search": "Search contracts by symbol (q=ETH).", "GET /v1/funding": "Funding + derivatives data by symbol (symbol=BTCUSDT) or base coin (base=BTC)." }, "description": "Live crypto perpetual funding rates and derivatives data from Bybit v5 (USDT perpetuals): symbol, last/mark/index price, funding rate (per interval, % and annualised), next funding time, open interest, 24h volume/turnover and price change. Look up by symbol or base coin, rank by funding/OI/turnover/price move, or search. Live, no key.", "contracts_live": 688, "rankable_metrics": [ "funding_rate", "open_interest", "turnover", "volume", "price_change" ], "funding_interval_hours": 8 }, "meta": { "timestamp": "2026-06-09T03:03:47.189Z", "request_id": "73bb8ab4-9960-49ac-b8a8-f8ae07f2159c" }, "status": "ok", "message": "Meta", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/fundingrates-api OpenAPI spec: https://www.oanor.com/api/fundingrates-api/openapi.json