Funding Payments
GET
https://api.onetrading.com/fast/v1/account/futures/funding-payments
order). If no instrument code is provided, funding payments are returned for all futures markets.from and to parameters| Parameters Provided | Behaviour |
|---|---|
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 (capped at the current time) |
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 92 days) |
from/to accept epoch (s, ms, µs or ns) or an ISO 8601 UTC timestamp ending in Z (or YYYY-MM-DD). from must be on or after 2024-01-01, not in the future, and strictly before to; to is exclusive.cursor is an opaque string. Pass the value from the previous response unchanged; it is null (or absent) on the last page.400 UNEXPECTED_PARAMETERS.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), 1695647130123456789 (ns) | |
| 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), 1695734400456789012 (ns) | |
| Date | 2025-09-26 | |
instrument_code | String | BTC_USD_P (single) |
| List | BTC_USD_P,ETH_USD_P (comma-separated list) | |
limit | Integer | 50 |
order | String | DESC or ASC |
cursor | String | eyJlcG9jaCI6IjE3Njk2MDE2MDEwNTQzNzk0NTciLCJjcW8iOiIyMTExMjMyMjkwMTU1ODc3In0= |
Parameter Limits
| Parameter | Constraints / Range |
|---|---|
from | Date between 2024-01-01 and present |
to | Strictly after from; the period between from and to must not exceed 92 days |
limit | Integer between 1 and 200 (max_page_size is accepted as a deprecated alias; limit wins if both are sent) |
order | DESC or ASC |
instrument_code | Optional; must be valid futures market code(s) |
cursor | Optional; string returned by previous response |
Parameter Defaults
| Parameter(s) | Default Behaviour |
|---|---|
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 = midnight UTC, 7 days earlier |
instrument_code | Defaults to all futures markets |
limit | Defaults to 200 |
order | Defaults to DESC |
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.onetrading.com/fast/v1/account/futures/funding-payments?from=2026-01-22&to=2026-01-29T00%3A00%3A00Z&instrument_code=BTC_USD_P&cursor=&max_page_size=100&limit=50&order=DESC' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success Example
{
"account_id": "aaaba8bd-3195-4f72-87ff-98720a940f23",
"funding_payments": [
{
"account_id": "aaaba8bd-3195-4f72-87ff-98720a940f23",
"position_id": "2111199765938682",
"instrument_code": "BTC_USD_P",
"funding_rate": "0.0000179051",
"mark_price": "89361.93",
"funding_payment": "-0.0144",
"cash_balance": "106628.0604",
"time": "2026-01-28T20:00:01.055392Z",
"time_nanos": "2026-01-28T20:00:01.055392483Z"
},
{
"account_id": "aaaba8bd-3195-4f72-87ff-98720a940f23",
"position_id": "2111199765938682",
"instrument_code": "BTC_USD_P",
"funding_rate": "0.0000179029",
"mark_price": "89390.01",
"funding_payment": "-0.0144",
"cash_balance": "106655.4032",
"time": "2026-01-28T16:00:01.055094Z",
"time_nanos": "2026-01-28T16:00:01.055094817Z"
}
],
"from": "2026-01-22T00:00:00.000000000Z",
"to": "2026-01-29T00:00:00.000000000Z",
"limit": 2,
"max_page_size": 2,
"cursor": "eyJlcG9jaCI6IjE3Njk2MDE2MDEwNTQzNzk0NTciLCJjcW8iOiIyMTExMjMyMjkwMTU1ODc3In0="
}