查询报价

GET🔒 Read

⚡ Query: 15 req/s per endpoint · 30 req/s per user

提示

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

查询 OTC 订单的报价。需要 Read 权限。

请求参数

名称	类型	是否必填	描述
quoteId	String	是	报价 ID

响应内容

名称	类型	描述
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

GEThttps://api.btse.com/public-api/otc/v1/quotes

Response (新报价)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325777227,
  "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,
    "ttl": 6,
    "status": "NEW_QUOTE"
  }
}

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 (报价已过期)

{
  "success": true,
  "code": 1,
  "msg": "Success",
  "time": 1673325784033,
  "data": {
    "quoteId": "0002-0002-0002-0002",
    "clOrderId": "test-0002",
    "side": "BUY",
    "baseSize": "19.787758928",
    "baseCurrency": "BTC",
    "quoteSize": "340000.0",
    "quoteCurrency": "USDT",
    "ratio": "17182.33991211",
    "expireTime": 1673325783227,
    "ttl": 0,
    "status": "EXPIRED"
  }
}

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"
  }
}