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 |
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
, andquantity
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
, andquantity
parameters, to set market order cost. (limit_price
cannot be used with market order.)
Market buyWhen purchasing, you can use
cost
to specify the total limit ofmarket price * quantity
. In this case,quantity
cannot be used.
When selling, you can usecost
to specify the total limit ofmarket price * quantity
andquantity
to specify the maximum sales quantity. (cost
must be less than the user's balance.)
Supported type, time_in_force combinationIf 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 RequestINVALID_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 UnauthorizedIf we can not determinate your profile, We will reject with this error code.
429 Too many RequestIf 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 UnavailableTRADING_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 errorsSee here!
HTTP Errors