/new_order

Example)

  1. Selling 240 BTC at 3772.4USDT in BTC-USDT market by limit order
{
  "market_id":"BTC-USDT",
  "type":"limit",
  "side":"sell",
  "time_in_force":"gtc",
  "limit_price":"3772.4",
  "quantity":"240"
}
  1. Buying 0.001 BTC at 3772.4 USDT in BTC-USDT market by limit order
{
  "market_id":"BTC-USDT",
  "type":"limit",
  "side":"buy",
  "time_in_force":"gtc",
  "limit_price":"3772.4",
  "quantity":"0.001"
}
  1. Selling 0.1 BTC in BTC-USDT market by market order
{
  market_id: "BTC-USDT",
  quantity: "0.1",
  side: "sell",
  time_in_force: "ioc",
  type: "market"
}
  1. buying BTC with 0.01USDT in BTC-USDT market by market order
{
  "cost": "0.01",
  "market_id": "BTC-USDT",
  "side": "buy",
  "time_in_force": "ioc",
  "type": "market"
}

column

type

meaning

id

text

specific id for new order

user_id

text

user id whom makes order

market_id

text

requested market_id

side

text

Either "buy" or "sell"

type

text

Either "limit" or "market"

quantity

text

Order quantity

limit_price

text

Limit order price

time_in_force

text

Requested time_in_force

filled_cost,
filled_quantity,
cancelled_quantity

text

Returns "0" when requested

open_quantity

text

Returns quantity when requested

status

text

Current order status
"open" | "filled" | "cancelled"

time

text

Order execution time

client_order_id

text

Optional, intended to prevent duplicated order

๐Ÿ“˜

About limit order and market order (limit_price, cost, quantity)

ProBit Exchange supports limit order and market order.

You may use limit order with type: limit, limit_price, and quantity parameters, to put new order with specific price and quantity into orderbook. (cost cannot be used with limit order.)

Or you may use market order with type: market, cost, and quantity parameters, to set market order cost. (limit_price cannot be used with market order.)
Market buy
๊ตฌ๋งค ์‹œ cost๋ฅผ ์ด์šฉํ•ด ์‹œ์žฅ๊ฐ€ ์ˆ˜๋Ÿ‰์˜ ์ด ํ•œ๋„๋ฅผ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ์ด ๊ฒฝ์šฐ quantity๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.
ํŒ๋งค ์‹œ cost๋ฅผ ์ด์šฉํ•ด ์‹œ์žฅ๊ฐ€
์ˆ˜๋Ÿ‰์˜ ์ด ํ•œ๋„๋ฅผ ์ง€์ •ํ•˜๊ณ  quantity๋ฅผ ์ด์šฉํ•ด ์ตœ๋Œ€ ํŒ๋งค ์ˆ˜๋Ÿ‰์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. (cost๋Š” ๋ฐ˜๋“œ์‹œ ์‚ฌ์šฉ์ž ์ž”๊ณ ๋ณด๋‹ค ์ž‘์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค.)

๐Ÿ“˜

Supported type, time_in_force combination

If you are ordering "Limit" order,
all time_in_force will be supported.

If you are ordering "Market",
IOC or FOK will be supported.

Errors

โ—๏ธ

400 Bad Request

INVALID_ARGUMENT

  • missing: The parameter is not shown in the body.
  • invalid: The parameter is not a valid format.
  • duplicate: The parameter is already used.
  • {"cost": "invalid"} : Cost value out of range. The cost can be found in the /market API.
  • If you are doing limit order, price * amount should be in range.
    {"scope": "not allowed scope"} : It occurs when transaction is not allowed in API setting.

INVALID_MARKET

  • not_exist: The parameter has a valid format, but related_data is null.
  • market_id: Could not found market_id.

NOT_ENOUGH_BALANCE

  • Balance doesn't match with your sell condition.

โ—๏ธ

401 Unauthorized

If we can not determinate your profile, We will reject with this error code.

โ—๏ธ

429 Too many Request

If you order over [some-order-rate-count] times, you will get this error.
You can get this error when your request is too frequent. In this case, try again after header value ("Retry-After")

๐Ÿ“˜

If you are unfamiliar with our errors

See here!
HTTP Errors

โ—๏ธ

503 Service Unavailable

TRADING_UNAVAILABLE:

  • Our server is full-loaded. Please try again a little later.

MARKET_UNAVAILABLE

  • The market is closed now. Check out our announcement at our homepage.
Language
Authentication
OAuth2
Click Try It! to start a request and see the response here!