Get Orders - One Trading API

Return a paginated report on currently open orders, sorted by creation timestamp (newest first). Query parameters and filters can be used to specify if historical orders should be reported as well. If no query filters are defined, all orders which are currently active will be returned. If you want to query specific time frame parameters, from and to are mandatory, otherwise it will start from the latest orders.

curl --location --request GET 'https://api.onetrading.com/fast/v1/account/orders?from=2024-11-13T16:00:00.000Z&to=2024-11-14T10:00:00.000Z&instrument_code=BTC_EUR&with_cancelled_and_rejected=false&with_just_filled_inactive=false&with_just_orders=true&max_page_size=5&cursor=1731488541876570'

{ "order_history": [ { "order": { "account_id": "726288e6-a463-4f88-9068-024ae8f97a34", "order_id": "74eaf796-869b-4d49-ab39-2bc4fe10daeb", "client_id": "b8854ae6-4077-404b-ae0c-52a1fe318440", "amount": "1", "side": "SELL", "instrument_code": "SOL_EUR", "price": "140", "time": "2024-11-13T17:34:55.514Z", "sequence": "58894260661", "total_fee": "0.29", "fee_currency": "EUR", "time_last_updated": "2024-11-13T17:34:55.514Z", "order_book_sequence": "58894260661", "filled_amount": "1", "status": "FILLED_FULLY", "average_price": "145.00" }, "trades": [ { "fee": { "fee_amount": "0.29", "fee_currency": "EUR" }, "trade": { "trade_id": "f99a7e64-5478-44f3-b404-19aac53f2062", "order_id": "74eaf796-869b-4d49-ab39-2bc4fe10daeb", "account_id": "726288e6-a463-4f88-9068-024ae8f97a34", "amount": "1", "side": "SELL", "instrument_code": "SOL_EUR", "price": "145", "time": "2024-11-13T17:34:55.514Z", "sequence": "58894260661", "matched_as": "MAKER" } } ] }, { "order": { "account_id": "726288e6-a463-4f88-9068-024ae8f97a34", "order_id": "d8e8e090-a142-4574-a875-36ef769eafe3", "client_id": "89e6b540-2497-4d08-b777-9cf363940cab", "amount": "3.3333", "side": "BUY", "instrument_code": "SOL_EUR", "price": "150", "time": "2024-11-13T15:40:04.430Z", "sequence": "58894259835", "total_fee": "0.0067", "fee_currency": "SOL", "time_last_updated": "2024-11-13T15:40:04.430Z", "order_book_sequence": "58894259835", "filled_amount": "0", "status": "BOOKED" }, "trades": [] } ], "max_page_size": 2 }

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Query Params

from

string <date-time>

optional

Defines start of a query search

Example:

2024-11-13T16:00:00.000Z

string <date-time>

optional

Defines end of a query search

Example:

2024-11-14T10:00:00.000Z

instrument_code

string

optional

Instrument pair to get orders for

Example:

BTC_EUR

with_cancelled_and_rejected

boolean

optional

Return orders which have been cancelled by the user before being filled or rejected by the system as invalid. Additionally, all inactive filled orders which would return with "with_just_filled_inactive".

Example:

false

with_just_filled_inactive

boolean

optional

Return order history for orders which have been filled and are no longer open. Use of "with_cancelled_and_rejected" extends "with_just_filled_inactive" and in case both are specified the latter is ignored.

Example:

false

with_just_orders

boolean

optional

Returns order history for orders but does not return any trades corresponding to the orders. It may be significantly faster and should be used if user is not interesting in trade information. Can be combined with any other filter.

Example:

true

max_page_size

string

optional

Set max desired page size. If no value is provided, by default a maximum of 100 results per page are returned. The maximum upper limit is 100 results per page.

Example:

cursor

string

optional

Pointer specifying the position from which the next pages should be returned.

Example:

1731488541876570

Responses

🟢200Success

application/json

Body

order_history

array [object {2}]

required

The order history based on the specified request criteria

order

object (Order)

required

trades

array [object {2}]

required

max_page_size

integer

required

The amount of items requested

cursor

string

optional

If there are more records to fetch, the cursor returned should be passed into the next request, to be used as a starting point for the next batch of orders