{"openapi":"3.1.0","info":{"title":"Index & Treasury Futures API","version":"1.0.0","description":"Live financial futures as an API — front-month prices for the major US index and Treasury futures, served from Yahoo Finance. For any contract it returns the current price, the previous close, the absolute and percentage change on the day, the day's high and low, the 52-week high and low, the contract month and the currency. Index futures (E-mini S&P 500, Nasdaq-100, Dow, Russell 2000) trade nearly around the clock and are the market's go-to read on where the open is heading; Treasury futures (2-, 5-, 10- and 30-year notes and bonds) track interest-rate expectations. Look a contract up by name or ticker alias, pull a category board (index or rates) ranked by the day's move, or get the whole board in one call. The futures-quote layer for trading, pre-market and dashboard apps. Live, no key, no cache. Distinct from spot index APIs and from the physical-commodity futures API — this is financial (index and rate) futures.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/futures-api","description":"oanor gateway"}],"tags":[{"name":"Future"},{"name":"Category"},{"name":"List"},{"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/future":{"get":{"operationId":"get_v1_future","tags":["Future"],"summary":"One futures contract quote","description":"","parameters":[{"name":"future","in":"query","required":true,"description":"Contract key or alias (e.g. sp500, nasdaq100, tnote10y, es, zn)","schema":{"type":"string"},"example":"sp500"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"E-mini S&P 500","as_of":"2026-06-09T02:52:09.000Z","price":7420.75,"change":4.75,"future":"sp500","symbol":"ES=F","day_low":7390.25,"category":"index","contract":"Jun 26","currency":"USD","day_high":7428,"change_pct":0.06,"week52_low":5918.25,"week52_high":7632.25,"previous_close":7416},"meta":{"timestamp":"2026-06-09T03:02:14.791Z","request_id":"c85a6396-c1c3-404c-83fc-62628be8b0d0"},"status":"ok","message":"Future 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/category":{"get":{"operationId":"get_v1_category","tags":["Category"],"summary":"A category board ranked by day change","description":"","parameters":[{"name":"category","in":"query","required":true,"description":"Category: index|rates","schema":{"type":"string"},"example":"index"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"futures":[{"name":"E-mini Nasdaq-100","as_of":"2026-06-09T02:52:12.000Z","price":29495.75,"change":41,"future":"nasdaq100","symbol":"NQ=F","day_low":29303.5,"category":"index","contract":"Jun 26","currency":"USD","day_high":29547.75,"change_pct":0.14,"week52_low":21435.5,"week52_high":30807.75,"previous_close":29454.75},{"name":"E-mini S&P 500","as_of":"2026-06-09T02:52:09.000Z","price":7420.75,"change":4.75,"future":"sp500","symbol":"ES=F","day_low":7390.25,"category":"index","contract":"Jun 26","currency":"USD","day_high":7428,"change_pct":0.06,"week52_low":5918.25,"week52_high":7632.25,"previous_close":7416},{"name":"E-mini Russell 2000","as_of":"2026-06-09T02:52:12.000Z","price":2861.2,"change":1.7,"future":"russell2000","symbol":"RTY=F","day_low":2843.9,"category":"index","currency":"USD","day_high":2864.1,"change_pct":0.06,"week52_low":2071.8,"week52_high":2952,"previous_close":2859.5},{"name":"Mini Dow Jones","as_of":"2026-06-09T02:52:03.000Z","price":50845,"change":-11,"future":"dow","symbol":"YM=F","day_low":50685,"category":"index","contract":"Jun 26","currency":"USD","day_high":50885,"change_pct":-0.02,"week52_low":41769,"week52_high":51849,"previous_close":50856}],"category":"index"},"meta":{"timestamp":"2026-06-09T03:02:14.947Z","request_id":"9726893b-6bff-4028-85f1-ea48448d75a2"},"status":"ok","message":"Category board 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/list":{"get":{"operationId":"get_v1_list","tags":["List"],"summary":"Whole futures board in one call","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":9,"futures":[{"name":"E-mini Nasdaq-100","as_of":"2026-06-09T02:52:12.000Z","price":29495.75,"change":41,"future":"nasdaq100","symbol":"NQ=F","day_low":29303.5,"category":"index","contract":"Jun 26","currency":"USD","day_high":29547.75,"change_pct":0.14,"week52_low":21435.5,"week52_high":30807.75,"previous_close":29454.75},{"name":"E-mini S&P 500","as_of":"2026-06-09T02:52:09.000Z","price":7420.75,"change":4.75,"future":"sp500","symbol":"ES=F","day_low":7390.25,"category":"index","contract":"Jun 26","currency":"USD","day_high":7428,"change_pct":0.06,"week52_low":5918.25,"week52_high":7632.25,"previous_close":7416},{"name":"E-mini Russell 2000","as_of":"2026-06-09T02:52:12.000Z","price":2861.2,"change":1.7,"future":"russell2000","symbol":"RTY=F","day_low":2843.9,"category":"index","currency":"USD","day_high":2864.1,"change_pct":0.06,"week52_low":2071.8,"week52_high":2952,"previous_close":2859.5},{"name":"2-Year T-Note","as_of":"2026-06-09T02:51:04.000Z","price":102.98,"change":-0.01,"future":"tnote2y","symbol":"ZT=F","day_low":102.96,"category":"rates","contract":"Sep 2026","currency":"USD","day_high":102.98,"change_pct":-0.01,"week52_low":102.96,"week52_high":104.61,"previous_close":102.99},{"name":"Mini Dow Jones","as_of":"2026-06-09T02:52:03.000Z","price":50845,"change":-11,"future":"dow","symbol":"YM=F","day_low":50685,"category":"index","contract":"Jun 26","currency":"USD","day_high":50885,"change_pct":-0.02,"week52_low":41769,"week52_high":51849,"previous_close":50856},{"name":"5-Year T-Note","as_of":"2026-06-09T02:52:09.000Z","price":106.56,"change":-0.05,"future":"tnote5y","symbol":"ZF=F","day_low":106.52,"category":"rates","contract":"Sep 2026","currency":"USD","day_high":106.59,"change_pct":-0.05,"week52_low":106.41,"week52_high":110.22,"previous_close":106.62},{"name":"10-Year T-Note","as_of":"2026-06-09T02:52:12.000Z","price":108.95,"change":-0.08,"future":"tnote10y","symbol":"ZN=F","day_low":108.86,"category":"rates","contract":"Sep 2026","currency":"USD","day_high":109,"change_pct":-0.07,"week52_low":108.56,"week52_high":114.38,"previous_close":109.03},{"name":"30-Year T-Bond","as_of":"2026-06-09T02:51:07.000Z","price":111.25,"change":-0.25,"future":"tbond30y","symbol":"ZB=F","day_low":111.09,"category":"rates","currency":"USD","day_high":111.38,"change_pct":-0.22,"week52_low":109.5,"week52_high":119.59,"previous_close":111.5},{"name":"Ultra T-Bond","as_of":"2026-06-09T02:52:13.000Z","price":113.56,"change":-0.28,"future":"ultrabond","symbol":"UB=F","day_low":113.38,"category":"rates","currency":"USD","day_high":113.69,"change_pct":-0.25,"week52_low":111.16,"week52_high":124.31,"previous_close":113.84}]},"meta":{"timestamp":"2026-06-09T03:02:15.126Z","request_id":"6a3a99a7-51ff-40b9-9341-6c37c78d5f60"},"status":"ok","message":"Futures board 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 and full contract list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Yahoo Finance public chart API (live)","futures":{"dow":"Mini Dow Jones","sp500":"E-mini S&P 500","tnote2y":"2-Year T-Note","tnote5y":"5-Year T-Note","tbond30y":"30-Year T-Bond","tnote10y":"10-Year T-Note","nasdaq100":"E-mini Nasdaq-100","ultrabond":"Ultra T-Bond","russell2000":"E-mini Russell 2000"},"service":"futures-api","endpoints":{"GET /v1/list":"The whole futures board in one call.","GET /v1/meta":"This document (with the full contract list).","GET /v1/future":"One futures quote (future=sp500|nasdaq100|tnote10y|… or aliases like es, nq, zn).","GET /v1/category":"A category board ranked by day change (category=index|rates)."},"categories":["index","rates"],"description":"Live US index and Treasury futures from Yahoo Finance: for any contract, the front-month price, previous close, day change (absolute and percent), day high/low, 52-week high/low, contract month and currency. Index futures (E-mini S&P 500, Nasdaq-100, Dow, Russell 2000) and rate futures (2/5/10/30-year Treasuries). Look one up, pull a category board (index or rates) ranked by the day's move, or get the whole board. Live, no key. Distinct from spot index APIs and the physical-commodity futures API — this is financial (index and rate) futures.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T03:02:15.249Z","request_id":"3270b12f-ef5f-4ec2-8fae-fbec8119b9d0"},"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":1100,"monthly_call_quota":115000,"rps_limit":15,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2800,"monthly_call_quota":620000,"rps_limit":40,"hard_limit":true},{"slug":"desk","name":"Desk","price_cents_month":6400,"monthly_call_quota":3100000,"rps_limit":100,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/futures-api"}