Get token balances by account

get

https://api.opensea.io/api/v2/account/{address}/tokens

Get fungible token balances for a specific wallet address. Returns quantity (in display units, not raw/wei), USD value, and token metadata for each token held.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

address

string

required

Wallet address

Query Params

limit

int32

Defaults to 20

Number of results to return (default: 20, max: 100)

chains

array of objects

Filter by blockchain(s)

chains

sort_by

string

enum

Sort field (default: usd_value)

Allowed:

sort_direction

string

enum

Sort direction (default: desc)

Allowed:

disable_spam_filtering

boolean

Defaults to false

When true, disables OpenSea's heuristic spam filtering and returns tokens that would normally be hidden (low liquidity, dust, flagged-as-spam, etc.). Tokens flagged for trust & safety enforcement or as malicious are still filtered out regardless. Surfaced tokens carry a status field on the response indicating why they would have been filtered.

cursor

string

Pagination cursor for next page

Responses

400

For error reasons, review the response data.

500

Internal server error. Please open a support ticket so OpenSea can investigate.

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

*/*

200OK

401Unauthorized

404Not Found

409Conflict