Get Trades
GET
https://api.onetrading.com/fast/v1/account/trades
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) 1695734400456789123 (ns) | |
| 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 | Cannot be a future date |
to | Must be on or after from and no more than 30 days after from |
max_page_size | Integer between 0 and 100 |
instrument_code | Optional; must be a valid market instrument code or codes |
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 markets |
max_page_size | Defaults to 100 |
Request
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.onetrading.com/fast/v1/account/trades?from&to&instrument_code&max_page_size=2&cursor' \
--header 'Authorization: Bearer <token>'Response Response Example
200 - Success
{
"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": "ed076827-96b9-52af-80fa-b516fd2c02c1"
}
},
{
"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": "ed076827-96b9-52af-80fa-b516fd2c02c1"
}
}
],
"max_page_size": 2,
"cursor": "eyJlcG9jaCI6MTc2NDY3NTEyODEwMzY2NiwiaW5kZXgiOjIxMDUzMzcxMzQ0NjEyNTZ9"
}