GET /v1/futures/latest
Updated
What does GET /v1/futures/latest do?
The most recent closed row for one futures contract on one venue. Returns the latest complete row for a single linear futures contract: mark, index and last price, best bid and ask, the funding rate and next funding time, open interest in coins and in value, volume with the taker buy split, the trade count and, from Max, the long and short liquidations of the window.
The row is the most recent complete bucket at your plan’s granularity: yesterday’s daily bar on Free, the last closed hour on Pro, the last closed 5 minutes on Max, the last closed minute on Ultra and pay-per-call. Symbols are the venue’s own (BTCUSDT on Binance and Bybit, BTC-USDT-SWAP on OKX, BTC_USDT on Gate and MEXC, XBTUSDTM on KuCoin).
Pass columns to narrow the row. Columns outside your plan are omitted and named in the X-BlackForge-Columns-Omitted header.
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. |
symbol | string | Yes | The venue's own contract symbol, as GET /v1/futures/symbols lists it: BTCUSDT (binance, bybit, bitget), BTC-USDT-SWAP (okx), BTC_USDT (gate, mexc), XBTUSDTM (kucoin). |
columns | string | No | Comma-separated futures column keys from GET /v1/catalog (`futures.metrics`). Omitted means every column your plan includes. Columns outside your plan are omitted and named in the X-BlackForge-Columns-Omitted response header. |
Parameter shapes from the live OpenAPI document.
Example request
curl -H "x-api-key: $BLACKFORGE_API_KEY" \
"$BF/v1/futures/latest?exchange=bybit&symbol=BTCUSDT&columns=markPrice,indexPrice,fundingRate,nextFundingTime,openInterest,openInterestValue,quoteVolume,takerBuyQuoteVolume,liqLongNotional,liqShortNotional"Example response
{
"ts": 1794232500000,
"interval": "1m",
"values": {
"markPrice": 74696.12,
"indexPrice": 74725.86,
"fundingRate": 0.00006904,
"nextFundingTime": 1794240000000,
"openInterest": 70149.685,
"openInterestValue": 5239909288.722199,
"quoteVolume": 917232.5564999991,
"takerBuyQuoteVolume": 565642.7333000005,
"liqLongNotional": 0,
"liqShortNotional": 0
}
}Returns
A JSON object with ts (the window end in epoch milliseconds), interval, values (the requested columns, null where the venue publishes no such value) and quality (the row’s bitmask, its named flags and the column families they contaminate).
Responses and errors
| Status | When |
|---|---|
400 | A required parameter is missing, or a named column is not in the futures catalog. |
401 | The x-api-key header is missing or not a valid key. |
402 | No key and no x402 payment: the pay-per-call challenge is returned. |
403 | The venue is not on your plan. |
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.