限价订单创建

限价单将在达到指定价格时执行

post

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

复制

要求

查询参数

姓名	参数类型	定义
market*	string	可用交易对的指定（例如“TRX_USDT”）
quantity*	string	数量 (base_currency)
price*	string	订单执行的限价（以 quote_currency 为单位）
direction*	string	订单类型可用选项：• buy• sell
stop_loss_price	string	资产的市场价格阈值，达到该阈值订单将自动取消
client_order_id	string	客户端创建的唯一标识符
tag	string	经纪商标签

参数类型

string

定义

可用交易对的指定（例如“TRX_USDT”）

参数类型

string

定义

数量 (base_currency)

参数类型

string

定义

订单执行的限价（以 quote_currency 为单位）

参数类型

string

定义

订单类型可用选项：- buy- sell

参数类型

string

定义

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

参数类型

string

定义

客户端创建的唯一标识符

参数类型

string

定义

经纪商标签

* - 强制性参数

请求示例


{
  "market": "TRX_USDT",
  "quantity": "20",
  "price": "0.2964",
  "direction": "buy",
  "stop_loss_price": "0.31"
}

复制

可能的代码

200：订单创建成功

404：未找到用户或资源

422: 输入数据无效

500：服务器内部错误

响应示例


1{
2  "order_id": "01JEXAFCCC5ZVJPZAAHHDKQBNG"
3}

复制

可能的错误

示例响应：


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

复制


1{
2  "state": 2,
3  "message": "Incorrect amount or price accuracy"
4}

复制


1{
2  "state": 3,
3  "message": "Order amount is out of acceptable ranges"
4}

复制


1{
2  "state": 4,
3  "message": "Stop Loss order price error"
4}

复制


1{
2  "state": 6,
3  "message": "Insufficient balance"
4}

复制


1{
2  "state": 7,
3  "message": "client_order_id error"
4}

复制


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

复制

响应示例与错误


1{
2  "code": 4,
3  "message": "Stop-loss price must be higher than order price"
4}

复制