Futures Market Data
Public endpoints for funding rates, mark price, order book, klines, and open interest.
Base URL: https://fapi.bond.xyz — All endpoints in this section do not require authentication unless specified.
Order Book
GET
/fapi/v1/depth
Query symbol order book depth.
symbol
STRING
YES
Trading pair symbol (e.g., BTCUSDCPERP)
limit
INT
NO
Default 500; valid: 5, 10, 20, 50, 100, 500, 1000
{ "lastUpdateId": 1027024, "bids": [["4.00000000", "431.00000000"]], "asks": [["4.00000200", "12.00000000"]] }
Recent Trades
GET
/fapi/v1/trades
Get recent market trades. Only market trades (order book fills) are returned.
symbol
STRING
YES
Trading pair symbol
limit
INT
NO
Default 500; max 1000
[ { "id": 28457, "price": "4.00000100", "qty": "12.00000000", "quoteQty": "48.00", "time": 1499865549590, "isBuyerMaker": true } ]
Historical Trades
GET
/fapi/v1/historicalTrades
Get older market historical trades. Security: MARKET_DATA. Only supports data from within the last three months.
symbol
STRING
YES
Trading pair symbol
limit
INT
NO
Default 100; max 500
fromId
LONG
NO
TradeId to fetch from. Default gets most recent trades.
Aggregate Trades
GET
/fapi/v1/aggTrades
Get compressed, aggregate market trades. Trades filling in 100ms at the same price and side are aggregated.
symbol
STRING
YES
Trading pair symbol
fromId
LONG
NO
ID to get aggregate trades from INCLUSIVE
startTime
LONG
NO
Timestamp in ms INCLUSIVE
endTime
LONG
NO
Timestamp in ms INCLUSIVE
limit
INT
NO
Default 500; max 1000
[ { "a": 26129, // Aggregate tradeId "p": "0.01633102", // Price "q": "4.70443515", // Quantity "f": 26129, // First tradeId "l": 27781, // Last tradeId "T": 1498793709153, // Timestamp "m": true // Was the buyer the maker? } ]
Klines / Candlestick Data
GET
/fapi/v1/klines
Kline/candlestick bars for a symbol. Klines are uniquely identified by their open time.
symbol
STRING
YES
Trading pair symbol
interval
ENUM
YES
1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M
startTime
LONG
NO
Start time in milliseconds
endTime
LONG
NO
End time in milliseconds
limit
INT
NO
Default 500; max 1500
[ [ 1499040000000, // Open time "0.01634790", // Open "0.80000000", // High "0.01575800", // Low "0.01577100", // Close "148976.11427815", // Volume 1499644799999, // Close time "2434.19055334", // Quote asset volume 308, // Number of trades "1756.87402397", // Taker buy base volume "28.46694368", // Taker buy quote volume "0" // Ignore ] ]
Mark Price and Funding Rate
GET
/fapi/v1/premiumIndex
Get mark price, index price, and current funding rate for a symbol. Weight: 1 with symbol, 10 without.
symbol
STRING
NO
Trading pair symbol. If omitted, returns all symbols.
{ "symbol": "BTCUSDCPERP", "markPrice": "11793.63104562", "indexPrice": "11781.80495970", "lastFundingRate": "0.00038246", "interestRate": "0.00010000", "nextFundingTime": 1597392000000, "time": 1597370495002 }
Funding Rate History
GET
/fapi/v1/fundingRate
Get funding rate history. Results returned in ascending order.
symbol
STRING
NO
Trading pair symbol
startTime
LONG
NO
Timestamp in ms INCLUSIVE
endTime
LONG
NO
Timestamp in ms INCLUSIVE
limit
INT
NO
Default 100; max 1000
[ { "symbol": "BTCUSDT", "fundingRate": "-0.03750000", "fundingTime": 1570608000000, "markPrice": "34287.54619963" } ]
Open Interest
GET
/fapi/v1/openInterest
Get present open interest of a specific symbol. Weight: 1.
symbol
STRING
YES
Trading pair symbol
{ "openInterest": "10659.509", "symbol": "BTCUSDT", "time": 1589437530011 }
24hr Ticker Statistics
GET
/api/v1/ticker/24hr
24 hour rolling window price change statistics. Weight: 1 for single symbol, 40 when omitted.
symbol
STRING
NO
If omitted, tickers for all symbols returned in an array
{ "symbol": "BTCUSDC", "priceChange": "-94.99999800", "priceChangePercent": "-95.960", "weightedAvgPrice": "0.29628482", "lastPrice": "4.00000200", "volume": "8913.30000000", "quoteVolume": "15.30000000", "openTime": 1499783499040, "closeTime": 1499869899040, "count": 76 }