Developer

문서 검색

엔드포인트, 개념, 에러 코드 검색

API 레퍼런스
주문/주문하기

주문하기

지정가 또는 시장가 주문을 제출합니다. Authorization 헤더에 JWT가 필요합니다.

POSThttps://api.inexcoin.com/v1/orders

요청 파라미터

symbolstring필수

주문을 제출할 마켓 코드입니다. 조회 API에서 확인한 symbol 값을 그대로 전달합니다.

예시 BTC-KRW

typeenum필수

주문 방식을 지정합니다. 1은 지정가 주문으로 price에 지정한 가격에 체결을 시도하고, 2는 시장가 주문으로 현재 호가에 즉시 체결됩니다.

예시 1

sideenum필수

주문 방향입니다. BUY는 기준 통화를 매수하는 주문, SELL은 기준 통화를 매도하는 주문입니다.

예시 BUY

volumestring필수

주문할 기준 통화 수량입니다. 지정가 주문은 이 수량 전체가 체결될 때까지 대기하며, 시장가 매도 주문도 동일하게 기준 통화 수량으로 지정합니다.

예시 0.0042

pricestring조건부

지정가 주문 시 체결을 원하는 단가입니다. type이 2(시장가)이고 side가 BUY인 경우에는 현재 호가로 즉시 체결되므로 생략할 수 있습니다.

예시 158000000

응답 필드

uuidstring

생성된 주문에 부여되는 고유 식별자입니다. 이후 주문 취소·조회 API에서 이 값으로 주문을 지정합니다.

예시 9f2b7c11-3a5e-4d80-9c11-0ab7d2e51f43

symbolstring

요청에서 전달한 마켓 코드가 그대로 반환됩니다.

예시 BTC-KRW

sideenum

요청에서 전달한 주문 방향(BUY 또는 SELL)이 그대로 반환됩니다.

예시 BUY

statestring

생성 직후의 주문 상태입니다. 아직 체결되지 않고 대기 중임을 나타내는 wait로 반환됩니다.

예시 wait

volumestring

요청에서 전달한 주문 수량이 그대로 반환됩니다.

예시 0.0042

pricestring

요청에서 전달했거나, 시장가 매수처럼 생략된 경우 체결 시점 기준으로 결정된 가격이 반환됩니다.

예시 158000000

created_atstring

주문이 접수된 시각입니다. ISO 8601 형식의 타임존 포함 문자열입니다.

예시 2026-07-28T11:32:00+09:00

응답 예제 201 OK

{
    "uuid": "9f2b7c11-3a5e-4d80-9c11-0ab7d2e51f43",
    "symbol": "BTC-KRW",
    "side": "BUY",
    "type": 1,
    "state": "wait",
    "volume": "0.0042",
    "price": "158000000",
    "created_at": "2026-07-28T11:32:00+09:00"
}