v1

latestOpenAPI 3.0.32026-07-14101828.2 KB
Trade

/trade/orders

Submit a new order for execution.

post/api/v1/trade/orders

Request body

signaturestring required

The signature of the request, encoded from the signedFields

clientOrderIdstring

The client-defined unique identifier of this order used for lookup. This should always be unique; however, the server will not gurantee this or impose any checks.

type'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'LIQUIDATION' | 'STOP_LOSS_MARKET' | 'TAKE_PROFIT_MARKET' | 'STOP_LOSS_LIMIT' | 'TAKE_PROFIT_LIMIT' | 'BANKRUPTCY_LIQUIDATION' | 'UNSPECIFIED' required

The type of order. (BANKRUPTCY_LIQUIDATION is deprecated)

reduceOnlyboolean required

Is this order to only reduce a position? Default false

postOnlyboolean

If set to TRUE, the order can only be a maker order

timeInForce'GTT' | 'IOC' | 'FOK' | 'UNSPECIFIED'

The time-in-force policy for the order. By default, all orders are GTT. UNSPECIFIED is set to default.

GTT: Good Til Time

IOC: Immediate Or Cancel

FOK: Fill Or Kill

triggerPriceE9string

Trigger price in base e9 for stop orders. This should always be a number

selfTradePreventionType'TAKER' | 'MAKER' | 'BOTH' | 'UNSPECIFIED'

The strategy used to resolve self trades.

TAKER: On a self trade, the taker order will be cancelled

MAKER: On a self trade, the maker order will be cancelled

BOTH: On a self trade, both the taker and the maker order will be cancelled

UNSPECIFIED: set to default value

Example request

{
  "signedFields": {
    "salt": "123335432",
    "idsId": "ids_id",
    "expiresAtMillis": 12345665432,
    "signedAtMillis": 1234567856
  }
}

Response

Order creation successful.

orderHashstring required

The unique identifier of this order, to be used as a lookup key

All 10 operations