> For the complete documentation index, see [llms.txt](https://docs.nexus.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexus.xyz/api-reference/ko/guides/order-types.md). # 주문 유형 8가지 주문 유형, 4가지 주문 유효 조건, 그리고 각각에 필요한 필드를 설명합니다. `OrderRequest`는 `POST /orders`, `POST /orders/batch`(배열 요소로), `POST /orders/preview`와 각각의 `/api/v1` 쌍둥이 경로 등 주문을 넣는 모든 작업의 본문입니다. **이 페이지는 생성된 엔드포인트 페이지가 빠뜨리는, 작업 전반에 적용되는 내용을 다룹니다.** 엔드포인트 페이지는 하나의 작업에 대해 계약이 선언하는 내용을 기술합니다. 아래의 요구 사항 표는 유효한 주문을 만드는 데 반드시 필요한 내용이며, 모든 작업에서 동일합니다. 각 유형이 *무엇을 위한* 것인지에 대한 트레이더 관점의 설명은 거래소 섹션의 [주문 유형](https://docs.nexus.xyz/exchange/trading/perpetuals/order-types)을 참조하십시오. ## 주문 제출 스키마 일반 `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 | 아니요 | 계약은 이 필드를 설명 없이 선언합니다. [알려진 제약 사항](/api-reference/ko/guides/known-gaps.md#trading)을 참조하십시오. | | `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)](https://docs.nexus.xyz/math-engine/margin-math)을 참조하십시오. `POST /orders`에서 증거금 부족 사유로 반환되는 `400`은 이 부등식이 충족되지 않은 경우입니다. 제출하지 않고 이를 평가하려면 `POST /orders/preview`를 사용하십시오. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.nexus.xyz/api-reference/ko/guides/order-types.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.