Account Endpoints

Add a watchlist entry

Add an NFT, token, collection, or perpetual to the authenticated account's watchlist.

post/api/v2/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: write:favorites)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/watchlist/post.ts
A function with typed inputs. Its response is checked against the schema.

chainstring nullable

Blockchain chain slug

contract_addressstring nullable

Contract address

idstring nullable

Perpetual ID

slugstring nullable

Collection slug

token_idstring nullable

Token ID

type'ITEM' | 'TOKEN' | 'COLLECTION' | 'PERPETUAL' required

Watchlist entity type

{
  "chain": "ethereum"
}

Watchlist entry added

successboolean required

Whether the operation succeeded