body 예제입니다.
- 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"
}
- 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"
}
- BTC-USDT 마켓에서 market 주문으로 0.1 BTC만큼 팔때
{
market_id: "BTC-USDT",
quantity: "0.1",
side: "sell",
time_in_force: "ioc",
type: "market"
}
- 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 | 주문 가격 ( |
time_in_force | text | 지정한 Time-In-Force 옵션 |
filled_cost, | text | 체결된 cost, 요청응답에는 "0" 이 돌아옴. |
open_quantity | text | 거래중인 수량. |
status | text | 현재 주문 상태. |
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를 확인하십시오.