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, andquantityparameters, to put new order with specific price and quantity into orderbook. (costcannot be used with limit order.)Or you may use market order with
type:market,cost, andquantityparameters, to set market order cost. (limit_pricecannot be used with market order.)
Market buyWhen purchasing, you can use
costto specify the total limit ofmarket price * quantity. In this case,quantitycannot be used.
When selling, you can usecostto specify the total limit ofmarket price * quantityandquantityto specify the maximum sales quantity. (costmust 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 * amountshould 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