주문 유형

8가지 주문 유형, 4가지 주문 유효 조건, 그리고 각각에 필요한 필드를 설명합니다.

OrderRequest는 POST /orders, POST /orders/batch(배열 요소로), POST /orders/preview와 각각의 /api/v1 쌍둥이 경로 등 주문을 넣는 모든 작업의 본문입니다.

이 페이지는 생성된 엔드포인트 페이지가 빠뜨리는, 작업 전반에 적용되는 내용을 다룹니다. 엔드포인트 페이지는 하나의 작업에 대해 계약이 선언하는 내용을 기술합니다. 아래의 요구 사항 표는 유효한 주문을 만드는 데 반드시 필요한 내용이며, 모든 작업에서 동일합니다.

각 유형이 무엇을 위한 것인지에 대한 트레이더 관점의 설명은 거래소 섹션의 주문 유형을 참조하십시오.

주문 제출 스키마

일반 Limit 및 Market 주문과 6가지 조건부 주문 유형(StopLimit, StopMarket, TakeProfitLimit, TakeProfitMarket, TrailingStop, TrailingLimit)을 지원합니다. 필드 요구 사항은 order_type에 따라 달라집니다.

• 지정가 계열(Limit, StopLimit, TakeProfitLimit)은 지정가 price가 필요합니다.
• 트리거형, 비트레일링 주문(StopLimit, StopMarket, TakeProfitLimit, TakeProfitMarket)은 trigger_price가 필요합니다(trigger_price가 없으면 레거시 stop_price 필드를 대체값으로 받아들입니다).
• TrailingStop은 시장가 전용이므로 시장가 주문으로 발동하며, trailing_offset_bps가 필요합니다. 지정가 price나 trigger_price는 받지 않습니다(트리거 기준점은 마크 가격과 오프셋에서 도출됩니다).
• TrailingLimit은 TrailingStop처럼 추적하지만, 시장가 주문 대신 지정가 주문으로 발동합니다. trailing_offset_bps(트레일링 트리거)와 limit_offset_bps(발동 시점의 지정가 오프셋)가 모두 필요합니다. price, trigger_price, stop_price는 받지 않습니다. 거래소는 발동 시점에 오프셋을 넘은 마크 가격으로 지정가를 계산합니다.

주문 유형별 필수 필드

market_id, side, order_type, quantity, time_in_force는 모든 주문 유형에 필요합니다. 네 가지 조건부 필드는 다음과 같이 결정됩니다.

order_type	price	trigger_price	trailing_offset_bps	limit_offset_bps	발동 형태
Limit	필수	사용 안 함	무시됨	무시됨	— (즉시 대기)
Market	생략	사용 안 함	무시됨	무시됨	— (즉시 체결)
StopLimit	필수	필수	무시됨	무시됨	지정가
StopMarket	생략	필수	무시됨	무시됨	시장가
TakeProfitLimit	필수	필수	무시됨	무시됨	지정가
TakeProfitMarket	생략	필수	무시됨	무시됨	시장가
TrailingStop	받지 않음	받지 않음	필수	무시됨	시장가
TrailingLimit	받지 않음	받지 않음	필수	필수	지정가

표 읽는 법:

• 필수. 이 필드가 없으면 요청이 거부됩니다.
• 생략. 이 필드는 시장가 계열 주문의 일부가 아니며, 설정할 지정가가 없습니다.
• 사용 안 함 / 받지 않음. 계약은 이 주문 유형이 해당 필드를 사용하지 않는다고 명시합니다. 트레일링 유형은 대신 마크 가격과 오프셋에서 트리거를 도출합니다.
• 무시됨. 필드가 있어도 되지만 이 주문 유형에는 아무 효과가 없습니다.

네 가지 트리거형 비트레일링 유형은 트리거 방향만 다릅니다. StopLimit과 StopMarket은 마크 가격이 불리한 방향으로 trigger_price를 넘을 때 발동하고, TakeProfitLimit과 TakeProfitMarket은 유리한 방향으로 넘을 때 발동합니다.

stop_price는 지원 중단되었습니다

stop_price는 trigger_price로 대체되어 지원 중단(deprecated)되었습니다. 규칙은 다음과 같습니다.

• trigger_price가 표준 트리거 임계값입니다.
• stop_price는 trigger_price가 없을 때 대체값으로만 받아들입니다.
• 둘 다 제공되면 trigger_price가 우선하며, stop_price는 무시됩니다.
• Limit, Market, TrailingStop, TrailingLimit 주문에서는 둘 다 완전히 무시됩니다.

새 통합에서는 trigger_price를 보내고 stop_price는 절대 보내지 마십시오.

주문 유효 조건

time_in_force는 모든 주문에 필요하며 네 가지 정책 중 하나를 사용합니다.

값	의미
GTC	취소 시까지 유효(Good-till-cancelled). 체결되거나 취소될 때까지 오더북에 대기합니다.
IOC	즉시 체결 후 잔량 취소(Immediate-or-cancel). 즉시 체결 가능한 만큼 체결하고 나머지는 취소합니다.
FOK	전량 체결 또는 전량 취소(Fill-or-kill). 즉시 전량 체결되거나, 그렇지 않으면 전부 취소됩니다.
PostOnly	진입 시 유동성을 가져가게(오더북을 가로지르게) 되면 주문을 거부하여, 메이커로 대기하도록 보장합니다.

계약이 자세히 설명하는 값은 PostOnly뿐입니다. 위의 GTC, IOC, FOK 설명은 각 약어의 표준적인 의미이며, 계약 자체는 이를 풀어 쓰지 않습니다.

OrderRequest 필드

필드	타입	필수	설명
market_id	string	예	시장 식별자(예: BTC-USDX-PERP).
side	Buy / Sell	예	주문 방향.
order_type	Limit / Market / StopLimit / StopMarket / TakeProfitLimit / TakeProfitMarket / TrailingStop / TrailingLimit	예	주문 유형. Limit과 Market은 무조건 주문입니다. 나머지 여섯 가지는 조건부입니다. StopLimit / StopMarket은 마크 가격이 불리한 방향으로 trigger_price를 넘을 때 발동합니다. TakeProfitLimit / TakeProfitMarket은 유리한 방향으로 넘을 때 발동합니다. TrailingStop은 마크 가격이 관측된 가장 유리한 극값에서 trailing_offset_bps만큼 되돌아올 때 시장가 주문으로 발동합니다. TrailingLimit은 같은 방식으로 발동하지만, 발동 시점의 가격에서 limit_offset_bps만큼 떨어진 가격의 지정가 주문을 대기시킵니다.
price	decimal string	조건부	지정가. 지정가 계열 주문(Limit, StopLimit, TakeProfitLimit)에 필요합니다. 시장가 계열 및 트레일링 주문에서는 생략하십시오.
quantity	decimal string	예	주문 수량. 문자열로 직렬화된 임의 정밀도 소수(무손실)입니다. 부동소수점이 아니라 반드시 decimal 타입으로 파싱하십시오.
time_in_force	GTC / IOC / FOK / PostOnly	예	주문 유효 조건 정책. PostOnly는 진입 시 유동성을 가져가게(오더북을 가로지르게) 되면 주문을 거부하여, 메이커로 대기하도록 보장합니다.
reduce_only	boolean	아니요	계약은 이 필드를 설명 없이 선언합니다. 알려진 제약 사항을 참조하십시오.
stop_price	decimal string or null	아니요, 지원 중단	지원 중단. 대신 trigger_price를 사용하십시오. 스탑 / 익절 계열의 레거시 트리거 임계값. trigger_price가 없을 때만 대체값으로 받아들입니다. 둘 다 제공되면 trigger_price가 우선합니다. Limit, Market, TrailingStop, TrailingLimit 주문에서는 무시됩니다.
trigger_price	decimal string or null	조건부	트리거형 비트레일링 주문(StopLimit, StopMarket, TakeProfitLimit, TakeProfitMarket)의 표준 트리거 임계값으로, 이 주문들에 필요합니다(생략하면 레거시 stop_price 필드를 대체값으로 받아들입니다). Limit, Market, TrailingStop, TrailingLimit 주문에서는 사용하지 않습니다.
trailing_offset_bps	integer (minimum 0) or null	조건부	베이시스 포인트 단위의 트레일링 오프셋(1 bp = 0.01%). TrailingStop 및 TrailingLimit 주문에 필요하며, 다른 모든 주문 유형에서는 무시됩니다. 트레일링 트리거는 마크 가격이 관측된 가장 유리한 극값에서 이 베이시스 포인트만큼 되돌아오면 발동합니다. TrailingStop은 시장가 주문으로, TrailingLimit은 limit_offset_bps로 가격이 정해진 지정가 주문으로 발동합니다. 값 0도 허용되며, 이 경우 주문 제출 후 첫 번째 마크 가격 평가에서 트리거가 발동합니다(되돌림 불필요).
limit_offset_bps	integer (0–9999) or null	조건부	발동된 지정가의 베이시스 포인트 단위 오프셋(TrailingLimit 전용, trailing_offset_bps와 함께 필요). 트레일링 트리거가 fire_price에서 발동하면, 주입된 지정가 주문은 매수의 경우 fire_price × (1 + offset), 매도의 경우 × (1 − offset)에 대기하며, 호가 단위에 맞춰 더 좁은 쪽으로 반올림됩니다. 값 0은 정확히 fire_price에 지정가를 대기시킵니다. 다른 주문 유형에서는 무시됩니다.

주문 승인은 증거금 부등식에 따릅니다

거래소는 주문 자체의 예약분을 포함한 뒤에도 계정이 개시 증거금 요건을 계속 충족하는 경우에만 주문을 받아들입니다. 이것이 거래소 증거금 모델의 주문 승인 부등식(M.13)입니다. 증거금 수학(Margin math)을 참조하십시오.

POST /orders에서 증거금 부족 사유로 반환되는 400은 이 부등식이 충족되지 않은 경우입니다. 제출하지 않고 이를 평가하려면 POST /orders/preview를 사용하십시오.