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
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | No | Trading 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
| Parameter | Type | Description |
|---|---|---|
| code | string | Response code |
| msg | string | Response message |
| requestTime | number | Request timestamp in milliseconds |
| data | object/array | Response data (object for single symbol, array for all) |
| > symbol | string | Trading pair symbol |
| > markPrice | string | Current mark price used for liquidation and unrealized PnL |
| > indexPrice | string | Spot index price calculated from multiple exchanges |
| > estimatedSettlePrice | string | Estimated settlement price for the contract |
| > lastFundingRate | string | Most recent funding rate applied |
| > interestRate | string | Interest rate component of funding rate |
| > nextFundingTime | number | Next funding time in milliseconds (Unix timestamp) |
| > ts | number | Data 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
| Code | Message |
|---|---|
| 40034 | symbol does not exist |
| 50010 | Upstream response invalid |