Post 요청

이 페이지에서는 WebSocket API를 사용하여 요청을 게시하는 방법을 설명합니다.

요청 형식

WebSocket API는 일반적으로 HTTP API를 통해 게시할 수 있는 요청의 게시를 지원합니다. 이러한 요청은 info 요청 또는 서명된 액션입니다. info 요청 페이로드의 예시는 Info 엔드포인트 섹션을 참조하세요. 서명된 액션 페이로드의 예시는 Exchange 엔드포인트 섹션을 참조하세요.

WebSocket API를 통해 두 유형 중 하나의 페이로드를 보내려면 다음과 같이 래핑해야 합니다:

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

참고: method와 id 필드는 필수입니다. 채널을 통해 진행 중인 요청을 추적할 수 있도록 전송하는 모든 post 요청에 고유한 id를 사용하는 것이 좋습니다.

참고: explorer 요청은 WebSocket에서 지원되지 않습니다.

응답 형식

서버는 post 요청에 성공 또는 오류로 응답합니다. 오류의 경우, 요청이 HTTP를 통해 전송되었더라면 반환되었을 HTTP 상태 코드와 설명을 반영하는 String이 반환됩니다.

{
  "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,
                }
              }
            ]
          }
        }
      }
    }
  }
}