List Orders

Response Body

object

• data array of objects required
  data object

  • id string uuid required
    Unique identifier for the order. Used to reference the order in other endpoints.
  • accountId string required
    The ID of the account
  • enterpriseId string required
  • initiatedByUserId string required
  • canceledByUserId string required
  • clientOrderId string required
    Custom order ID provided by the client. This must be a unique ID for each individual order and cannot be the same across multiple requests. Can be used to ensure idempotency of order requests.

    up to 256 characters

  • time string date-time required
  • creationDate string date-time required
  • scheduledDate string date-time required
    Date to schedule the order. If not provided, the order will be placed immediately.
  • lastFillDate string date-time required
  • completionDate string date-time required
  • settleDate string date-time required
  • fundingType string enum required

    The funding type of the order.

    • Funded orders will be placed using the Go account balance.
    • Margin orders will be placed using the margin account balances. See our Trade Guide for more details on each funding type.

    Defaults to funded

    marginfunded
  • type string enum required
    The type of order to be placed. See our Trade Guide for more details on each order type.
    markettwaplimitsteady_pacestop
  • timeInForce string enum required

    Time in force policy for the order.

    • GTC (Good Till Cancelled): Order remains active until filled or cancelled.
    • IOC (Immediate or Cancel): Order fills as much as possible immediately, any unfilled remainder is cancelled.
    • FOK (Fill or Kill): The entire order must be filled immediately or it is cancelled completely. Unlike IOC, no partial fills are accepted.
    • GTD (Good Till Date): Order remains active until filled, cancelled, or the specified duration expires. Requires duration to be set.
    GTCIOCFOKGTD
  • status string enum required
    pending_openopencompletedpending_cancelcancelederrorscheduled
  • reason string enum required
    Reason for order cancellation. 'internalError' indicates an error occurred within the server while processing the order, resulting in an order cancellation. 'insufficientFunds' indicates that the order was cancelled due to shortage of funds to complete the transaction.
    internalErrorinsufficientFunds
  • reasonDescription string required
  • product string required
    Product name e.g. BTC-USD (base-quote)
  • side string enum required
    The side of the order
    buysell
  • quantity string decimal required
    The specified quantity.
  • quantityCurrency string required
    The specified quantity currency.
  • filledQuantity string decimal required
    The total base quantity filled.
  • filledQuoteQuantity string decimal required
    The total quote quantity filled.
  • leavesQuantity string decimal required

    For orders created with base currency, this field is set to the remaining unfilled base quantity.

    • Only one of leavesQuantity or leavesQuoteQuantity will be set.
    • This field is set to null for orders created with quote currency.
  • leavesQuoteQuantity string decimal required

    For orders created with quote currency, this field is set to the remaining unfilled quote quantity.

    • Only one of leavesQuantity or leavesQuoteQuantity will be set.
    • This field is set to null for orders created with base currency.
  • averagePrice string decimal required
    The average price for the order's trades.
  • limitPrice string decimal required

    The limit price. It always refers to the quote currency.

    • It's maximum precision is determined by the product's quoteDisplayPrecision field, which can be fetched from the list products endpoint.
  • triggerPrice string decimal

    The trigger price for stop orders. When the market reaches this price, the stop order is activated.

    • For buy stop-limit orders, triggerPrice must be less than or equal to limitPrice.
    • For sell stop-limit orders, triggerPrice must be greater than or equal to limitPrice.
    • It always refers to the quote currency.
  • duration integer required
    Duration of the order in minutes.
  • twapInterval integer required
    Interval length of the TWAP order in minutes.
  • rtId string required
    The request tracking ID associated with the order.
  • parameters object
    parameters object

    • isTimeSliced boolean

      The isTimeSliced field when provided determines the order's time slicing behavior:

      • If isTimeSliced is set to true, the order will be executed using a time-sliced strategy.
      • If isTimeSliced is set to false, the order will be executed using a regular TWAP strategy without time slicing.
      • If isTimeSliced is not specified, the default behavior uses a regular TWAP strategy without time slicing.
    • boundsControl string enum

      The boundsControl field when provided determines how strictly the TWAP order adheres to its target fill progression. This parameter only applies to regular TWAP orders. It is not supported for TimeSliced orders and will be ignored if provided.

      • narrow - within 3% or 3 minutes
      • standard - within 5% or 5 minutes
      • wide - within 7.5% or 7.5 minutes
      • If boundsControl is not specified, the default behavior is standard.
      narrowstandardwide
    • interval integer required
      The interval for the SteadyPace order, specified in conjunction with the interval unit.
    • intervalUnit string enum required
      The unit of time for the interval. Defaults to "minute".
      secondminutehour
    • subOrderSize string decimal required
      The size of each sub-order in the SteadyPace order.
    • variance string decimal
      Optional degree of randomization for sub-order sizes. Accepts a decimal value rounded to two decimal places between 0 and 1, representing the variation in the size of each sub-order. For example, a value of 0.20 indicates a 20% variance in sub-order sizes.
  • notes string required
    Additional notes associated with the order.

Response Body

object

• error string required
• errorName string required
• reqId string required
• context object
  Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
  context object

  • errorName string required
    Same value as the top-level errorName.
  • field string
    Request field associated with the validation failure.
  • message string
    Human-readable field-level validation message.

Response Body

object

• error string required
• errorName string required
• reqId string required
• context object
  Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
  context object

  • errorName string required
    Same value as the top-level errorName.
  • field string
    Request field associated with the validation failure.
  • message string
    Human-readable field-level validation message.

Response Body

object

• error string required
• errorName string required
• reqId string required
• context object
  Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
  context object

  • errorName string required
    Same value as the top-level errorName.
  • field string
    Request field associated with the validation failure.
  • message string
    Human-readable field-level validation message.