活跃订单列表

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

要求

查询参数

姓名参数类型定义
marketstring按交易对过滤（例如“TRX_USDT”）
directionstring按方向过滤可用选项：• buy• sell
order_idstring按订单簿中的订单 ID 过滤
client_order_idstring按客户订单 ID 过滤
limitstringdefault: 50min:1max:100一个特殊参数，用于设置请求将返回的最大记录数
offsetstringdefault: 0min:0max:10000一个特殊参数，指示要跳过的记录数

参数类型

string

定义

按交易对过滤（例如“TRX_USDT”）

参数类型

string

定义

按方向过滤可用选项：- buy- sell

参数类型

string

定义

按订单簿中的订单 ID 过滤

参数类型

string

定义

按客户订单 ID 过滤

参数类型

stringdefault: 50min:1max:100

定义

一个特殊参数，用于设置请求将返回的最大记录数

参数类型

stringdefault: 0min:0max:10000

定义

一个特殊参数，指示要跳过的记录数

回复

响应参数

姓名定义
id订单簿中的订单ID
direction贸易方向
symbol象征
price订单价格
quantity基础资产数量
value报价资产数量
filledQuantity基础资产填充数量
filledValue报价资产已填写数量
createdAt订单创建时间
clientOrderId客户的订单 ID
stopLossPrice资产的市场价格阈值，达到该阈值订单将自动取消

定义

订单簿中的订单ID

定义

贸易方向

定义

象征

定义

订单价格

定义

基础资产数量

定义

报价资产数量

定义

基础资产填充数量

定义

报价资产已填写数量

定义

订单创建时间

定义

客户的订单 ID

定义

资产的市场价格阈值，达到该阈值订单将自动取消

响应示例


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
复制

可能的代码

404：未找到用户或资源

422: 输入数据无效

500：服务器内部错误

可能的错误

示例响应：


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

响应示例与错误


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}
复制