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	Definition
id	Order ID in the order book
direction	Direction of the trade
symbol	Symbol
price	Order price
quantity	Quantity of base asset
value	Quantity of quote asset
filledQuantity	Filled quantity of base asset
filledValue	Filled quantity of quote asset
createdAt	Time when the order was created
clientOrderId	Client's order ID
stopLossPrice	The threshold market price of the asset, upon reaching which the order will be automatically canceled

: Definition
Order ID in the order book
: Definition
Direction of the trade
: Definition
Symbol
: Definition
Order price
: Definition
Quantity of base asset
: Definition
Quantity of quote asset
: Definition
Filled quantity of base asset
: Definition
Filled quantity of quote asset
: Definition
Time when the order was created
: Definition
Client's order ID
: 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