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

Query Parameters

​
start_date
string
​
end_date
string
​
before
string
​
after
string
​
limit
integer
default:100
​
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