Sign in
Order

Place an order for trading

post/v1/order

Request body

signaturestring hex required

Hex-encoded EIP-712 signature authorizing this request

Example request

{
  "data": {
    "clientOrderId": "16e2da4d-58ab-4453-bdb4-8e4a865c12c1",
    "expiresAt": 1712623600,
    "onchainId": 1,
    "quantity": "5.5",
    "sender": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "stopPrice": "4200.5",
    "subaccount": "0x7072696d61727900000000000000000000000000000000000000000000000000"
  }
}

Response

clientOrderIdstring

Client-provided order id (if supplied in request)

filledstring decimal required

Quantity filled expressed as a decimal string (precision: 9)

Deprecated: This value is always zero when block execution is enabled.

idstring uuid required

Id representing the order

result'Ok' | 'AccountSuspended' | 'CausesImmediateLiquidation' | 'DuplicateSameSideOco' | 'ExchangeSuspended' | 'ImmediateMatchPostOnly' | 'InsufficientBalance' | 'LiquidationError' | 'MarketOrderReachedMaxSlippage' | 'MaxQuantityExceeded' | 'OcoFilled' | 'OpenValueCapExceeded' | 'OrderIncreasesPosition' | 'RiskLimitExceeded' | 'SignerRevoked' | 'TriggerCanceledError' | 'UnfilledFillOrKill' | 'UnfilledImmediateOrCancel' | 'UnfilledMarketOrder' | 'MakerCanceledByTaker' | 'CloseOrder' | 'Unknown' required

Result codes for orders that were created (may still have been rejected)

Example response

{
  "filled": "0",
  "id": "9036443a-441a-4a66-87f2-bd5c44cdca7a",
  "result": "Ok"
}

Changes

Changed in 1 of the 2 revisions of this API.2

  • 63e8937ff6f72See the full diff
    • ●

      added the new CloseOrder enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new MakerCanceledByTaker enum value to the response property for the response status

      response-property-enum-value-added