본문으로 건너뛰기

새 주문 생성

POST 
/api/v2/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 주문은 동일한 방향과 심볼의 다른 활성 지정가 주문을 취소합니다(오픈 수량이 현재 포지션을 초과하는 경우). 이는 스탑 주문에 유용하며, 해당 주문들을 취소함으로써 Close 스탑이 실행에 필요한 증거금을 확보하고 포지션 전체 크기까지만 실행되도록 합니다. orderQty가 지정되지 않으면 Close 주문의 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로 사용하여 추척손절매를 생성할 수 있습니다.

가격은 제출 시 설정되며 기초 가격(현재가/표시 가격/인덱스)이 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를 가진 후속 주문은 기본 주문이 완전히 실행될 때까지 트리거되지 않습니다.

추척손절매​

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

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

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

속도 제한​

Amend 엔드포인트 (PUT /order)를 사용하면 속도 제한을 유지하면서 시장 변동에 대한 반응성을 향상시킬 수 있습니다. 이를 통해 시장에 계속 참여하면서 취소/재주문 사이클을 피할 수 있습니다.

주문 추적​

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

또한 주문을 수정하면서 origClOrdID를 제공하고 새로운 ID를 clOrdID 매개변수로 지정하여 clOrdID를 변경할 수 있습니다:

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

Request​

Responses​