/new_order

Example)

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"
}

// Response
{
    "id": '853148',
    "user_id": '1c7d2747-9b50-46c8-b917-d8cef81f7595',
    "market_id": 'BTC-USDT',
    "type": 'limit',
    "side": 'buy',
    "quantity": '0.001',
    "limit_price": '3772.4',
    "time_in_force": 'gtc',
    "filled_cost": '0',
    "filled_quantity": '0',
    "open_quantity": '0.001',
    "cancelled_quantity": '0',
    "status": 'open',
    "time": '2022-12-12T06:59:50.667Z',
    "client_order_id": ''
}

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"
}

// Response 
{
    "id": '853073',
    "user_id": '1c7d2747-9b50-46c8-b917-d8cef81f7595',
    "market_id": 'BTC-USDT',
    "type": 'limit',
    "side": 'buy',
    "quantity": '0.001',
    "limit_price": '3772.4',
    "time_in_force": 'gtc',
    "filled_cost": '0',
    "filled_quantity": '0',
    "open_quantity": '0.001',
    "cancelled_quantity": '0',
    "status": 'open',
    "time": '2022-12-12T06:55:31.409Z',
    "client_order_id": ''
}

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"
}


// Response 
{
    "id": '853091',
    "user_id": '1c7d2747-9b50-46c8-b917-d8cef81f7595',
    "market_id": 'BTC-USDT',
    "type": 'market',
    "side": 'sell',
    "quantity": '0.1',
    "limit_price": '0',
    "time_in_force": 'ioc',
    "filled_cost": '0',
    "filled_quantity": '0',
    "open_quantity": '0.1',
    "cancelled_quantity": '0',
    "status": 'open',
    "time": '2022-12-12T06:55:52.440Z',
    "client_order_id": ''
}

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"
}

// Response 
{
    "id": '853095',
    "user_id": '1c7d2747-9b50-46c8-b917-d8cef81f7595',
    "market_id": 'BTC-USDT',
    "type": 'market',
    "side": 'buy',
    "limit_price": '0',
    "time_in_force": 'ioc',
    "filled_cost": '0',
    "filled_quantity": '0',
    "status": 'open',
    "time": '2022-12-12T06:56:02.923Z',
    "client_order_id": '',
    "cost": '0.01'
}

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	text	Returns "0" when requested
filled_quantity	text	Returns "0" when requested
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
cost	text	cost

📘
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
When purchasing, you can use cost to specify the total limit of market price * quantity. In this case, quantity cannot be used.
When selling, you can use cost to specify the total limit of market price * quantity and quantity to specify the maximum sales quantity. (cost must be less than the user's balance.)

📘
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")

❗️
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.

📘
If you are unfamiliar with our errors
See here!
HTTP Errors