List of active orders

get https://api.cryptomus.com/v2/user-api/exchange/orders Copy

Request

Query parameters

Name	Parameter type	Definition
market	string	Filter by trading pair (e.g., `TRX_USDT`)
direction	string	Filter by directionAvailable options:• buy• sell
order_id	string	Filter by order ID in the order book
client_order_id	string	Filter by client order ID
limit	stringdefault: 50min:1max:100	A special parameter that sets the maximum number of records the request will return
offset	stringdefault: 0min:0max:10000	A special parameter that indicates the number of records to skip

: Parameter type
string
Definition
Filter by trading pair (e.g., `TRX_USDT`)
: Parameter type
string
Definition
Filter by directionAvailable options:- buy- sell
: Parameter type
string
Definition
Filter by order ID in the order book
: Parameter type
string
Definition
Filter by client order ID
: Parameter type
stringdefault: 50min:1max:100
Definition
A special parameter that sets the maximum number of records the request will return
: Parameter type
stringdefault: 0min:0max:10000
Definition
A special parameter that indicates the number of records to skip

Response

Response parameters

Name	Parameter type	Definition
id	string	Order ID in the order book
direction	string	Direction of the trade
symbol	string	Symbol
price	string	Order price
quantity	string	Quantity of base asset
value	string	Quantity of quote asset
filledQuantity	string	Filled quantity of base asset
filledValue	string	Filled quantity of quote asset
createdAt	string	Time when the order was created
clientOrderId	string	Client's order ID
stopLossPrice	string\|null	The threshold market price of the asset, upon reaching which the order will be automatically canceled

: Parameter type
string
Definition
Order ID in the order book
: Parameter type
string
Definition
Direction of the trade
: Parameter type
string
Definition
Symbol
: Parameter type
string
Definition
Order price
: Parameter type
string
Definition
Quantity of base asset
: Parameter type
string
Definition
Quantity of quote asset
: Parameter type
string
Definition
Filled quantity of base asset
: Parameter type
string
Definition
Filled quantity of quote asset
: Parameter type
string
Definition
Time when the order was created
: Parameter type
string
Definition
Client's order ID
: Parameter type
string|null
Definition
The threshold market price of the asset, upon reaching which the order will be automatically canceled

Response example


1{
2  "result": [
3    {
4      "id": "01JFFG72CBRDP68K179KC9DSTG",
5      "direction": "sell",
6      "symbol": "BTC_USDT",
7      "price": "102.0130000000000000",
8      "quantity": "0.0005000000000000",
9      "value": "0.0510065000000000",
10      "filledQuantity": "0.0000000000000000",
11      "filledValue": "0.0000000000000000",
12      "createdAt": "2024-12-19 09:02:51",
13      "clientOrderId": "987654321",
14      "stopLossPrice": "101.12"
15    },
16    {
17      "id": "01JFFG0AHABBWRF8K6DCJT6816",
18      "direction": "sell",
19      "symbol": "TRX_USDT",
20      "price": "0.1230000000000000",
21      "quantity": "100.0000000000000000",
22      "value": "12.3000000000000000",
23      "filledQuantity": "0.0000000000000000",
24      "filledValue": "0.0000000000000000",
25      "createdAt": "2024-12-19 12:59:10",
26      "clientOrderId": "123456789"
27    }
28  ]
29}
30

Copy

Possible codes

404: User or resource not found

422: Invalid input data

500: Internal server error

Possible errors

example responses:


1{
2  "state": 0,
3  "message": "Standard validation error"
4}

Copy

Response example with error


1{
2  "code": 0,
3  "message": "Validation failed.",
4  "errors": [
5    {
6      "property": "direction",
7      "value": "sells",
8      "message": "The value you selected is not a valid choice."
9    }
10  ]
11}

Copy