Get Historical Funding Rate
Get historical funding rate data for a futures symbol with time-based filtering.
HTTP Request
GET /api/v1/future/market/history-fund-rate
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Trading pair symbol (e.g., BTCUSDT) |
| limit | number | No | Number of records to return (default: 100, max: 1000) |
| startTime | number | No | Start time in milliseconds (Unix timestamp) |
| endTime | number | No | End time in milliseconds (Unix timestamp) |
Request Example
Basic Request
curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/history-fund-rate?symbol=BTCUSDT&limit=100"
Request with Time Range
curl -X GET "https://open-api.bydoxe.com/api/v1/future/market/history-fund-rate?symbol=BTCUSDT&startTime=1732000000000&endTime=1732086400000&limit=100"
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | string | Response code |
| msg | string | Response message |
| requestTime | number | Request timestamp in milliseconds |
| data | array | Array of historical funding rate data |
| > symbol | string | Trading pair symbol |
| > fundingRate | string | Funding rate value |
| > fundingTime | number | Funding time in milliseconds (Unix timestamp) |
Response Example
Success Response
{
"code": "00000",
"msg": "success",
"requestTime": 1732000000000,
"data": [
{
"symbol": "BTCUSDT",
"fundingRate": "0.0001",
"fundingTime": 1763459280833
}
]
}
Error Codes
| Code | Message |
|---|---|
| 40034 | symbol does not exist |
| 50010 | Upstream response invalid |