The endpoint creates limit trading order.
depth, bookTicker). RPI orders are visible only in private active orders and in the exchange UI order book (web/mobile).37 when both rpi=true and ioc=true are used.Error Codes
30 - default validation error code31 - market validation failed32 - amount validation failed33 - price validation failed36 - clientOrderId validation failed37 - ioc=true cannot be used with postOnly=true or rpi=trueErrors
{
"code": 30,
"message": "Validation failed",
"errors": {
"amount": ["Amount field is required."],
"market": ["Market field is required."],
"price": ["Price field is required."],
"side": ["Side field is required."]
}
}
{
"code": 30,
"message": "Validation failed",
"errors": {
"side": ["Side field should contain only 'buy' or 'sell' values."]
}
}
{
"code": 32,
"message": "Validation failed",
"errors": {
"amount": ["Amount field should be numeric string or number."]
}
}
{
"code": 33,
"message": "Validation failed",
"errors": {
"price": ["Price field should be numeric string or number."]
}
}
{
"code": 31,
"message": "Validation failed",
"errors": {
"market": ["Market is not available."]
}
}
{
"code": 31,
"message": "Validation failed",
"errors": {
"market": ["Market field should not be empty string."]
}
}
{
"code": 32,
"message": "Validation failed",
"errors": {
"amount": [
"Given amount is less than min amount 0.001",
"Min amount step = 0.000001"
]
}
}
{
"code": 36,
"message": "Validation failed",
"errors": {
"clientOrderId": ["ClientOrderId field should be a string."]
}
}
{
"code": 36,
"message": "Validation failed",
"errors": {
"clientOrderId": [
"ClientOrderId field should contain only latin letters, numbers and dashes."
]
}
}
{
"code": 36,
"message": "Validation failed",
"errors": {
"clientOrderId": [
"This client order id is already used by the current account."
]
}
}
{
"code": 37,
"message": "Validation failed",
"errors": {
"ioc": ["Either IOC or PostOnly flag in true state is allowed."]
}
}
{
"code": 30,
"message": "Validation failed",
"errors": {
"total": ["Total (amount * price) is less than 5.05"]
}
}
{
"code": 32,
"message": "Validation failed",
"errors": {
"amount": [
"Min amount step = 0.01"
]
}
}
{
"code": 33,
"message": "Validation failed",
"errors": {
"price": ["Price field should be at least 10", "Min price step = 0.000001"]
}
}
{
"code": 33,
"message": "Validation failed",
"errors": {
"price": ["Price should be greater than 0."]
}
}
{
"code": 35,
"message": "Validation failed",
"errors": {
"maker_fee": ["Incorrect maker fee"]
}
}
API Key authentication for private endpoints.
Required headers:
Order type. Variables: 'buy' / 'sell' Example: 'buy'
buy, sell Price in money currency. Example: '9800' or 9800
"9800"
Identifier should be unique and contain letters, dashes, numbers, dots or underscores. The identifier must be unique.
Immediate-or-cancel (IOC) executes all or part of an order immediately and cancels any unfilled portion.
IOC does not support rpi=true because RPI uses post-only behavior by design.
The API returns error code 37 when a request sets both ioc=true and rpi=true.
Refer to Order Parameter Rules for unsupported parameter combinations.
Self trade prevention mode. Variables: 'no' / 'cancel_both' / 'cancel_new' / 'cancel_old'. Example: 'no'.
no, cancel_both, cancel_new, cancel_old Enables Retail Price Improvement (RPI) mode.
RPI orders use post-only behavior by design. An RPI order does not support ioc=true.
The API returns error code 37 when a request sets both rpi=true and ioc=true.
RPI orders do not appear in public order book feeds (depth, bookTicker). RPI orders are visible only in private active orders and in the exchange UI order book (web/mobile).
RPI executions may apply custom fees or rebates, especially when trading via sub-accounts. Use Query Market Fee / Query All Market Fees to verify effective fees.
Refer to Order Parameter Rules for unsupported parameter combinations.
true
Order created successfully
Order ID
Custom client order ID; empty string if not specified
Deal market
Order side
Order type
Timestamp of order creation
If order finished - amount in money currency that is finished
If order finished - amount in stock currency that is finished
Amount
If order not finished - rest of the amount that must be finished
Fee in money currency when order is filled
Price
PostOnly flag
IOC flag
Order status
Self trade prevention mode
Position side (for collateral orders)
Indicates Retail Price Improvement (RPI) mode for the order.
true