/new_order

body 예제입니다.

  1. BTC-USDT 마켓에서 Limit 주문으로 3772.4 USDT 가격에 240 BTC 만큼 팔때
{
  "market_id":"BTC-USDT",
  "type":"limit",
  "side":"sell",
  "time_in_force":"gtc",
  "limit_price":"3772.4",
  "quantity":"240"
}
  1. BTC-USDT 마켓에서 Limit 주문으로 3772.4 USDT 가격에 0.001 BTC만큼 살때
{
  "market_id":"BTC-USDT",
  "type":"limit",
  "side":"buy",
  "time_in_force":"gtc",
  "limit_price":"3772.4",
  "quantity":"0.001"
}
  1. BTC-USDT 마켓에서 market 주문으로 0.1 BTC만큼 팔때
{
  market_id: "BTC-USDT",
  quantity: "0.1",
  side: "sell",
  time_in_force: "ioc",
  type: "market"
}
  1. BTC-USDT 마켓에서 market 주문으로 0,01 USDT 만큼 살때
{
  "cost": "0.01",
  "market_id": "BTC-USDT",
  "side": "buy",
  "time_in_force": "ioc",
  "type": "market"
}

field

type

description

id

text

오더 ID

user_id

text

사용자 ID

market_id

text

마켓 ID

side

text

"buy" 또는 "sell"

type

text

"limit" 또는 "market"

quantity

text

주문 수량

limit_price

text

주문 가격 (type: limit)

time_in_force

text

지정한 Time-In-Force 옵션

filled_cost,
filled_quantity,
cancelled_quantity

text

체결된 cost,
체결된 수량,
취소한 수량.

요청응답에는 "0" 이 돌아옴.

open_quantity

text

거래중인 수량.
quantity 와 같은양이 돌아옴.

status

text

현재 주문 상태.
남은 주문: 'open'
완료된 주문: 'filled'
취소된 주문: 'cancelled'

time

text

주문 접수 시간

client_order_id

text

사용자가 요청한 client_order_id (중복 주문 방지용 필드, optional)

📘

시장가, 지정가 주문에 대하여 (limit_price, cost, quantity)

ProBit 거래소에서는 시장가 주문과 지정가 주문이 가능합니다.

지정가 주문 시 type: limit, limit_price, quantity를 이용해 사용자가 지정한 가격에 지정한 수량만큼 주문을 오더북에 추가할 수 있습니다. 이 경우 cost는 사용할 수 없습니다.

시장가 주문 시 type: market, cost, quantity를 이용해 시장가 구매, 판매 한도를 지정할 수 있습니다. 이 경우 limit_price는 사용할 수 없습니다.
구매 시 cost를 이용해 시장가 수량의 총 한도를 지정할 수 있습니다. 이 경우 quantity는 사용할 수 없습니다.
판매 시 cost를 이용해 시장가
수량의 총 한도를 지정하고 quantity를 이용해 최대 판매 수량을 지정할 수 있습니다. (cost는 반드시 사용자 잔고보다 작아야 합니다.)

📘

주문 형식과 Time-In-Force 조합

지정가 주문시 모든 time_in_force 옵션이 유효합니다.
시장가 주문시 ioc, fok만이 지원됩니다.

Errors

❗️

400 Bad Request 오류 메시지

INVALID_ARGUMENT

  • missing: 파라미터가 body에 존재하지 않습니다.
  • invalid: 파라미터가 올바른 형식이 아닙니다.
  • duplicate: 중복된 client_order_id입니다.
  • {"cost": "invalid"} : 지정된 cost 범위안의 값이 없습니다. 최소, 최대 cost는 /market API에서 확인 가능합니다.
  • 지정가 주문을 하는 경우, 가격과 수량의 곱이 cost 범위 안에 있어야합니다.
  • {"scope": "not allowed scope"} : API설정에서 거래 허용이 되어 있지 않은 경우에 발생합니다.

INVALID_MARKET

  • 마켓이 존재하지 않습니다.

NOT_ALLOWED_COMBINATION

  • invalid: 사용할 수 없는 time_in_force입니다.

NOT_ENOUGH_BALANCE

  • 잔고가 부족합니다.

❗️

401 Unauthorized

인증 상태를 확인할 수 없습니다.

❗️

429 Too many Request

시간당 주문 횟수 또는 사용자 주문 총량을 초과했습니다.
시간당 주문 횟수의 경우 응답의 Retry-After 헤더를 참조하십시오.

❗️

503 Service Unavailable

TRADING_UNAVAILABLE

  • 서버에 처리량이 많아 응답할 수 없습니다. 잠시 후 다시 시도해주세요.

MARKET_UNAVAILABLE

  • 현재 사용할 수 없는 마켓입니다. 홈페이지의 공지사항을 확인해주세요.

📘

더 많은 에러를 확인하려면 Error Codes를 확인하십시오.

Language
Authentication
OAuth2
Click Try It! to start a request and see the response here!