提交订单

流量控制: 5 每 秒

摘要


HTTP 方法

POST

访问路径

/api/v2/order

功能

您需要以下步骤来下单:

  1. 通过/api/v2/orderId获取正确的orderId。如果您在客户端维护订单ID,可以跳过该步骤。
  2. 选择合理的validSincevalidUntil值。我们推荐的参数是validSince设置为当前系统时间,validUntil设置成比当前时间晚至少一个月。
  3. 选择合理的MaxFeeBips。我们建议这个值设置为63
  4. 如果您想更好地追踪订单,请选择使用clientOrderId和(或)channelId
  5. 对订单进行签名。
  6. 提交订单, 确认返回的结果包含订单哈希。

API 描述


HTTP头

字段 类型 必须 说明 举例
X-API-KEY string ApiKey "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ
6B6DQ6THZWbvrAGxzEdulXQvOKLrRW
ZLnN"

请求参数

字段 类型 必须 说明 举例
exchangeId integer 交易所ID 1
orderId integer 订单ID 1
accountId integer 账户ID 1
tokenSId integer 需要卖出的Token ID 0
tokenBId integer 需要买入的Token ID 2
amountS string 需要卖出的Token数量 "1000000000000000000"
amountB string 需要买入的Token数量 "1000000000000000000"
allOrNone string 订单是否只能完全成交或者0成交, 目前只支持false "false"
buy string 买到为止或者卖出为止 "true"
validSince integer 订单生效时间, 精确到秒 1567053142
validUntil integer 订单失效时间, 精确到秒 1567053142
maxFeeBips integer 用户可以接受的最大订单费用, 取值范围(万分之)1~63 20
label integer 订单标签,用来标示订单属性或者来源等, 参与订单签名, 取值范围0~65535 20
signatureRx string 订单签名结果Rx部分 "13375450901292179417
15497484957179306991
15173547203971250276
33242680470075859"
signatureRy string 订单签名结果Ry部分 "13375450901292179417
15497484957179306991
15173547203971250276
33242680470075859"
signatureS string 订单签名结果S部分 "13375450901292179417
15497484957179306991
15173547203971250276
33242680470075859"
clientOrderId string 客户端标识的订单唯一ID "1"
channelId string 订单渠道号, 用来标示订单从哪个渠道提交 "hebao::subchannel::0
001"

请求示例

HTTP
CURL
POST https://api.loopring.io/api/v2/order HTTP/1.1
Host: api.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
Content-Type: application/json

{
    "exchangeId" : 1,
    "orderId" : 1,
    "accountId" : 1,
    "tokenSId" : 0,
    "tokenBId" : 2,
    "amountS" : "1000000000000000000",
    "amountB" : "1000000000000000000",
    "allOrNone" : "false",
    "buy" : "true",
    "validSince" : 1567053142,
    "validUntil" : 1567053142,
    "maxFeeBips" : 20,
    "label" : 20,
    "signatureRx" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "signatureRy" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "signatureS" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "clientOrderId" : "1",
    "channelId" : "hebao::subchannel::0001"
}
curl -X POST -H "X-API-KEY:sra1aavfa" -H "Content-Type:application/json" https://api.loopring.io/api/v2/order -d \
'{
    "exchangeId" : 1,
    "orderId" : 1,
    "accountId" : 1,
    "tokenSId" : 0,
    "tokenBId" : 2,
    "amountS" : "1000000000000000000",
    "amountB" : "1000000000000000000",
    "allOrNone" : "false",
    "buy" : "true",
    "validSince" : 1567053142,
    "validUntil" : 1567053142,
    "maxFeeBips" : 20,
    "label" : 20,
    "signatureRx" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "signatureRy" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "signatureS" : "13375450901292179417154974849571793069911517354720397125027633242680470075859",
    "clientOrderId" : "1",
    "channelId" : "hebao::subchannel::0001"
}'

响应字段

字段 类型 必须 说明 举例
resultInfo ResultInfo API返回信息 /
data string 订单Hash "13375450901292179417
15497484957179306991
15173547203971250276
33242680470075859"

响应示例

{
    "resultInfo" : {
        "code" : 0,
        "message" : "SUCCESS"
    },
    "data" : "13375450901292179417154974849571793069911517354720397125027633242680470075859"
}

状态码

状态码 描述
100000 未知错误
102001 交易所ID不正确
102002 订单中存在不支持的TokenId
102003 无效的账户ID
102004 无效的订单ID
102005 市场对不支持
102006 不合法的费率字段
102007 订单已经存在
102008 订单已经过期
102010 订单缺少签名信息
102011 用户余额不足
102012 下单金额太小
102014 冻结金额失败,请稍后重试
102020 超过下单最大金额
102120 订单未生效
104001 APIKEY不能为空
104002 APIKEY验证失败
104003 用户不存在
104004 未提供签名信息
104005 错误的签名信息

results matching ""

    No results matching ""