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

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 must be JSON encoded and precisely the same as the JSON payload used to construct the signature:

Parameter	Description	Required
`book`	The book to use.	Yes
`major`	The amount of the major currency for this order. You must specify an order in either `major` or `minor`, never both.	No
`minor`	The amount of the minor currency for this order. You must specify an order in terms of either `major` or `minor`, never both.	No
`origin_id`	The order's client-supplied, unique ID. Valid character set: `a` to `z` (lower and uppercase), `0` to `9`, and underscore, `_`. The dash character, `-`, is not allowed.	No
`price`	The price per unit of major. Use this parameter only with Limit Orders.	No
`side`	The order's side. Valid values: `buy` and `sell`.	Yes
`stop`	The price per unit of major at which to stop and place the order. Use this parameter only with Stop Orders.	No
`time_in_force`	The period a limit order remains active before it is executed or expires. Valid values: `goodtillcancelled`, `fillorkill`, `immediateorcancel`, and `postonly`.	No
`type`	The order's type. Valid values: `market` and `limit`.	Yes

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"
    }
}