Skip to main content

Get Mark Price

Get the current mark price, index price, and funding rate information for futures symbols.

HTTP Request

GET /api/v1/future/market/mark-price

Request Parameters

ParameterTypeRequiredDescription
symbolstringNoTrading pair symbol (e.g., BTCUSDT). If omitted, returns all symbols

Request Example

Single Symbol Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/mark-price?symbol=BTCUSDT"

All Symbols Request

curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/mark-price"

Response Parameters

ParameterTypeDescription
codestringResponse code
msgstringResponse message
requestTimenumberRequest timestamp in milliseconds
dataobject/arrayResponse data (object for single symbol, array for all)
> symbolstringTrading pair symbol
> markPricestringCurrent mark price used for liquidation and unrealized PnL
> indexPricestringSpot index price calculated from multiple exchanges
> estimatedSettlePricestringEstimated settlement price for the contract
> lastFundingRatestringMost recent funding rate applied
> interestRatestringInterest rate component of funding rate
> nextFundingTimenumberNext funding time in milliseconds (Unix timestamp)
> tsnumberData timestamp in milliseconds (Unix timestamp)

Response Example

Success Response (Single Symbol)

{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": {
"symbol": "BTCUSDT",
"markPrice": "91234.56",
"indexPrice": "91200.12",
"estimatedSettlePrice": "91300.00",
"lastFundingRate": "0.0001",
"interestRate": "0.0001",
"nextFundingTime": 1763459280833,
"ts": 1763459280833
}
}

Success Response (All Symbols)

{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": [
{
"symbol": "BTCUSDT",
"markPrice": "91234.56",
"indexPrice": "91200.12",
"estimatedSettlePrice": "91300.00",
"lastFundingRate": "0.0001",
"interestRate": "0.0001",
"nextFundingTime": 1763459280833,
"ts": 1763459280833
},
{
"symbol": "ETHUSDT",
"markPrice": "3456.78",
"indexPrice": "3455.00",
"estimatedSettlePrice": "3460.00",
"lastFundingRate": "0.00015",
"interestRate": "0.0001",
"nextFundingTime": 1763459280833,
"ts": 1763459280833
}
]
}

Error Codes

CodeMessage
40034symbol does not exist
50010Upstream response invalid