본문으로 건너뛰기

새로운 주문 생성

POST 
/api/v1/order

주문 제출하기​

이 엔드포인트는 주문을 제출하는 데 사용됩니다. 각 필드의 사용에 대한 자세한 정보를 보려면 아래를 참조하십시오.

주문 유형​

모든 주문에는 symbol이 필요합니다. 다른 모든 필드는 명시된 경우가 아니면 선택 사항입니다.

유효한 ordType은 다음과 같습니다:

  • 제한가격: 기본 주문 유형입니다. orderQty와 price를 지정하십시오.
  • 시장가격: 전통적인 시장 주문입니다. 시장 주문은 주문이 체결되거나 귀하의 파산 가격이 도달할 때 까지 실행되며, 그 지점에서 취소됩니다.
  • 스탑: 스탑 시장 주문입니다. orderQty와 stopPx를 지정하십시오. stopPx가 도달하면 주문이 입력됩니다.
    • 매도 주문의 경우, 트리거 가격이 stopPx보다 낮으면 주문이 트리거됩니다. 매수의 경우 반대입니다.
    • 참고: 스탑 주문은 트리거할 때까지 증거금을 소비하지 않습니다. 완전히 트리거할 수 있도록 귀하의 계좌에 필요한 증거금이 있는지 확인하십시오.
    • Close 스탑은 orderQty가 필요하지 않습니다. 아래 실행 지침을 참조하십시오.
  • 정지제한: 스탑 시장과 유사하지만 시장 주문 대신 제한 주문에 들어갑니다. orderQty, stopPx 및 price를 지정하십시오.
  • 터치 시 시장 체결: 스탑과 유사하나, 트리거가 반대 방향으로 진행됩니다. 이익 실현 주문에 유용합니다.
  • 터치 시 제한: 위와 같습니다; 이익 실현 제한 주문에 사용하십시오.
  • 페그드: 페그드 주문은 사용자가 현재 시장 가격에 상대적으로 제한 가격을 제출할 수 있도록 합니다. pegPriceType 및 pegOffsetValue를 지정하십시오.
    • 페그드 주문에는 반드시 Fixed의 execInst가 있어야 합니다. 이는 참조 가격이 변하지 않는 시간이 한정된 상태로 주문이 접수되었을 때, 제한 가격이 설정됨을 의미합니다.
    • PrimaryPeg: 가격이 근접한 터치 가격에 상대적으로 설정됩니다.
    • MarketPeg: 가격이 먼 터치 가격에 상대적으로 설정됩니다.
    • pegPriceType이 ordType 없이 제출되면, Pegged 주문으로 간주됩니다.

실행 지침​

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

  • 참여하지만 시작하지 않음: 포스트 온리 주문으로도 알려져 있습니다. 만약 이 주문이 제출 시점에 즉시 체결되었을 경우, 취소됩니다. 이는 주문이 전송 중일 때 멀리 있는 터치가 귀하에게 다가오는 경우로부터 귀하를 보호하려는 의도입니다.
  • MarkPrice, LastPrice, IndexPrice: 스탑 및 터치 시 체결 주문에서 트리거 가격을 결정하는 데 사용됩니다. 기본적으로, MarkPrice이 사용됩니다. 또한 페그드 주문에 LastPeg의 값을 정의하기 위해 사용됩니다. 스팟 거래 심볼에는 적용되지 않습니다.
  • 감축전용: ReduceOnly 주문은 귀하의 포지션을 감축할 수만 있고 증가시킬 수는 없습니다. 포지션이 다른 주문에 의해 감축되는 동안 주문책에서 대기 중인 ReduceOnly 제한 주문의 경우, 주문 수량이 변경되거나 취소됩니다. ReduceOnly 주문이 여러 개인 경우 가장 덜 공격적인 것이 우선 수정됩니다. 스팟 거래 심볼에는 적용되지 않습니다.
  • 종료: Close는 ReduceOnly를 포함합니다. Close 주문은 열려 있는 수량이 현재 포지션보다 초과되는 같은 방향과 심볼의 다른 활성화된 제한 주문을 취소할 것입니다. 이는 스탑에 유용합니다: 이러한 주문을 취소함으로써 Close 스탑은 완전히 실행할 수 있는 데 필요한 증거금을 확실히 할 수 있으며, 귀하의 포지션의 전체 크기까지 실행할 수 있습니다. orderQty가 지정되지 않은 경우, Close 주문은 현재 포지션의 크기와 동일한 orderQty를 갖습니다. 스팟 거래 심볼에는 적용되지 않습니다.
    • orderQty 없는 Close 주문은 위나 아래를 트리거해야 할 때 BitMEX가 알 수 있도록 side가 필요합니다.
  • MarkPrice내 마지막: 스탑 주문에서 LastPrice로
    • 매도 스톱 시장 / 스톱 제한 주문 시 트리거 제한:
      • 현재가 &lt= 스탑 가격
      • 현재가 &gt= 표시 가격 × (1 - 5%)
    • 매수 스톱 시장 / 스톱 제한 주문 시:
      • 현재가 &gt= 스탑 가격
      • 현재가 &lt= 표시 가격 × (1 + 5%)
    • 스팟 거래 심볼에는 적용되지 않습니다.
  • 고정: 페그드 주문에 Fixed([참조 음부터 대문자 대체 관리])의 execInst가 반드시 필요합니다. 이는 참조 가격이 변하지 않는 시간이 한정된 상태로 주문이 접수되었을 때, 제한 가격이 설정됨을 의미합니다.

페그드 주문​

페그드 주문은 사용자가 현재 시장 가격에 상대적으로 제한 가격을 제출할 수 있도록 합니다. 제한 가격은 최초 주문이 제출되었을 때 설정되고, 참조 가격과 함께 변경되지 않습니다. 이 주문 유형은 제출 후 멀리 있는 터치가 이동하는 데 대해 투기하는 것이 목표가 아닙니다 - 우리는 그러한 행위를 학대적으로 간주하며 모니터링합니다.

페그드 주문에는 ordType이 Pegged, execInst가 Fixed입니다.

또한 pegPriceType 그리고 pegOffsetValue도 제출되어야 합니다:

  • PrimaryPeg - 가격은 근접한 터치 가격에 상대적으로 설정됩니다
  • MarketPeg - 가격이 먼 터치 가격에 상대적으로 설정됩니다

추적손절매 페그드 주문​

TrailingStopPeg의 pegPriceType를 사용하여 추적손절매를 만드십시오.

가격은 제출 시 설정되며, 기본 가격이 (현재/표시/인덱스) 0.1% 이상 이동한 경우 1초에 한 번씩 업데이트됩니다. stopPx는 그 뒤로 시장이 페그에서 멀어짐에 따라 이동하고, 시장이 페그로 다가오면 동결됩니다.

execInst에 지정된 트리거 가격(기본 설정은 `MarkPrice)으로 설정됩니다. 스탑 매도 및 매수 시 트리거 시 부정적 오프셋 사용합니다.

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

연결된 주문​

연결된 주문은 고급 기능입니다. 강력하지만 사용 시 신중한 코딩 및 테스트가 필요합니다. 이 문서를 철저히 따르고 BitMEX Testnet을 사용하여 개발하십시오.

비트멕스는 4개의 고급 연결 주문 유형을 제공합니다:

  • OCO: One Cancels the Other. 표준 스탑 / 이익 실현 기법의 매우 유연한 버전입니다. 여러 개의 주문을 하나의 clOrdLinkID로 연결할 수 있습니다. OneCancelsTheOther로 지정된 부분 또는 전체 실행된 첫 번째 주문(또는 Stop 주문의 경우 활성화된 경우) 이 다른 모든 동일 clOrdLinkID 주문을 취소합니다.
  • OTO: One Triggers the Other. 주요 주문에 대해 OneTriggersTheOther의 contingencyType을 보내고 이후 동일한 clOrdLinkID로 주문이 때도록 주요 주문이 완전히 실행될 때까지 트리거되지 않습니다.

추적 스탑스​

'추적손절매'를 만들기 위해 'TrailingStopPeg'의 'pegPriceType'을 사용할 수 있습니다. 겹친 'stopPx'는 시장이 페그에서 멀어질 때 이동하고, 페그로 다가오면 동결됩니다.

사용하려면 'pegOffsetValue'를 사용하여 주문의 'stopPx'를 설정하십시오. 페그는 execInst에 지정된 트리거 가격(기본 MarkPrice)에서 설정됩니다. 스탑 매도 및 매수 시 터치 전 채우기 주문을 위해 부정적 오프셋 사용하십시오.

필요한 ordType: Stop', 'StopLimit', 'MarketIfTouched', 'LimitIfTouched.

비율 제한​

계속해서 거부 기준을 둔 응답성을 개선하려면 수정 엔드포인트 (PUT 주문)를 사용하실 수 있습니다. 이렇게 하면 시장에서 유지하며 취소/대체주기 방지.

주문 추적​

주문 ID를 직접 추적하고 싶다면, 각 주문마다 고유한 clOrdID를 설정하세요. 이 clOrdID는 주문 및 관련 실행 시 (수/빼) 속성으로 돌아오며, 특정(cf) 주문/취소에 사용될 수 있습니다. 최대 길이는 36자입니다.

주문 수정 : 'origClOrdID'와 원하는 새 ID를 clOrdID 매개변수로 제공하여 주문을 수정할 수 있습니다, 다음과 같이:

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

요청​

응답​