Skip to main content
GET
/
fills
Get all 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
​
product_id
string
​
limit
integer
default:100
​
before
string
​
after
string
​
market_type
enum<string>
default:spot
Available options:
spot,
rfq
​
start_date
string
​
end_date
string

Response

​
trade_id
integer
required
​
product_id
string
required
​
order_id
string
required
​
user_id
string
required
​
profile_id
string
required
​
liquidity
enum<string>
default:M
required
Available options:
M,
T,
O
​
price
string
required
​
size
string
required
​
fee
string
required
​
created_at
string<date-time>
required
​
side
enum<string>
default:buy
required
Available options:
buy,
sell
​
settled
boolean
required
​
usd_volume
string
required
​
funding_currency
string
required
​
market_type
string