Account Endpoints

Get offers received by an account

Changed on Nov 3, 2026

Get a paginated list of offers received on items owned by a wallet address.

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

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

collection_slugsstring[]

Filter by collection slugs

chainsChainIdentifier[]

Filter by chains

[
  "ethereum"
]

sort_by'START_TIME' | 'TOP_ASSET_OFFER'

Sort by field

sort_direction'asc' | 'desc'

Sort direction

Response

Offers received for account

nextstring nullable

Example response

{
  "offers": [
    {
      "svm_order": {
        "id": "5j7s1QzqC8sT4Kz1oB9dYnUZ4qHnKX6h9YmZ6Zt7Zb3Q:CvhyBLWDcNwMatkNvMYuHALvbG1NzYrGw32dGzREaQKc"
      }
    }
  ]
}

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's property type changed from object to no type for status
- breaking
  the /// response's property type changed from object to no type for status
- breaking
  removed the required property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with the status
- warning
  removed the optional property //// from the response with 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 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
- 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 subschema #2 to the /// response property anyOf list for the response status
- info
  added subschema #2 to the /// response property anyOf list for the response status

Operation history