{"openapi":"3.1.0","info":{"title":"Crypto Basis API","version":"1.0.0","description":"Live crypto spot-versus-perpetual basis and premium as an API, served from the Bybit v5 feed. The basis is the gap between a coin's perpetual-futures price and its spot price: when the perp trades above spot the market is in contango (leveraged longs are paying up), when below it is in backwardation. For any coin this returns the spot price, the perp last, mark and index price, the basis in absolute and percentage terms, the mark-to-index premium, the market structure, and the funding rate — per-8-hour and annualised — that arbitrages the basis away. Get a coin's basis, or scan the majors ranked by basis. The cash-and-carry and funding-arbitrage signal layer for trading and dashboard apps. Live, no key, no cache. Distinct from funding-rate, open-interest and price APIs — this is the spot-perp basis.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cryptobasis-api","description":"oanor gateway"}],"tags":[{"name":"Basis"},{"name":"Scan"},{"name":"Symbols"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/basis":{"get":{"operationId":"get_v1_basis","tags":["Basis"],"summary":"A coin spot-perp basis, premium and funding","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Coin ticker","schema":{"type":"string"},"example":"BTC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"base":"BTC","symbol":"BTCUSDT","basis_abs":-35.5,"basis_pct":-0.0565,"structure":"backwardation","mark_price":62827.44,"perp_price":62821.2,"spot_price":62856.7,"index_price":62860.31,"funding_rate":-5.56e-6,"funding_8h_pct":-0.0006,"funding_annualized_pct":-0.61,"mark_index_premium_pct":-0.0523},"meta":{"timestamp":"2026-06-09T03:02:06.835Z","request_id":"c6fe828e-4139-4bc7-88aa-b709251855ac"},"status":"ok","message":"Basis retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/scan":{"get":{"operationId":"get_v1_scan","tags":["Scan"],"summary":"Majors ranked by basis","description":"","parameters":[{"name":"add","in":"query","required":false,"description":"Extra tickers, comma-separated","schema":{"type":"string"},"example":"PEPE,WIF"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"coins":[{"base":"BTC","symbol":"BTCUSDT","basis_abs":-35.5,"basis_pct":-0.0565,"structure":"backwardation","mark_price":62827.44,"perp_price":62821.2,"spot_price":62856.7,"index_price":62859.33,"funding_rate":-5.56e-6,"funding_8h_pct":-0.0006,"funding_annualized_pct":-0.61,"mark_index_premium_pct":-0.0507},{"base":"XRP","symbol":"XRPUSDT","basis_abs":0,"basis_pct":-0.0607,"structure":"backwardation","mark_price":1.1529,"perp_price":1.1529,"spot_price":1.1536,"index_price":1.1538,"funding_rate":-0.00021722,"funding_8h_pct":-0.0217,"funding_annualized_pct":-23.79,"mark_index_premium_pct":-0.078},{"base":"ETH","symbol":"ETHUSDT","basis_abs":-1.15,"basis_pct":-0.069,"structure":"backwardation","mark_price":1665.76,"perp_price":1665.75,"spot_price":1666.9,"index_price":1666.8,"funding_rate":-0.0002377,"funding_8h_pct":-0.0238,"funding_annualized_pct":-26.03,"mark_index_premium_pct":-0.0624},{"base":"DOGE","symbol":"DOGEUSDT","basis_abs":0,"basis_pct":-0.0703,"structure":"backwardation","mark_price":0.0853,"perp_price":0.0853,"spot_price":0.08536,"index_price":0.08535,"funding_rate":6.451e-5,"funding_8h_pct":0.0065,"funding_annualized_pct":7.06,"mark_index_premium_pct":-0.0586},{"base":"SOL","symbol":"SOLUSDT","basis_abs":-0.05,"basis_pct":-0.0759,"structure":"backwardation","mark_price":65.834,"perp_price":65.83,"spot_price":65.88,"index_price":65.88,"funding_rate":-0.00018018,"funding_8h_pct":-0.018,"funding_annualized_pct":-19.73,"mark_index_premium_pct":-0.0698},{"base":"LINK","symbol":"LINKUSDT","basis_abs":-0.01,"basis_pct":-0.0763,"structure":"backwardation","mark_price":7.859,"perp_price":7.858,"spot_price":7.864,"index_price":7.865,"funding_rate":-5.621e-5,"funding_8h_pct":-0.0056,"funding_annualized_pct":-6.15,"mark_index_premium_pct":-0.0763},{"base":"BNB","symbol":"BNBUSDT","basis_abs":-0.5,"basis_pct":-0.0835,"structure":"backwardation","mark_price":598.2,"perp_price":598.2,"spot_price":598.7,"index_price":598.44,"funding_rate":2.764e-5,"funding_8h_pct":0.0028,"funding_annualized_pct":3.03,"mark_index_premium_pct":-0.0401},{"base":"AVAX","symbol":"AVAXUSDT","basis_abs":-0.01,"basis_pct":-0.0901,"structure":"backwardation","mark_price":6.653,"perp_price":6.652,"spot_price":6.658,"index_price":6.658,"funding_rate":-0.00016338,"funding_8h_pct":-0.0163,"funding_annualized_pct":-17.89,"mark_index_premium_pct":-0.0751},{"base":"LTC","symbol":"LTCUSDT","basis_abs":-0.04,"basis_pct":-0.0939,"structure":"backwardation","mark_price":42.55,"perp_price":42.55,"spot_price":42.59,"index_price":42.59,"funding_rate":-0.0001643,"funding_8h_pct":-0.0164,"funding_annualized_pct":-17.99,"mark_index_premium_pct":-0.0939},{"base":"ADA","symbol":"ADAUSDT","basis_abs":0,"basis_pct":-0.1793,"structure":"backwardation","mark_price":0.167,"perp_price":0.167,"spot_price":0.1673,"index_price":0.1672,"funding_rate":-5.894e-5,"funding_8h_pct":-0.0059,"funding_annualized_pct":-6.45,"mark_index_premium_pct":-0.1196},{"base":"WIF","symbol":"WIFUSDT","basis_abs":0,"basis_pct":-0.2249,"structure":"backwardation","mark_price":0.15533,"perp_price":0.15525,"spot_price":0.1556,"index_price":0.15546,"funding_rate":-0.00010478,"funding_8h_pct":-0.0105,"funding_annualized_pct":-11.47,"mark_index_premium_pct":-0.0836}],"count":11},"meta":{"timestamp":"2026-06-09T03:02:07.445Z","request_id":"fd6d3248-6dbb-4254-bb5c-b91ecce78b54"},"status":"ok","message":"Scan retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/symbols":{"get":{"operationId":"get_v1_symbols","tags":["Symbols"],"summary":"Major coins covered by scan","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Any Bybit coin with both a USDT spot and a USDT linear perp works via symbol=<BASE>. The scan board covers these majors:","count":10,"majors":["BTC","ETH","SOL","BNB","XRP","DOGE","ADA","AVAX","LINK","LTC"]},"meta":{"timestamp":"2026-06-09T03:02:07.529Z","request_id":"ff94a4bb-0d53-44f7-a911-39cbf5a0ca85"},"status":"ok","message":"Symbols retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Bybit v5 spot + linear tickers (live)","service":"cryptobasis-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/scan":"Majors ranked by basis (add=PEPE,WIF to extend).","GET /v1/basis":"A coin's spot-perp basis, premium and funding (symbol=BTC).","GET /v1/symbols":"The majors covered by scan (any Bybit USDT spot+perp works)."},"description":"Live crypto spot-vs-perpetual basis and premium from Bybit v5: for any coin, the spot price, the perp last/mark/index price, the basis (absolute and percent), the mark-to-index premium, the market structure (contango/backwardation/flat) and the funding rate (per-8h and annualised). Get a coin's basis or scan the majors ranked by basis. Live, no key. Distinct from funding-rate, open-interest and price APIs — this is the spot-perp basis / cash-and-carry signal.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:07.782Z","request_id":"ccf97bf3-8bdc-43e8-8275-510879a57f68"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8000,"rps_limit":5,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1400,"monthly_call_quota":105000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3500,"monthly_call_quota":520000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":8300,"monthly_call_quota":2700000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cryptobasis-api"}