v1

latestOpenAPI 3.0.02026-08-04134348905.1 KB
Trading

Place an order

Permissions required: Execute trades

Place an order, either Market or Limit, currently only FillOrKill is supported.

One of accountId or subaccountId must be specified but not both.

post/trading/order

Request body

accountIdstring

Account ID for this order to book into.

clOrderIdstring required

Unique client order ID.

currencystring required

The currency in which order quantity is specified in.

limitPricestring

Limit price for the order, required for limit order

orderType'MARKET' | 'LIMIT' | 'RFQ' | 'LIMIT_ALL_IN' required

Order type either MARKET or LIMIT

quantitystring required

Order quantity in units of currency.

side'BUY' | 'SELL' required

Order side, either "BUY" or "SELL".

subaccountIdstring

Subaccount ID for this order to book into.

symbolstring required

Symbol for the order, e.g. BTC-USD.

timestampstring date-time required

Timestamp when submitting this order. Date-times are always in UTC RFC 3339 'date-time'.

Example request

{
  "accountId": "0e2b2f9d-8d10-4f1e-960b-28567255045f",
  "allocation": [
    {
      "quantity": "10000"
    }
  ],
  "clOrderId": "6fb5fc79-0bb4-446d-82dd-d4687fb56a02",
  "currency": "BTC",
  "limitPrice": "21005.5",
  "quantity": "100.00",
  "subaccountId": "343b6c83-6d91-4f13-9982-2109abd2dbb0",
  "symbol": "BTC-USD"
}

Response

Successfully executed an order

Example response

{
  "data": {
    "accountId": "0e2b2f9d-8d10-4f1e-960b-28567255045f",
    "allocation": [
      {
        "counterQtyAllIn": "10000",
        "counterQtyAllInToSettle": "10000",
        "cumQty": "10000",
        "executionId": "6290d9bd-494f-11ed-975e-2e567b4c0e09",
        "fee": "10000",
        "quantity": "10000",
        "subaccountId": "905272f0-52f9-404e-b6cd-ad879e671790"
      }
    ],
    "avgPx": "21005.4",
    "avgPxAllIn": "21006.00",
    "clOrderId": "6fb5fc79-0bb4-446d-82dd-d4687fb56a02",
    "counterCurrency": "BTC",
    "counterQty": "0.001",
    "counterQtyAllIn": "0.0012",
    "cumQty": "10000.00",
    "currency": "USD",
    "execId": "3fb532c79-0bb4-446d-82dd-d4687fb56a02",
    "fee": "10.0",
    "feeCurrency": "BTC",
    "limitPrice": "21005.5",
    "orderId": "a94c8d75-6c9d-4903-95f3-5b0893e76cb7",
    "orderQty": "10000.00",
    "subaccountId": "0e2b2f9d-8d10-4f1e-960b-28567255045f",
    "subaccountTransactionId": "af2b2f9d-9d1a-4e2e-76ab-2756725dffdf",
    "symbol": "BTC-USD"
  }
}