跳到主要内容

下单

API说明​

此接口允许用户通过指定订单类型、数量、价格和外部交易号来下现货交易订单。

注意：下单只能通过 RESTful API 可用。

注意事项​

  1. 对于市价单，用户可以指定“funds”或“amount”。
  2. 对于限价单，用户必须指定“金额”。

认证​

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

请求方法​

POST

接口地址​

/api/v1/private?command=doTrade

频率限制​

该接口的调用频率限制为：每个用户 ID 每2秒最多请求30次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数​

参数必填类型描述
symbolTrueString交易品种，例如：BTC_USDT
typeTrueString交易方向：
0：买单，
1：卖单。
amountFalseString以基础货币计的订单大小。
注意：限价单必填。
rateFalseString用户指定的订单价格
fundsFalseString以报价货币计的订单大小。
注意：仅对市价单有效。
isMarketTrueString订单类型：
true：市价单，
false：限价单。
out_trade_noTrueString用户分配的自定义订单ID。用户需使其唯一以区分不同订单。注意：最大长度：50个字符；仅允许拉丁字符、数字、连字符（-）和下划线（_）。

响应参数​

参数类型描述
orderNumberString订单ID

请求示例​

以下Python代码展示了如何为BTC-USDT下限价单。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

api_url = "/api/v1/private?command=doTrade"
method = "post"
params = {
          "symbol": "BTC_USDT",
          "type": "0",
          "amount": "0.0001",
          "rate": "82000" ,
          # "funds" : 100,
          "isMarket" : "false",
          "out_trade_no" : "3-04-11-06"
         }
SpotRestuflPrivate(host, api_url, method, api_key, params, secret_key)  # 函数SpotRestuflPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

响应示例​

以下是上述Python请求返回的示例响应：

{'code': '200',
 'data': {'orderNumber': 4624603081039753080},
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}