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

// 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": ''
}
  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"
}

// 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": ''
}
  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"
}


// 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": ''
}
  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"
}

// 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'
}
columntypemeaning
idtextspecific id for new order
user_idtextuser id whom makes order
market_idtextrequested market_id
sidetextEither "buy" or "sell"
typetextEither "limit" or "market"
quantitytextOrder quantity
limit_pricetextLimit order price
time_in_forcetextRequested time_in_force
filled_costtextReturns "0" when requested
filled_quantitytextReturns "0" when requested
cancelled_quantitytextReturns "0" when requested
open_quantitytextReturns quantity when requested
statustextCurrent order status
"open" | "filled" | "cancelled"
timetextOrder execution time
client_order_idtextOptional, intended to prevent duplicated order
costtextcost

πŸ“˜

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

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