跳到主要内容

下委托单

信息
  • 该接口需要签名，具体签名规则请参阅认证
  • 该接口会触发限频，具体规则请参阅限频

HTTP 请求​

POST /spot/order

请求参数​

参数名是否必须类型说明
markettruestring市场名称
market_typetruestring市场类型。
注意：在现货相关功能中，只可使用 SPOT 或 MARGIN
在合约相关功能中，只可使用FUTURES
sidetruestring订单方向
typetruestring订单类型
ccyfalsestring币种名称，在订单类型为market时，可以通过指定币种名称选择币种进行委托下单。
币种名称只能从市场的交易币种或者报价币种中选择。
例如在BTCUSDT市场中，既可以选择BTC，也可以选择USDT。
amounttruestring委托数量
pricefalsestring委托价格
client_idfalsestring客户自定义 ID
client_id是订单的自定义ID。服务器将在订单响应中返回用户自定义的client_id，并且还可以使用client_id作为标识来进行批量撤单，详见通过client_id撤单 相关接口
目前它仅支持大写和小写字母，数字，连字符和下划线，并且应小于32个字节。
is_hidefalsebool是否隐藏委托。默认为: false
隐藏订单会在公开的深度信息中隐藏本笔订单，但在用户自己的的深度订阅响应中会展示
stp_modefalsestring自成交保护模式。
ct: 立即取消剩余的Taker单
cm: 立即取消剩余的Maker单（剩下的taker单不受影响，若设置为限价吃单，剩余没有成交的taker单以限价继续挂单）
both: 立即取消剩余的Taker和Maker单
注意：在集合竞价期间挂单stp_mode不生效

请求响应​

参数名类型说明
order_idint订单 ID
marketstring市场名称
market_typestring市场类型
sidestring订单方向
typestring订单类型
ccystring币种名称
amountstring委托数量
pricestring委托价格
unfilled_amountstring未成交数量
filled_amountstring已成交数量
filled_valuestring已成交价值
client_idstring客户端 ID
base_feestring收取的交易币种手续费
quote_feestring收取的报价币种手续费
discount_feestring收取的抵扣币种手续费
maker_fee_ratestringmaker 手续费费率
taker_fee_ratestringtaker 手续费费率
last_filled_amountstring最后一笔成交的数量
last_filled_pricestring最后一笔成交的价格
created_atint订单创建时间
updated_atint订单更新时间

请求示例​

// 下限价委托单
{
    "market": "CETUSDT",
    "market_type": "MARGIN",
    "side": "buy",
    "type": "limit",
    "amount": "10000",
    "price": "1",
    "client_id": "user1",
    "is_hide": true
}

// 下市价委托单
{
    "market": "CETUSDT",
    "market_type": "MARGIN",
    "side": "buy",
    "type": "market",
    "amount": "100",
    "ccy": "CET",
    "client_id": "user1",
    "is_hide": true
}

响应示例​

{
    "code": 0,
    "data": {
        "order_id": "13400",
        "market": " CETUSDT",
        "market_type": "MARGIN",
        "ccy": "CET",
        "side": "buy",
        "type": "limit",
        "amount": "10000",
        "price": "1",
        "ccy": "CET",
        "unfilled_amount": "50241.7185224371",
        "filled_amount": "27564.87468358",
        "filled_value": "27564.87468358",
        "client_id": "client_id_1",
        "base_fee": "11.6582326221",
        "quote_fee": "0",
        "discount_fee": "0",
        "maker_fee_rate": "0",
        "taker_fee_rate": "0.0003",
        "last_fill_amount": "27564.87468358",
        "last_fill_price": "1",
        "created_at": 1691482451000,
        "updated_at": 1691482451000
    },
    "message": "OK"
}