Get Trades
GET
https://api.onetrading.com/fast/v1/account/trades
order=ASC for ascending).Parameter Specification
| Parameter | Accepted Formats | Example Values |
|---|---|---|
from | ISO 8601 (UTC, ending in Z) | 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 (UTC, ending in Z) | 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), 1695734400456789123 (ns) | |
| Date | 2025-09-26 | |
instrument_code | String | BTC_EUR_P (a single instrument code) |
order | String | ASC or DESC |
max_page_size | Integer | 3 |
cursor | String | eyJlcG9jaCI6IjE3NjQ2NzUxNDk5MzkzNjQwMDEiLCJjcW8iOiIyMTA1MzM3MTM0NDYxMjU3In0= |
Parameter Limits
| Parameter | Constraints / Range |
|---|---|
from | On or after 2024-01-01; cannot be in the future |
to | On or after 2024-01-01; must be strictly after from and no more than 30 days after from; exclusive |
max_page_size | Integer between 1 and 100 |
instrument_code | Optional; must be a valid instrument code |
order | Optional; ASC or DESC (case-insensitive) |
Parameter Defaults
| Parameter(s) | Default Behavior |
|---|---|
from / to | Neither provided: from = midnight UTC of the previous day, to = present time |
from / to | Only from provided: to = 1 day later or present time, whichever is smaller |
from / to | Only to provided: from = midnight UTC of the day before to |
instrument_code | Defaults to all instruments |
order | Defaults to DESC |
max_page_size | Defaults to 100 |
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 on the last page.400 UNEXPECTED_PARAMETERS.Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.onetrading.com/fast/v1/account/trades?from=2026-01-01&to=2026-01-30&instrument_code=undefined&max_page_size=2&cursor=undefined&order=undefined' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success Example
{
"trade_history": [
{
"fee": {
"fee_amount": "0.0020505",
"fee_currency": "USD"
},
"trade": {
"account_id": "aaaba8bd-3195-4f72-87ff-98720a940f23",
"order_id": "71912cd5-1df2-4c14-3e59-377765d23b01",
"trade_id": "aa765409-4719-5358-b27a-3fabedf27164",
"time": "2025-12-02T11:32:32.515Z",
"time_nanos": "2025-12-02T11:32:32.515915000Z",
"instrument_code": "DOGE_USD_P",
"side": "BUY",
"matched_as": "TAKER",
"order_type": "API",
"price": "0.1367",
"amount": "100",
"filled_amount": "100",
"sequence": "92096745784",
"open_position_amount": "0",
"position_id": "1764675149939364"
}
},
{
"fee": {
"fee_amount": "0.002052",
"fee_currency": "USD"
},
"trade": {
"account_id": "aaaba8bd-3195-4f72-87ff-98720a940f23",
"order_id": "02f52442-066e-4ebb-3f85-fbe8010d2861",
"trade_id": "ed076827-96b9-52af-80fa-b516fd2c02c1",
"time": "2025-12-02T11:32:29.939Z",
"time_nanos": "2025-12-02T11:32:29.939364000Z",
"instrument_code": "DOGE_USD_P",
"side": "BUY",
"matched_as": "TAKER",
"order_type": "API",
"price": "0.1368",
"amount": "100",
"filled_amount": "100",
"sequence": "92096745379",
"open_position_amount": "100",
"position_id": "1764675149939364"
}
}
],
"from": "2025-12-01T00:00:00.000000000Z",
"to": "2025-12-02T12:00:00.000000000Z",
"max_page_size": 2,
"cursor": "eyJlcG9jaCI6IjE3NjQ2NzUxNDk5MzkzNjQwMDEiLCJjcW8iOiIyMTA1MzM3MTM0NDYxMjU3In0="
}