Orders

List Orders

Changed on

Lists all orders from the given trading account.

Requires access token scope: trade_view

get/api/prime/trading/v1/accounts/{accountId}/orders

Request

  • Base URL
    https://developers.bitgo.com
  • URL
    https://developers.bitgo.com/api/prime/trading/v1/accounts/{accountId}/orders
  • Auth
    none declared

Path parameters

accountIdstring required

The ID of the account

Query parameters

offsetinteger
limitinteger
clientOrderIdstring

The clientOrderId of the order to retrieve

dateGtestring date-time

Return client orders with a creationDate that is greater than or equal to the given timestamp

dateLtstring date-time

Return client orders with a creationDate that is less than the given timestamp

status'pending_open' | 'open' | 'completed' | 'pending_cancel' | 'canceled' | 'error' | 'scheduled'

Return client orders with an order status that is equal to the given string

type'market' | 'twap' | 'limit' | 'steady_pace' | 'stop' | 'rfq'

The type of order to be placed. See our Trade Guide for more details on each order type.

Filter by order type. Repeatable. Values match Order.type.

fundingType'margin' | 'funded'

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.

Filter by funding type. 'funded' for available balance, 'margin' for margin balance.

Response

An array of orders

Example response

{
  "data": [
    {
      "id": "67fd640c-cb6c-4218-80ae-49e79ec15646",
      "accountId": "60e740e7898f7d00064d43769a73dc48",
      "enterpriseId": "129841a2143f99c3229c1f4x590396b4",
      "initiatedByUserId": "1203c28030c4320a4b90255b4683ecq6",
      "canceledByUserId": null,
      "clientOrderId": "myorderid1",
      "time": "2025-11-25T23:12:18.210507Z",
      "creationDate": "2025-11-25T23:12:18.210507Z",
      "scheduledDate": null,
      "lastFillDate": "2025-11-25T23:12:17.642764Z",
      "completionDate": "2025-11-25T23:12:17.642764Z",
      "settleDate": null,
      "fundingType": "funded",
      "type": "market",
      "timeInForce": null,
      "status": "completed",
      "reason": null,
      "reasonDescription": null,
      "product": "BTC-USD",
      "side": "buy",
      "quantity": "1000",
      "quantityCurrency": "USD",
      "filledQuantity": "0.02457152",
      "filledQuoteQuantity": "1000",
      "leavesQuantity": null,
      "leavesQuoteQuantity": "0",
      "averagePrice": "40697.32",
      "limitPrice": null,
      "triggerPrice": null,
      "duration": null,
      "twapInterval": null,
      "rtId": null,
      "isFinanced": false,
      "notes": null
    }
  ]
}

Changes

  • df6644551827Revision changes
    • warning

      added the new rfq enum value to the // response property for the response status

    • info

      added the new enum value rfq to the query request parameter type

    • info

      added the optional property // to the response with the status

  • b3e9978eb1f7Revision changes
    • breaking

      removed the enum value rfq from the query request parameter type

    • info

      removed the rfq enum value from the // response property for the response status