Skip to content
Alchemy Logo

getTokenAccounts

POST
/{apiKey}
CUs160Throughput CUs200

Returns token accounts based on the specified filters. At least one of ownerAddress or mintAddress is required.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

stringrequired

The owner (wallet) address whose token accounts you want to list. Either ownerAddress or mintAddress must be provided; ownerAddress is the common case (passing a wallet pubkey, getting back its token holdings).

stringoptional

The mint address to filter token accounts by. Pass this INSTEAD OF ownerAddress when you want to list every token account for a given mint, or alongside ownerAddress to narrow a wallet's holdings to a specific mint. Leave empty if you only want results scoped by owner.

integeroptionaldefaults to 1

The page of results to return (1-indexed). Use either page-based pagination (page) or cursor-based pagination (cursor/before/after), not both.

integeroptionaldefaults to 100

The maximum number of token accounts to retrieve.

stringoptional

Cursor for pagination. Returned in the previous response.

stringoptional

Returns results before the specified cursor.

stringoptional

Returns results after the specified cursor.

objectoptional

Optional response shaping flags. The server also accepts displayOptions as an alias of this field, but only one of options or displayOptions may be present per request.

Responses

200

Returns token accounts matching the specified criteria.

Was this page helpful?