본문으로 건너뛰기

새로운 주문 생성

POST 
/api/v1/order

주문 제출​

이 엔드포인트는 주문 제출에 사용됩니다. 각 필드의 사용에 대한 자세한 내용은 아래를 참고하십시오.

주문 유형​

모든 주문에는 symbol이 필요합니다. 별도로 명시되지 않는 한 다른 모든 필드는 선택 사항입니다.

다음은 유효한 ordType입니다:

  • Limit: 기본 주문 유형입니다. orderQty와 price를 지정하십시오.
  • Market: 전통적인 시장가 주문입니다. 시장가 주문은 체결되거나 파산 가격에 도달할 때까지 실행되며, 해당 시점에 취소됩니다.
  • Stop: 스탑 시장가 주문입니다. orderQty와 stopPx를 지정하십시오. stopPx에 도달하면 주문이 호가창에 등록됩니다.
    • 매도 주문의 경우 트리거 가격이 stopPx보다 낮으면 발동됩니다. 매수의 경우 더 높을 때 발동됩니다.
    • 참고: 스탑 주문은 발동되기 전까지 증거금을 사용하지 않습니다. 완전히 발동될 수 있도록 계정에 필요한 증거금이 있는지 확인하십시오.
    • Close 스탑은 orderQty가 필요하지 않습니다. 아래 실행 지시를 참고하십시오.
  • StopLimit: 스탑 시장가와 유사하지만 시장가 대신 지정가 주문을 등록합니다. orderQty, stopPx, price를 지정하십시오.
  • MarketIfTouched: 스탑과 유사하지만 트리거 방향이 반대입니다. 이익 실현 주문에 유용합니다.
  • LimitIfTouched: 위와 동일하며 이익 실현 지정가 주문에 사용됩니다.
  • Pegged: Pegged 주문은 현재 시장 가격에 상대적인 지정가를 제출할 수 있습니다. pegPriceType과 pegOffsetValue를 지정하십시오.
    • Pegged 주문은 반드시 execInst가 Fixed여야 합니다. 이는 주문이 접수될 때 지정가가 설정되며 기준 가격이 변해도 변경되지 않음을 의미합니다.
    • PrimaryPeg: 가격이 근접 호가를 기준으로 설정됩니다.
    • MarketPeg: 가격이 원거리 호가를 기준으로 설정됩니다.
    • ordType 없이 pegPriceType만 제출하면 Pegged 주문으로 처리됩니다.

실행 지시​

다음 execInst가 지원됩니다. 여러 개를 사용할 경우 쉼표로 구분하십시오 (예: LastPrice,Close).

  • ParticipateDoNotInitiate: 포스트-온리 주문이라고도 합니다. 주문 제출 시 즉시 체결될 경우 대신 취소됩니다. 이는 주문이 전송되는 동안 원거리 호가가 사용자 쪽으로 이동하는 상황으로부터 보호하기 위한 것입니다. 제출 이후 원거리 호가가 멀어지는 것에 대한 투기 목적 사용은 허용되지 않으며, 이러한 행위는 모니터링됩니다.
  • MarkPrice, LastPrice, IndexPrice: 스탑 및 If-Touched 주문에서 트리거 가격을 결정하는 데 사용됩니다. 하나만 사용하십시오. 기본값은 MarkPrice입니다. 또한 Pegged 주문에서 LastPeg 값을 정의하는 데에도 사용됩니다. IndexPrice는 현물 거래 심볼에는 적용되지 않습니다.
  • ReduceOnly: ReduceOnly 주문은 포지션을 증가시키지 않고 감소시키기만 합니다. ReduceOnly 지정가 주문이 호가창에 남아 있는 동안 다른 주문으로 포지션이 감소하면 주문 수량이 감소되거나 취소됩니다. 여러 ReduceOnly 주문이 있는 경우 가장 덜 공격적인 주문이 먼저 조정됩니다. 현물 거래 심볼에는 적용되지 않습니다.
  • Close: Close는 ReduceOnly를 포함합니다. Close 주문은 동일한 방향과 심볼의 다른 활성 지정가 주문을 취소합니다(미체결 수량이 현재 포지션을 초과하는 경우). 이는 스탑에 유용하며, 이러한 주문을 취소함으로써 실행에 필요한 증거금을 확보하고 포지션 전체 크기까지만 실행되도록 합니다. orderQty가 지정되지 않은 경우 현재 포지션 크기가 orderQty로 설정됩니다. 현물 거래 심볼에는 적용되지 않습니다.
    • orderQty 없이 Close 주문을 사용할 경우 side를 지정해야 BitMEX가 stopPx 기준 위/아래 어느 방향으로 트리거할지 판단할 수 있습니다.
  • LastWithinMark: LastPrice를 사용하는 스탑 주문에서 다음 조건일 때만 트리거를 허용합니다:
    • 매도 스탑 시장가 / 스탑 지정가 주문:
      • 현재가 &lt= 스탑 가격
      • 현재가 &gt= 표시 가격 × (1 - 5%)
    • 매수 스탑 시장가 / 스탑 지정가 주문:
      • 현재가 &gt= 스탑 가격
      • 현재가 &lt= 표시 가격 × (1 + 5%)
    • 현물 거래 심볼에는 적용되지 않습니다.
  • Fixed: Pegged 주문은 반드시 execInst가 Fixed여야 합니다. 이는 주문이 접수될 때 지정가가 설정되며 기준 가격이 변해도 변경되지 않음을 의미합니다.

Pegged 주문​

Pegged 주문은 현재 시장 가격에 상대적인 지정가를 제출할 수 있습니다. 지정가는 주문 제출 시 한 번 설정되며 기준 가격이 변해도 변경되지 않습니다. 이 주문 유형은 제출 이후 원거리 호가가 멀어지는 것에 대한 투기 목적을 위해 설계된 것이 아니며, 이러한 행위는 모니터링됩니다.

Pegged 주문은 ordType이 Pegged, execInst가 Fixed입니다.

또한 pegPriceType과 pegOffsetValue를 함께 제출해야 합니다:

  • PrimaryPeg - 가격이 근접 호가를 기준으로 설정됩니다
  • MarketPeg - 가격이 원거리 호가를 기준으로 설정됩니다

추척손절매 Pegged 주문​

pegPriceType을 TrailingStopPeg로 사용하여 추척손절매를 생성할 수 있습니다.

가격은 제출 시 설정되며, 기초 가격(현재가/표시 가격/Index)이 0.1% 이상 변동할 경우 초당 한 번 업데이트됩니다. 이후 stopPx는 시장이 peg에서 멀어질 때 이동하며, peg 쪽으로 이동할 때는 고정됩니다.

pegOffsetValue를 사용하여 주문의 stopPx를 설정하십시오. peg는 execInst에서 지정한 트리거 가격(기본값 MarkPrice)으로 설정됩니다. 스탑 매도 및 buy-if-touched 주문에는 음수 오프셋을 사용하십시오.

필수 ordType: Stop, StopLimit, MarketIfTouched, LimitIfTouched.

연동 주문​

연동 주문은 고급 기능입니다. 매우 강력하지만 사용 시 신중한 코딩과 테스트가 필요합니다. 개발 중에는 이 문서를 따르고 Testnet Exchange를 사용하십시오.

BitMEX는 네 가지 고급 연동 주문 유형을 제공합니다:

  • OCO: One Cancels the Other. 표준 스탑 / 이익 실현 기법의 매우 유연한 형태입니다. 단일 clOrdLinkID를 사용하여 여러 주문을 연결할 수 있습니다. 주문에 contingencyType을 OneCancelsTheOther로 설정하십시오. 하나의 주문이 완전히 또는 부분적으로 체결되거나(Stop 주문의 경우 활성화) 하면 동일한 clOrdLinkID를 가진 다른 모든 주문이 취소됩니다.
  • OTO: One Triggers the Other. 기본 주문에 contingencyType을 'OneTriggersTheOther'로 설정하면 동일한 clOrdLinkID를 가진 후속 주문은 기본 주문이 완전히 체결될 때까지 트리거되지 않습니다.

추척손절매​

'TrailingStopPeg'의 pegPriceType을 사용하여 추척손절매를 생성할 수 있습니다. Pegged stopPx는 시장이 peg에서 멀어질 때 이동하고, peg 쪽으로 이동할 때는 고정됩니다.

사용 방법: pegOffsetValue와 함께 사용하여 주문의 stopPx를 설정합니다. peg는 execInst에서 지정한 트리거 가격(기본값 'MarkPrice')으로 설정됩니다. 스탑 매도 및 buy-if-touched 주문에는 음수 오프셋을 사용하십시오.

필수 ordType: 'Stop', 'StopLimit', 'MarketIfTouched', 'LimitIfTouched'.

레이트 리밋​

Amend 엔드포인트(PUT /order)를 사용하면 레이트 리밋을 유지하면서 시장 움직임에 대한 반응성을 향상시킬 수 있습니다. 이를 통해 시장에 계속 참여할 수 있으며 취소/재등록 사이클을 피할 수 있습니다.

주문 추적​

주문 ID를 직접 관리하려면 각 주문에 고유한 clOrdID를 설정하십시오. 이 clOrdID는 주문 및 관련 체결(WebSocket 포함)에 속성으로 반환되며, 주문 조회 또는 취소에 사용할 수 있습니다. 최대 길이는 36자입니다.

또한 주문을 수정할 때 origClOrdID와 새로운 clOrdID를 함께 제공하여 clOrdID를 변경할 수 있습니다. 예:

# 주문의 leavesQty를 수정하고 clOrdID를 "def-456"으로 업데이트
PUT /api/v1/order {"origClOrdID": "abc-123", "clOrdID": "def-456", "leavesQty": 1000}

Request​

Responses​