Get events (by NFT)

Changed on Nov 3, 2026

Get a list of events for a specific NFT.

get/api/v2/events/chain/{chain}/contract/{address}/nfts/{identifier}

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/events/chain/:chain/contract/:address/nfts/:identifier/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')

Example:ethereum

The blockchain on which to filter the results

addressstring required

The unique public blockchain identifier for the contract

identifierstring required

The NFT token id

Query parameters

afterinteger

Only show events after this timestamp (Unix timestamp in seconds)

beforeinteger

Only show events before this timestamp (Unix timestamp in seconds)

event_typestring[]

Filter by event types. To get order invalidation and revalidation events, please use the Stream API. The order status can also be checked on the Get Order endpoint.

limitinteger

Number of items to return per page

Example:20

nextstring

Response

nextstring nullable

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  removed the enum value b3 from the path request parameter chain
- breaking
  removed the enum value blast from the path request parameter chain
- 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'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
  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
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the status
- breaking
  removed the required property //////// from the response with the 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
- 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
- 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
- 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
- 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
- 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 new enum value stablechain to the path request parameter chain
- 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
- 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
- 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