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

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<int64>
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

​
trade_id
integer<int32>
required

id of trade that created the fill

​
product_id
string
required

book the order was placed on

​
order_id
string
required

uuid

​
user_id
string
required

id of user's account

​
profile_id
string
required

profile_id that placed the order

​
liquidity
enum<string>
default:M
required
Available options:
M,
T,
O
​
price
string
required

price per unit of base currency

​
size
string
required

amount of base currency to buy/sell

​
fee
string
required

fees paid on current filled amount

​
created_at
string<date-time>
required

timestamp of fill

​
side
enum<string>
default:buy
required
Available options:
buy,
sell
​
settled
boolean
required

true if funds have been exchanged and settled

​
usd_volume
string
required

true if funds have been exchanged and settled

​
funding_currency
string
required

funding currency which the order was filled in

​
market_type
string

market type which the order was filled in