Lists ledger activity for an account. This includes anything that would affect the accounts balance - transfers, trades, fees, etc.
Caution
If neither start_date
nor end_date
is set, the endpoint will return ledger activity for the past 1 day only.
List account activity of the API key’s profile. Account activity either increases or decreases your account balance.
This endpoint requires either the “view” or “trade” permission.
Entry type indicates the reason for the account change.
Type | Description |
---|---|
transfer | Funds moved to/from Coinbase to Coinbase Exchange |
match | Funds moved as a result of a trade |
fee | Fee as a result of a trade |
rebate | Fee rebate as per our fee schedule |
conversion | Funds converted between fiat currency and a stablecoin |
If an entry is the result of a trade (match, fee), the details field contains additional information about the trade.
Items are paginated and sorted latest first. See Pagination for retrieving additional entries after the first page.
Searching by start and end dates are inclusive of the time provided and can be combined with before or after fields to narrow down the search to entries from a specific time range. Dates must be after Unix Epoch time and are restricted to the following formats:
2006-01-02T15:04:05.000000Z
or 2006-01-02T15:04:05+05:30
)2006-01-02
2006-01-02T15:04:05
A 400 Bad Request
error is returned for any formats that are not accepted.
Returns list of ledger entries from this account id.
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.
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.
Used for pagination. Sets start cursor to before
id.
Used for pagination. Sets end cursor to after
id.
Limit on number of results to return.
The response is of type object[]
.