GET /api/v3/brokerage/orders/historical/batch — List Orders

GET /api/v3/brokerage/orders/historical/batch — retrieve a filtered list of your historical and open orders with pagination support.

The List Orders endpoint returns a paginated list of your orders across all products. You can filter by product, status, type, direction, and date range to narrow results to exactly the orders you need. Both open and historical (filled, cancelled) orders are accessible through this endpoint, making it useful for building trade history views, reconciliation workflows, or monitoring open positions.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/orders/historical/batch

Authentication

This endpoint requires a valid JWT Bearer token passed in the Authorization header:

Authorization: Bearer $JWT

Query Parameters

product_id · string

Filter results to orders for a specific trading pair (e.g., BTC-USD). If omitted, orders for all products are returned.

order_status · string

Filter by order status. Accepted values:

• OPEN — orders that are live on the book
• FILLED — orders that have been fully executed
• CANCELLED — orders that were cancelled before being filled

You may pass this parameter multiple times to include multiple statuses (e.g., ?order_status=OPEN&order_status=FILLED).

order_type · string

Filter by order type. Accepted values: MARKET, LIMIT, STOP_LIMIT.

order_side · string

Filter by order direction. Accepted values: BUY, SELL.

start_date · string

ISO 8601 timestamp. Only orders created at or after this time are returned (e.g., 2024-01-01T00:00:00Z).

end_date · string

ISO 8601 timestamp. Only orders created before or at this time are returned (e.g., 2024-01-31T23:59:59Z).

limit · integer

Maximum number of orders to return per page. Defaults to 100. Maximum value is 1000.

cursor · string

Pagination cursor from a previous response. Pass this value to retrieve the next page of results.

Response Fields

orders · array

List of order objects matching the applied filters.

Show Order object fields

order_id · string

The Coinbase-assigned unique identifier for the order.

product_id · string

The trading pair the order was placed on (e.g., BTC-USD).

side · string

Order direction: BUY or SELL.

status · string

Current order status: OPEN, FILLED, or CANCELLED.

order_type · string

The type of order: MARKET, LIMIT, or STOP_LIMIT.

client_order_id · string

The client-supplied ID provided at order creation.

created_time · string

ISO 8601 timestamp of when the order was placed.

completion_percentage · string

Percentage of the order that has been filled, as a string (e.g., "100" for fully filled).

filled_size · string

The amount of base currency that has been filled so far.

average_filled_price · string

The average execution price across all fills for this order.

total_fees · string

Total trading fees charged for this order.

order_configuration · object

The original order configuration submitted at creation (e.g., limit price, base size).

has_next · boolean

Indicates whether additional pages of results are available.

cursor · string

Pagination cursor to use in the next request. Empty string when no further pages exist.

Examples

cURL — Open BTC-USD Orders

curl -H "Authorization: Bearer $JWT" \
  'https://api.coinbase.com/api/v3/brokerage/orders/historical/batch?product_id=BTC-USD&order_status=OPEN'

Example Response

{
  "orders": [
    {
      "order_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
      "product_id": "BTC-USD",
      "side": "SELL",
      "status": "OPEN",
      "order_type": "LIMIT",
      "client_order_id": "22222222-2222-2222-2222-222222222222",
      "created_time": "2024-01-20T10:15:00Z",
      "completion_percentage": "0",
      "filled_size": "0",
      "average_filled_price": "0",
      "total_fees": "0",
      "order_configuration": {
        "limit_limit_gtc": {
          "base_size": "0.01",
          "limit_price": "50000",
          "post_only": false
        }
      }
    }
  ],
  "has_next": false,
  "cursor": ""
}