Create Limit Order
This endpoint creates limit trading order.
Error Codes
Error Codes
30- default validation error code31- market validation failed32- amount validation failed33- price validation failed36- clientOrderId validation failed37- ioc and postOnly flags are both true
Errors
Errors
{
"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."]
}
}
Authorizations
API Key authentication for private endpoints.
Required headers:
- X-TXC-APIKEY: Your API key
- X-TXC-PAYLOAD: Base64 encoded JSON payload
- X-TXC-SIGNATURE: HMAC SHA512 signature
Body
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.
An immediate or cancel order (IOC) is an order that attempts to execute all or part immediately and then cancels any unfilled portion of the order. Variables: 'true' / 'false' Example: 'false'.
When you activate the BBO option when placing Limit orders, the system automatically selects the best market prices for executing these orders in one of two ways. Variables: 1 - Queue Method / 2 - Counterparty Method. You can use 2 method with ioc flag. Example: 2.
1, 2 Self trade prevention mode. Variables: 'no' / 'cancel_both' / 'cancel_new' / 'cancel_old'. Example: 'no'.
no, cancel_both, cancel_new, cancel_old Retail Price Improvement (RPI) order: Order type designed to offer better prices to retail users. It is post-only and can match only with orders from the Web or Mobile App. RPI orders can be placed only by the designated Market Makers. Example: true
true
Response
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 that you pay if order is finished
Price
PostOnly flag
IOC flag
Order status
Self trade prevention mode
Position side (for collateral orders)
RPI order flag - indicates whether Retail Price Improvement was enabled for this order
true