Account Endpoints

Get items favorited by an account

Changed on Nov 3, 2026

Get a paginated list of items favorited by a wallet address. Requires wallet identity authentication; the requested address must belong to the authenticated account.

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

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/favorites/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

addressstring required

The wallet address

Query parameters

afterstring

Cursor for pagination

limitinteger

Number of results to return

sort_by'CREATED_DATE' | 'PRICE' | 'RARITY' | 'LISTING_CREATED_DATE' | 'LAST_SALE'

Sort by field

sort_direction'asc' | 'desc'

Sort direction

chainsChainIdentifier[]

Filter by chains

[
  "ethereum"
]

Response

Favorited items

nextstring nullable

Changes

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

Operation history