Bond

Checking network...

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 }