Skip to main content
Accounts

List account holdings

Returns the current holdings (positions) snapshot for an investment- category financial account. Holdings are replaced on every sync, so the list reflects the user's current portfolio — not history.

GET
/finance/accounts/{accountId}/holdings

Only SnapTrade-fed accounts (crypto / brokerage) populate holdings; bank-fed accounts will always return an empty list.

Filter by symbol, asset_class, currency, or integrator. Sort by symbol, market_value, quantity, synced_at, created_at, or id. Default sort is largest-by-market-value first.

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

accountIdintegerrequired

The financial account ID

page[size]integerquerydefault:25

The number of results that will be returned per page.

page[number]integerquery

The page number to start the pagination from.

filter[symbol]stringquery
filter[asset_class]stringquery
filter[currency]stringquery
filter[integrator]stringquery
sortenum<string>[]querydefault:["-market_value","-id"]

Response

application/json

Paginated set of AccountHoldingResource

dataobject[]required
metaobjectrequired