WebSocket API v1 거래 - addOrder 및 cancelOrder

최종 업데이트: 2025년 4월 1일
  • •

    주문하기 - addOrder

  • •

    주문 취소하기 - cancelOrder

WebSocket API v1을 통한 거래(주문 및 주문 취소)는 addOrder 및 cancelOrder 엔드포인트에서 제공됩니다. REST API를 통한 거래와 유사하게, addOrder 엔드포인트는 신규 주문을 제출하는 데 사용되며, cancelOrder 엔드포인트는 기존(미체결) 주문을 취소하는 데 사용됩니다.

WebSocket API 연결이 설정되면 다음 단계를 통해 주문을 제출하고 취소할 수 있습니다.

  1. 1

    인증 토큰을 검색합니다. REST API GetWebSocketsToken 엔드포인트를 통해 (유효한 토큰이 검색되면 동일한 토큰을 여러 addOrder/cancelOrder 요청에 사용할 수 있습니다.)

  2. 2

    적절한 addOrder/cancelOrder 요청을 보냅니다.

  3. 3

    요청 성공 여부를 나타내는 응답을 받습니다.

주문하기 - addOrder

당사의 WebSocket API 문서는 addOrder 엔드포인트에 대한 전체 사양을 제공하며, 사용해야 하는 JSON 형식과 각 필수 및 선택 필드에 대한 설명을 포함합니다.

예를 들어, 다음 JSON 메시지는 0.25 ETH/EUR를 €150의 지정가로 매수하는 신규 주문을 제출합니다.

{
"event": "addOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"pair": "ETH/EUR",
"type": "buy",
"ordertype": "limit",
"price": "150",
"volume": "0.25"
}

위 주문이 성공적으로 제출되었다고 가정하면(계정 잔액에 충분한 자금 보유 등), 다음 JSON 메시지가 응답으로 수신됩니다.

{
"event": "addOrderStatus",
"status": "ok",
"descr": "buy 0.25000000 ETHEUR @ limit 150",
"txid": "OUEMWD-CUO73-YYCBEK"
}

주문 취소하기 - cancelOrder

당사의 WebSocket API 문서는 cancelOrder 엔드포인트에 대한 전체 사양을 제공하며, 사용해야 하는 JSON 형식과 각 필수 및 선택 필드에 대한 설명을 포함합니다.

REST API와 달리, WebSocket API cancelOrder 엔드포인트는 txid 배열에 각 주문 ID(또는 사용자 참조)를 지정하여 여러 주문을 동시에 취소하는 데 사용할 수 있습니다.

예를 들어, 다음 JSON 메시지는 일치하는 주문 ID를 가진 미체결 주문을 취소합니다.

{
"event": "cancelOrder",
"token": "WOg6IVQ5RfogMzkhH25WOg6IVQ5RqhP+U3ZprQVnh7f",
"txid": ["OUEMWD-CUO73-YYCBEK", "OBW5ID-MAGEW-HENTE7"]
}

주문이 성공적으로 취소되었다고 가정하면, 다음 JSON 메시지가 응답으로 수신됩니다.

{
"event": "cancelOrderStatus",
"status": "ok"
}

더 많은 도움이 필요하신가요?