본문으로 건너뛰기

새로운 주문 생성

POST 
/api/v2/order

주문하기​

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

주문 유형​

모든 주문은 symbol이 필요합니다. symbol을 제외한 모든 필드는 특별히 명시되지 않는 한 선택 사항입니다.

다음은 유효한 ordTypes:

  • 지정가: 기본 주문 유형입니다. orderQty 및 price를 명시하십시오.
  • 시장가: 전통적인 시장가 주문입니다. 시장가 주문은 완전히 체결되거나 청산 가격에 도달할 때까지 실행되며, 그때 주문을 취소합니다.
  • 스탑 밸류: 정지 시장가 주문입니다. orderQty와 stopPx를 명시합니다. stopPx가 도달되면 주문이 책에 입력됩니다.
    • 판매 주문 시, 트리거 가격이 stopPx보다 낮으면 주문이 트리거됩니다. 매수할 때는 더 높습니다.
    • 참고: 정지 주문은 트리거되기 전까지 마진이 소모되지 않습니다. 충분한 마진이 계좌에 있는지 확인하여 완전히 트리거됩니다.
    • Close 스탑은 orderQty가 필수적이지 않습니다. 아래 실행 지침을 참조하십시오.
  • 스탑 제한가: 정지 시장가와 비슷하지만 시장가 대신 지정가 주문을 입력합니다. orderQty, stopPx, 및 price를 명시하십시오.
  • 터치 마켓 주문: 스탑과 비슷하지만 반대 방향으로 트리거됩니다. 이익 실현 주문에 유용합니다.
  • 터치 제한가 주문: 위와 같으며, 이익 실현 지정가 주문에 사용합니다.
  • 페그: 페그 주문은 사용자가 현재 시장 가격을 기준으로 지정가를 제출할 수 있게 해줍니다. pegPriceType과 pegOffsetValue를 명시합니다.
    • 페그 주문에는 Fixed의 execInst가 있어야 합니다. 이는 주문이 승인될 때 제한 가격이 설정되고 기준 가격이 변경되어도 변경되지 않음을 의미합니다.
    • PrimaryPeg: 근거리 가격을 기준으로 가격이 설정됩니다.
    • MarketPeg: 원거리 가격을 기준으로 가격이 설정됩니다.
    • pegPriceType이 제출되었으나 ordType이 설정되지 않으면 페그 주문으로 처리됩니다.

실행 지침​

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

  • 포스트 오직: 포스트-온리 주문도 알려져 있습니다. 이 주문이 배치 시 실행될 경우 취소됩니다. 이는 주문이 전환되는 동안 먼 거리에서 이동하는 것으로부터 보호하기 위한 것입니다. 제출 후 먼 거리에서 멀어지는 것을 예측한 경우 미세한 행동으로 간주하고 감시합니다.
  • MarkPrice, LastPrice, IndexPrice: 정지 및 터치 주문에서 트리거 가격을 결정하는 데 사용됩니다. 하나만 사용하십시오. 기본적으로 MarkPrice가 사용됩니다. 페그 주문 시에도 LastPeg의 값을 정의하기 위한 것입니다. IndexPrice는 현물 거래 심볼에 적용되지 않습니다.
  • ReduceOnly: ReduceOnly 주문은 포지션을 줄일 수만 있습니다. 책에 유지된 ReduceOnly 제한 주문이 있을 때 포지션이 다른 주문에 의해 줄어들면 수량이 축소되거나 취소될 수 있습니다. 여러 ReduceOnly 주문이 있으면 덜 갖춘 주문이 먼저 수정됩니다. 현물 거래 심볼에 적용되지 않습니다.
  • Close: Close는 ReduceOnly를 의미합니다. Close 주문은 같은 사이드와 심볼의 다른 활성 제한 주문을 취소합니다. 이는 정지 주문의 마진 사용을 보장하고 포지션 크기만큼만 실행할 수 있습니다. orderQty를 지정하지 않으면 Close 주문의 orderQty는 현재 포지션 크기와 동일합니다. 현물 거래 심볼에 적용되지 않습니다.
    • Close 주문은 orderQty 없이 side가 필요합니다. 이것은 BitMEX가 stopPx보다 위 또는 아래에서 트리거될지를 알기 위해 필요합니다.
  • LastWithinMark: LastPrice가 있는 정지 주문을 사용할 때만 정지 트리거를 허용하는 데 사용됩니다:
    • 판매 정지 시장가 / 제한 정지 주문
      • 마지막 가격 ≤ 정지 가격
      • 마지막 가격 ≥ 표시 가격 × (1 - 5%)
    • 매수 정지 시장가 / 제한 정지 주문:
      • 마지막 가격 ≥ 정지 가격
      • 마지막 가격 ≤ 표시 가격 × (1 + 5%)
    • 현물 거래 심볼에 적용되지 않습니다.
  • Fixed: 페그 주문은 Fixed의 execInst가 있어야 합니다. 이는 주문이 승인될 때 제한 가격이 설정되고 기준 가격이 변경되어도 변경되지 않음을 의미합니다.

페그 주문​

페그 주문은 사용자가 현재 시장 가격을 기준으로 지정가를 제출할 수 있게 해줍니다. 주문이 제출될 때 한 번 제한 가격이 설정되며, 기준 가격이 변경되어도 변하지 않습니다. 이 주문 유형은 제출 후 먼 거리로 이동할 것으로 추측하기 위해 설계된 것이 아닙니다 - 그런 행동은 오용으로 간주되며 모니터링합니다.

페그 주문은 ordType로 페그를 사용하고 execInst로 고정을 사용합니다.

pegPriceType과 pegOffsetValue도 제출해야 합니다:

  • PrimaryPeg: 근거리 가격을 기준으로 가격 설정
  • MarketPeg: 원거리 가격을 기준으로 가격 설정

추적 정지 페그 주문​

pegPriceType으로 TrailingStopPeg을 사용하여 추적 정지를 만드세요.

가격은 제출 시에 설정되며 기본 가격(마지막/표시/지수) 위치가 0.1% 이상 이동하면 초당 업데이트됩니다. stopPx가 페그로부터 멀어지면 시장이 움직이는 대로 이동하며, 반대로 시장이 페그 쪽으로 움직이는 경우 동결됩니다.

pegOffsetValue를 사용하여 주문의 stopPx를 설정하세요. 페그는 기본으로 MarkPrice에 지정된 트리거 가격에 설정됩니다. 매도 및 매수할 때 터치 주문에 부정적인 오프셋을 사용하세요.

ordType이 필요합니다: Stop, StopLimit, MarketIfTouched, LimitIfTouched.

연결된 주문​

링크된 주문은 고급 기능 중 하나입니다. 매우 강력하지만 사용 시 정확한 코딩과 테스트가 필요합니다. 이 문서를 신중히 따라 개발 시 Testnet Exchange를 사용해주세요.

BitMEX에서는 4가지 고급 연결된 주문 유형을 제공합니다:

  • OCO: 하나가 다른 하나를 취소합니다. 일반적인 정지 / 이익 실현 기술의 매우 유연한 버전입니다. clOrdLinkID를 사용하여 여러 주문이 함께 연결될 수 있습니다. 'OneCancelsTheOther'를 가진 contingencyType을 주문에 보내세요. 첫 번째 주문이 완전하거나 부분적으로 실행되면(정지 주문의 경우 실행됨) 동일한 clOrdLinkID를 가진 모든 다른 주문이 취소됩니다.
  • OTO: 하나가 다른 하나를 트리거합니다. 초기 주문에 contingencyType으로 'OneTriggersTheOther'를 보내세요, 이후 동일한 clOrdLinkID를 가진 후속 주문은 초기 주문이 완전히 실행될 때까지 트리거되지 않습니다.

추적 정지​

pegPriceType으로 'TrailingStopPeg'을 사용하여 추적 정지를 만들 수 있습니다. 페그 stopPx는 시장이 페그로부터 멀어지면 이동하고, 페그로 향할 때 동결됩니다.

사용하려면 pegOffsetValue와 결합하여 주문의 stopPx를 설정하세요. 페그는 기본으로 MarkPrice에 지정된 트리거 가격에 설정됩니다. 매도 및 매수할 때 터치 주문에 부정적인 오프셋을 사용하세요.

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}

요청​

응답​