GET
/
api
/
v3
/
brokerage
/
orders
/
historical
/
fills
List Fills
curl --request GET \
  --url https://api.coinbase.com/api/v3/brokerage/orders/historical/fills \
  --header 'Authorization: Bearer <token>'
{
  "fills": [
    {
      "entry_id": "22222-2222222-22222222",
      "trade_id": "1111-11111-111111",
      "order_id": "0000-000000-000000",
      "trade_time": "2021-05-31T09:59:59.000Z",
      "trade_type": "FILL",
      "price": "10000.00",
      "size": "0.001",
      "commission": "1.25",
      "product_id": "BTC-USD",
      "sequence_timestamp": "2021-05-31T09:58:59.000Z",
      "liquidity_indicator": "UNKNOWN_LIQUIDITY_INDICATOR",
      "size_in_quote": false,
      "user_id": "3333-333333-3333333",
      "side": "BUY",
      "retail_portfolio_id": "4444-444444-4444444",
      "fillSource": "FILL_SOURCE_UNKNOWN",
      "commission_detail_total": {
        "total_commission": "<string>",
        "gst_commission": "<string>",
        "withholding_commission": "<string>",
        "client_commission": "<string>"
      }
    }
  ],
  "cursor": "789100"
}

Authorizations

Authorization
string
header
required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Creating API Keys section of our Coinbase App Authentication docs for information on how to generate your Bearer Token.

Query Parameters

order_ids
string[]

The ID(s) of order(s).

trade_ids
string[]

The ID(s) of the trades of fills.

product_ids
string[]

The ID(s) of the product(s) to filter fills by.

start_sequence_timestamp
string<RFC3339 Timestamp>

Only fills with a trade time after the specified start date are returned.

end_sequence_timestamp
string<RFC3339 Timestamp>

Only fills with a trade time before the specified end date are returned.

retail_portfolio_id
string

(Deprecated) Only fills matching this retail portfolio id are returned. Only applicable for legacy keys. CDP keys will default to the key's permissioned portfolio.

limit
integer

The number of fills to be returned (default is 100).

cursor
string

For paginated responses, returns all responses that come after this value.

sort_by
enum<string>
default:UNKNOWN_SORT_BY

Sort results by a field, results use unstable pagination. Default is sort by creation time

Available options:
UNKNOWN_SORT_BY,
PRICE,
TRADE_TIME
asset_filters
string[]

Only returns the fills where the quote, base or underlying asset matches the provided asset filter(s) (e.g. 'BTC').

Response

200
application/json

A successful response.

The response is of type object.