POST 請求

本頁描述如何使用 WebSocket API 發送 post 請求。

請求格式

WebSocket API 支持發送通常通過 HTTP API 發送的 post 請求。這些請求要麼是 info 請求，要麼是籤名操作（signed action）。info 請求負載的示例請參閱 Info 端點部分；籤名操作負載的示例請參閱 Exchange 端點部分。

要通過 WebSocket API 發送任一類型的負載，必須按如下方式包裝：

{
  "method": "post",
  "id": <number>,
  "request": {
    "type": "info" | "action",
    "payload": { ... }
  }
}

注意：method 和 id 欄位爲必填。建議你爲發送的每條 post 請求使用唯一的 id，以便通過該通道跟蹤未完成的請求。

注意：WebSocket 不支持 explorer 請求。

回應格式

伺服器會以成功或錯誤回應 post 請求。對於錯誤，會返回一個 String，其中鏡像了如果該請求通過 HTTP 發送時將返回的 HTTP 狀態碼和描述。

{
  "channel": "post",
  "data": {
    "id": <number>,
    "response": {
      "type": "info" | "action" | "error",
      "payload": { ... }
    }
  }
}

示例

以下是用訂閱消息訂閱不同數據源的幾個示例：

發送 L2Book info 請求：

{
  "method": "post",
  "id": 123,
  "request": {
    "type": "info",
    "payload": {
      "type": "l2Book",
      "coin": "ETH",
      "nSigFigs": 5,
      "mantissa": null
    }
  }
}

示例回應：

{
  "channel": "post",
  "data": {
    "id": <number>,
    "response": {
      "type": "info",
      "payload": {
        "type": "l2Book",
        "data": {
          "coin": "ETH",
          "time": <number>,
          "levels": [
            [{"px":"3007.1","sz":"2.7954","n":1}],
            [{"px":"3040.1","sz":"3.9499","n":1}]
          ]
        }
      }
    }
  }
}

發送下單籤名操作請求：

{
  "method": "post",
  "id": 256,
  "request": {
    "type": "action",
    "payload": {
      "action": {
        "type": "order",
        "orders": [{"a": 4, "b": true, "p": "1100", "s": "0.2", "r": false, "t": {"limit": {"tif": "Gtc"}}}],
        "grouping": "na"
      },
      "nonce": 1713825891591,
      "signature": {
        "r": "...",
        "s": "...",
        "v": "..."
      },
      "vaultAddress": "0x12...3"
    }
  }
}

示例回應：

{
  "channel": "post",
  "data": {
    "id": 256,
    "response": {
      "type":"action",
      "payload": {
        "status": "ok",
        "response": {
          "type": "order",
          "data": {
            "statuses": [
              {
                "resting": {
                  "oid": 88383,
                }
              }
            ]
          }
        }
      }
    }
  }
}