活跃订单列表

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

定义

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

回复

响应参数

姓名参数类型定义
idstring订单簿中的订单ID
directionstring贸易方向
symbolstring象征
pricestring订单价格
quantitystring基础资产数量
valuestring报价资产数量
filledQuantitystring基础资产填充数量
filledValuestring报价资产已填写数量
createdAtstring订单创建时间
clientOrderIdstring客户的订单 ID
stopLossPricestring|null资产的市场价格阈值,达到该阈值订单将自动取消

参数类型

string

定义

订单簿中的订单ID

参数类型

string

定义

贸易方向

参数类型

string

定义

象征

参数类型

string

定义

订单价格

参数类型

string

定义

基础资产数量

参数类型

string

定义

报价资产数量

参数类型

string

定义

基础资产填充数量

参数类型

string

定义

报价资产已填写数量

参数类型

string

定义

订单创建时间

参数类型

string

定义

客户的订单 ID

参数类型

string|null

定义

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

响应示例


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