GET
/
fills
curl --request GET \
  --url https://api.exchange.coinbase.com/fills \
  --header 'cb-access-key: <api-key>' \
  --header 'cb-access-passphrase: <api-key>' \
  --header 'cb-access-sign: <api-key>' \
  --header 'cb-access-timestamp: <api-key>'
[
  {
    "created_at": "2019-11-21T01:38:23.878Z",
    "trade_id": 78098253,
    "product_id": "BTC-USD",
    "order_id": "41473628-db2c-464e-b9f4-82df7e4fb4f4",
    "user_id": "5cf6e115aaf44503db300f1e",
    "profile_id": "8058d771-2d88-4f0f-ab6e-299c153d4308",
    "liquidity": "T",
    "price": "8087.38000000",
    "size": "0.00601800",
    "fee": "0.2433492642000000",
    "side": "sell",
    "settled": true,
    "usd_volume": "48.6698528400000000",
    "funding_currency": "USDC"
  }
]

Get a list of recent fills of the API key’s profile.

​
API Key Permissions

This endpoint requires either the “view” or “trade” permission.

​
Settlement and Fees

Fees are recorded in two stages. Immediately after the matching engine completes a match, the fill is inserted into our datastore. Once the fill is recorded, a settlement process settles the fill and credit both trading counterparties.

The fee field indicates the fees charged for this individual fill.

​
Liquidity

The liquidity field indicates if the fill was the result of a liquidity provider or liquidity taker. M indicates Maker and T indicates Taker.

​
Pagination

Fills are returned sorted by descending trade_id from the largest trade_id to the smallest trade_id. The CB-BEFORE header has this first trade ID so that future requests using the cb-before parameter fetch fills with a greater trade ID (newer fills).

See Pagination for more information.

Authorizations

​
cb-access-key
string
header
required
​
cb-access-passphrase
string
header
required
​
cb-access-sign
string
header
required
​
cb-access-timestamp
string
header
required

Query Parameters

​
order_id
string

limit to fills on a specific order. Either order_id or product_id is required.

​
product_id
string

limit to fills on a specific product. Either order_id or product_id is required.

​
limit
integer
default:100

Limit on number of results to return.

​
before
string

Used for pagination. Sets start cursor to before id.

​
after
string

Used for pagination. Sets end cursor to after id.

​
market_type
enum<string>
default:spot

Market type which the order was filled in.

Available options:
spot,
rfq
​
start_date
string

Search by minimum posted date time and is inclusive of time provided. Valid formats are either RFC3339, date or date time and must be after Unix Epoch time.

​
end_date
string

Search by maximum posted date time and is inclusive of time provided. Valid formats are either RFC3339, date or date time and must be after Unix Epoch time.

Response

200
application/json

The response is of type object[].