Token Endpoints

Get token balances by account

Changed on Nov 3, 2026

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

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/account/:address/tokens/get.ts
A function with typed inputs. Its response is checked against the schema.

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 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

nextstring nullable

Cursor for the next page of results

Example response

{
  "token_balances": [
    {
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "base_token_liquidity_usd": "125000.5",
      "chain": "ethereum",
      "decimals": 6,
      "name": "USDC",
      "quantity": "1.5",
      "quote_token_liquidity_usd": "125000.5",
      "symbol": "USDC",
      "usd_price": "1.0",
      "usd_value": "3518.51835185"
    }
  ]
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  removed the enum value MARKET_CAP from the query request parameter sort_by
- breaking
  removed the enum value ONE_DAY_PRICE_CHANGE from the query request parameter sort_by
- breaking
  removed the enum value ONE_DAY_VOLUME from the query request parameter sort_by
- breaking
  removed the enum value PRICE from the query request parameter sort_by
- breaking
  removed the enum value SEVEN_DAY_PRICE_CHANGE from the query request parameter sort_by
- breaking
  removed the enum value USD_VALUE from the query request parameter sort_by
- breaking
  removed the enum value b3 from the property items/ of the query request parameter chains
- breaking
  removed the enum value blast from the property items/ of the query request parameter chains
- breaking
  the response property became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- breaking
  the response property // became nullable for the status
- info
  added the new enum value market_cap to the query request parameter sort_by
- info
  added the new enum value one_day_price_change to the query request parameter sort_by
- info
  added the new enum value one_day_volume to the query request parameter sort_by
- info
  added the new enum value price to the query request parameter sort_by
- info
  added the new enum value seven_day_price_change to the query request parameter sort_by
- info
  added the new enum value usd_value to the query request parameter sort_by
- info
  added the enum value stablechain to the property items/ of the query request parameter chains
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history