Retrieve a Single Order by ID — Coinbase Advanced Trade

GET /api/v3/brokerage/orders/historical/ — fetch full details of a single order by its ID, including fill status and execution price.

The Get Order endpoint retrieves the complete details of a single order by its Coinbase-assigned order ID. This includes the order’s current status, how much has been filled, the average execution price, fees incurred, and the original order configuration. You can use this endpoint to monitor in-flight orders, confirm order completion, or retrieve execution details for bookkeeping and reconciliation.

Endpoint

GET https://api.coinbase.com/api/v3/brokerage/orders/historical/{order_id}

Authentication

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

Authorization: Bearer $JWT

Path Parameters

order_id · string · required

The Coinbase-assigned unique identifier for the order to retrieve (e.g., d4e5f6a7-b8c9-0123-def0-234567890123). Order IDs are returned in the response from Create Order and List Orders.

Response Fields

order · object

The full order object for the requested ID.

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).

user_id · string

The user ID of the account that placed the order.

order_configuration · object

The original order configuration submitted at creation — for example, limit_limit_gtc with base_size and limit_price.

side · string

Order direction: BUY or SELL.

client_order_id · string

The client-supplied ID provided when the order was created.

status · string

Current order status. One of OPEN, FILLED, or CANCELLED.

created_time · string

ISO 8601 timestamp of when the order was created (e.g., "2024-01-20T10:15:00Z").

completion_percentage · string

Percentage of the order quantity that has been filled, as a string from "0" to "100".

filled_size · string

The total amount of base currency filled across all executions so far.

average_filled_price · string

The volume-weighted average price at which the order has been filled. Empty string if no fills yet.

number_of_fills · string

The number of individual fill events that have occurred for this order.

filled_value · string

The total value of all fills in quote currency (e.g., USD equivalent filled).

pending_cancel · boolean

Whether a cancellation request is currently pending for this order.

size_in_quote · boolean

Whether the order size was specified in quote currency rather than base currency.

total_fees · string

Total trading fees charged for this order across all fills.

total_value_after_fees · string

The net value of the order after fees have been deducted (in quote currency).

Examples

cURL

curl -H "Authorization: Bearer $JWT" \
  'https://api.coinbase.com/api/v3/brokerage/orders/historical/d4e5f6a7-b8c9-0123-def0-234567890123'

Example Response — Filled Limit Sell

{
  "order": {
    "order_id": "d4e5f6a7-b8c9-0123-def0-234567890123",
    "product_id": "BTC-USD",
    "user_id": "user-abc123def456",
    "order_configuration": {
      "limit_limit_gtc": {
        "base_size": "0.01",
        "limit_price": "50000",
        "post_only": false
      }
    },
    "side": "SELL",
    "client_order_id": "22222222-2222-2222-2222-222222222222",
    "status": "FILLED",
    "created_time": "2024-01-20T10:15:00Z",
    "completion_percentage": "100",
    "filled_size": "0.01",
    "average_filled_price": "50000.00",
    "number_of_fills": "1",
    "filled_value": "500.00",
    "pending_cancel": false,
    "size_in_quote": false,
    "total_fees": "1.25",
    "total_value_after_fees": "498.75"
  }
}