Funding Payments
Developing
GET
https://api.onetrading.com/fast/v1/account/futures/funding-payments
from and to parameters| Parameters Provided | Behavior |
|---|---|
Neither from nor to | Returns last 7 days from UTC midnight to current time |
Only from | Returns 7 days starting from the provided from date |
Only to | Returns 7 days ending at the provided to date (starting from UTC midnight 7 days prior) |
Both from and to | Returns funding payments within the specified date range (max 90 days) |
Parameter Specification
| Parameter | Accepted Formats | Example Values |
|---|---|---|
from | ISO 8601 | 2025-09-25T13:45:30Z (s), 2025-09-25T13:45:30.123Z (ms), 2025-09-25T13:45:30.123456Z (us) |
| Epoch | 1695647130 (s), 1695647130123 (ms), 1695647130123456 (us) | |
| Date | 2025-09-25 | |
to | ISO 8601 | 2025-09-26T18:00:00Z (s), 2025-09-26T18:00:00.456Z (ms), 2025-09-26T18:00:00.456789Z (us) |
| Epoch | 1695734400 (s), 1695734400456 (ms), 1695734400456789 (us) | |
| Date | 2025-09-26 | |
instrument_code | String | BTC_EUR_P (single) |
| List | BTC_EUR_P,ETH_EUR_P (comma-separated list) | |
max_page_size | Integer | 3 |
cursor | String | eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... |
Parameter Limits
| Parameter | Constraints / Range |
|---|---|
from | Date between 2024-01-01 and present |
to | Date not earlier than from; the period between from and to must not exceed 30 days |
max_page_size | Integer between 0 and 10 |
instrument_code | Optional; must be valid market code(s) |
cursor | Optional; string returned by previous response |
Parameter Defaults
| Parameter(s) | Default Behavior |
|---|---|
from / to | Neither provided: from = 7 days ago at midnight UTC, to = present time |
from / to | Only from provided: to = 7 days later or present time, whichever is smaller |
from / to | Only to provided: from = 7 days earlier |
instrument_code | Defaults to all perpetual markets |
max_page_size | Defaults to 3 |
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.onetrading.com/fast/v1/account/futures/funding-payments?from=2025-01-15T10:30:00Z&to=2025-01-16T10:30:00Z&instrument_code=BTC_EUR_P&cursor=1754395201021329&max_page_size=100' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - With Cursor
{
"account_id": "abc12345-6789-abcd-efgh-ijklmnopqrst",
"funding_payments": {
"ETH_EUR_P": [
{
"timestamp": "2025-08-05T12:00:16.011Z",
"funding_payment": 0.1727217,
"cash_balance": 9380.49600963
}
],
"BTC_EUR_P": [
{
"timestamp": "2025-08-05T12:00:01.021Z",
"funding_payment": -0.02739235,
"cash_balance": 9383.89391196
}
]
},
"max_page_size": 2,
"cursor": "1754395201021329"
}