GET /v1/futures/symbols
Updated
What does GET /v1/futures/symbols do?
Every linear futures contract a venue currently lists, as the venue’s own symbols. Returns the contracts a futures venue lists today, written the way that venue writes them, perpetual and dated together. Use it to discover what to query before calling the other futures endpoints.
The list tracks listings and expiries, so it is the honest current universe rather than a static file. It is not metered.
Authentication
API key required. Set $BF to the API base and pass your key in $BLACKFORGE_API_KEY.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
exchange | string | Yes | Futures venue: binance, bitget, bybit, gate, kucoin, mexc, okx. |
Parameter shapes from the live OpenAPI document.
Example request
curl -H "x-api-key: $BLACKFORGE_API_KEY" \
"$BF/v1/futures/symbols?exchange=okx"Example response
[
"0G-USDT-SWAP",
"1INCH-USDT-SWAP",
"2Z-USDT-SWAP",
"A-USDT-SWAP",
"AAOI-USDT-SWAP",
"AAPL-USDT-SWAP",
"AAVE-USDT-SWAP",
"ABBV-USDT-SWAP",
"ACH-USDT-SWAP",
"ACN-USDT-SWAP",
"ACT-USDT-SWAP",
"ACU-USDT-SWAP",
"…"
]Returns
A JSON array of the venue’s contract symbols, sorted.
Responses and errors
| Status | When |
|---|---|
400 | The exchange parameter is missing or names a venue with no futures. |
401 | The x-api-key header is missing or not a valid key. |
Columns it returns
Every futures column, its unit, the plan it opens on and the venues that publish it are on the futures data page, with the limits of each venue’s data.