v1

latestOpenAPI 3.1.02026-07-24130315342.2 KB
Token Endpoints

Get token balances by account

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.

get/api/v2/account/{address}/tokens

Path parameters

addressstring required

Wallet address

Query parameters

limitinteger

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

chainsChainIdentifier[]

Filter by blockchain(s)

[
  "ethereum"
]
sort_by'USD_VALUE' | 'MARKET_CAP' | 'ONE_DAY_VOLUME' | 'PRICE' | 'ONE_DAY_PRICE_CHANGE' | 'SEVEN_DAY_PRICE_CHANGE'

Sort field (default: usd_value)

sort_direction'asc' | 'desc'

Sort direction (default: desc)

disable_spam_filteringboolean

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.

cursorstring

Pagination cursor for next page

Response

OK