接受报价

POST🔒 Trading

⚡ Orders: 75 req/s per endpoint · 75 req/s per user

提示

立即试用 — 在 API 浏览器中测试此端点

接受 OTC 订单的报价。需要 Trading 权限。

若你之前以 baseSize 请求报价，可使用 baseSize 进行部分接受；同理，以 quoteSize 请求的报价可使用 quoteSize 进行部分接受。

在以下情况下，将以原始 baseSize 与 quoteSize 全额接受报价（不会返回提示）：

1. 同时省略 baseSize 与 quoteSize。
2. 传入的 baseSize 大于已请求的报价数量。
3. 传入的 quoteSize 大于已请求的报价数量。
4. 报价以 quoteSize 请求，但接受时传入 baseSize。
5. 报价以 baseSize 请求，但接受时传入 quoteSize。

请求参数

名称	类型	是否必填	描述
quoteId	String	是	来自请求报价接口返回的报价 ID
baseSize	String	否	希望部分接受的 baseCurrency 数量。同时省略 baseSize 与 quoteSize 表示按全额接受。
quoteSize	String	否	希望部分接受的 quoteCurrency 数量。同时省略 baseSize 与 quoteSize 表示按全额接受。

响应内容

名称	类型	描述
quoteId	String	报价 ID
clOrderId	String	由客户端指定的客户订单 ID
side	String	交易方向 — BUY · SELL
baseSize	String	baseCurrency 的大小。side=BUY 时最多 8 位小数；side=SELL 时最多 9 位小数。
baseCurrency	String	基础货币
quoteSize	String	quoteCurrency 的大小。side=BUY 时最多 9 位小数；side=SELL 时最多 8 位小数。
quoteCurrency	String	报价货币
ratio	String	每个 baseCurrency 折合多少 quoteCurrency（quoteSize / baseSize）。最多 10 位小数。
status	String	报价状态 — NEW_QUOTE · REQUOTE · COMPLETED · EXPIRED
expireTime	Double	过期时间戳（Unix 毫秒）
ttl	Double	剩余有效时间（秒）

example

POSThttps://api.btse.com/public-api/otc/v1/quotes/accept

Request (通用)

{
  "quoteId": "0001-0001-0001-0001"
}

Request (指定 baseSize 接受)

{
  "quoteId": "0003-0003-0003-0003",
  "baseSize": "10.0"
}

Request (指定 quoteSize 接受)

{
  "quoteId": "0004-0004-0004-0004",
  "quoteSize": "200.0"
}

Response (通用)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325778012,
  "data": {
    "quoteId": "0001-0001-0001-0001",
    "clOrderId": "test-0001",
    "side": "BUY",
    "baseSize": "15.0",
    "baseCurrency": "BTC",
    "quoteSize": "257735.09868",
    "quoteCurrency": "USDT",
    "ratio": "17182.33991211",
    "expireTime": 1673325783227,
    "status": "COMPLETED"
  }
}

Response (指定 baseSize 接受)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "data": {
    "quoteId": "0003-0003-0003-0003",
    "clOrderId": "test-0003",
    "side": "SELL",
    "baseSize": "10.0",
    "baseCurrency": "BTC",
    "quoteSize": "130.25046761",
    "quoteCurrency": "ETH",
    "ratio": "13.025046761",
    "expireTime": 1673325783227,
    "status": "COMPLETED"
  }
}

Response (指定 quoteSize 接受)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "data": {
    "quoteId": "0004-0004-0004-0004",
    "clOrderId": "test-0004",
    "side": "SELL",
    "baseSize": "15.3550312463",
    "baseCurrency": "BTC",
    "quoteSize": "200.0",
    "quoteCurrency": "ETH",
    "ratio": "13.025046761",
    "expireTime": 1673325783227,
    "status": "COMPLETED"
  }
}

Response (接受时已过期或比率变化)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673506479119,
  "data": {
    "quoteId": "2000-2000-2000-2000",
    "clOrderId": "test-0002",
    "side": "BUY",
    "baseSize": "18.624803705",
    "baseCurrency": "BTC",
    "quoteSize": "340000.0",
    "quoteCurrency": "USDT",
    "ratio": "18255.225955",
    "expireTime": 1673506485119,
    "ttl": 6,
    "status": "REQUOTE"
  }
}