Skip to main content
GET
/
accounts
/
{account_id}
/
ledger
Get a single account's ledger
curl --request GET \
  --url https://api.exchange.coinbase.com/accounts/{account_id}/ledger \
  --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-06-11T22:11:56.382Z",
    "id": "1444415179",
    "amount": "3.2200000000000000",
    "balance": "3.2200000000000000",
    "type": "transfer",
    "details": {
      "to": "6d326768-71f2-4068-99dc-7075c78f6402",
      "from": "20640810-6219-4d3b-95f4-5e1741dd6ea4",
      "profile_transfer_id": "1f854356-4923-4b10-8db1-d82f7fae8eda"
    }
  }
]
CautionIf 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.

​
API Key Permissions

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

​
Entry Types

Entry type indicates the reason for the account change.
TypeDescription
transferFunds moved to/from Coinbase to Coinbase Exchange
matchFunds moved as a result of a trade
feeFee as a result of a trade
rebateFee rebate as per our fee schedule
conversionFunds converted between fiat currency and a stablecoin

​
Details

If an entry is the result of a trade (match, fee), the details field contains additional information about the trade.

​
Pagination

Items are paginated and sorted latest first. See Pagination for retrieving additional entries after the first page.

​
Searching By Date

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:
  • RFC3339 (i.e., 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.

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

Path Parameters

​
account_id
string
required

Returns list of ledger entries from this account id.

Query Parameters

​
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.

​
before
string

Used for pagination. Sets start cursor to before id.

​
after
string

Used for pagination. Sets end cursor to after id.

​
limit
integer<int64>
default:100

Limit on number of results to return.

​
profile_id
string

Response

​
id
string
required
​
amount
string
required
​
created_at
string<date-time>
required
​
balance
string
required
​
type
enum<string>
default:transfer
required
Available options:
transfer,
match,
fee,
conversion,
margin_interest,
rebate,
otc_fee,
otc_match,
tax_credit,
rfq_match,
rfq_fee,
match_conversion,
stake_wrap,
conversion_fee,
redeem
​
details
object
required