Account Endpoints

Get tokens watched by an account

Changed on Nov 3, 2026

Get the tokens watched by the authenticated account. Requires wallet identity authentication; the requested address must belong to the authenticated account.

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

Request

Base URL
https://api.opensea.io
Auth
API key in header x-api-key and OpenID Connect (https://auth.opensea.io/.well-known/openid-configuration, scopes: read:favorites)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/account/:address/token_watchlist/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

addressstring required

The wallet address

Response

Watched tokens

nextstring nullable

Cursor for the next page of results

Example response

{
  "tokens": [
    {
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "chain": "ethereum",
      "decimals": 6,
      "name": "USDC",
      "symbol": "USDC",
      "usd_price": "1.0"
    }
  ]
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- 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
- 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 media type */* for the response with the status
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status

Operation history