Place an Order
The method POST /orders
enables you to place a buy or sell order. Both Limit and Market orders are available.
HTTP Request
Header Parameters
You must specify the following authorization parameters in your request:
Parameter | Description | Required |
---|---|---|
key | See the section, Authentication | Yes |
signature | See the section, Authentication | Yes |
nonce | See the section, Authentication | Yes |
Body Parameters
Body parameters must be JSON encoded and precisely the same as the JSON payload used to construct the signature:
Parameter | Description | Required |
---|---|---|
| The book to use. | Yes |
| The amount in the major currency for the order.
| No |
| The amount in the minor currency for the order.
| No |
| The order's client-supplied, unique ID (if any). Valid character set: | No |
| The price per unit of major. Use this parameter only with Limit Orders. The rounding algorithm considers only eight decimal places, rounding up to the nearest price when selling and down when buying. | No |
| The order's side. Valid values: | Yes |
| The price per unit of major at which to stop and place the order. Use this parameter only with Stop Orders. | No |
| The period a Limit Order remains active before it is executed or expires. Valid values: | No |
| The order's type. Valid values: | Yes |
| The maximum acceptable slippage for Market or Stop-Loss Orders, expressed as a percentage in decimal form (e.g., | No |
Order Rejected iforigin_id
Is Not UniqueThe
origin_id
parameter must uniquely identify each active order. If a new order placement request uses anorigin_id
already associated with an active order, the system rejects the request.
JSON Response Payload
The endpoint returns a JSON object representing the order. This object includes the following field:
Field Name | Description | Type |
---|---|---|
oid | The order's unique ID. | String |
The following response object exemplifies the JSON object returned:
{
"success": true,
"payload": {
"oid": "qlbga6b600n3xta7"
}
}
Updated about 15 hours ago