---
title: "Get events (by NFT)"
method: GET
path: "/api/v2/events/chain/{chain}/contract/{address}/nfts/{identifier}"
tags: ["Analytics Endpoints"]
---

# Get events (by NFT)

`GET /api/v2/events/chain/{chain}/contract/{address}/nfts/{identifier}`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/events/chain/{chain}/contract/{address}/nfts/{identifier}`
- 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)

Get a list of events for a specific NFT.

## Path parameters

- `chain` 'base' | 'ethereum' | 'zora' | 'arbitrum' | 'sei' | 'avalanche' | 'polygon' | 'optimism' | 'ape_chain' | 'flow' | 'soneium' | 'ronin' | 'bera_chain' | 'solana' | 'shape' | 'unichain' | 'gunzilla' | 'abstract' | 'animechain' | 'hyperevm' | 'somnia' | 'monad' | 'hyperliquid' | 'megaeth' | 'ink' | 'robinhood' | 'stablechain', required: Blockchain chain identifier. Use the chain slug (e.g., 'ethereum', 'polygon', 'arbitrum', 'optimism', 'base')
- `address` string, required
- `identifier` string, required

## Query parameters

- `after` integer
- `before` integer
- `event_type` string[]
- `limit` integer: Number of items to return per page
- `next` string

## Response `200`

OK

- AssetEventsResponse
  - `asset_events` union[], required
    - union
      - OrderEvent
        - `asset` Nft
          - `collection` string, required
          - `contract` string, required
          - `decimals` integer, nullable
          - `description` string, nullable
          - `display_animation_url` string, nullable
          - `display_image_url` string, nullable
          - `estimated_value_usd` number, double, nullable
          - `identifier` string, required
          - `image_url` string, nullable
          - `is_disabled` boolean, required
          - `is_nsfw` boolean, required
          - `metadata_url` string, nullable
          - `name` string, nullable
          - `opensea_url` string, required
          - `original_animation_url` string, nullable
          - `original_image_url` string, nullable
          - `token_standard` string, required
          - `traits` Trait[], required
            - `display_type` string, nullable
            - `max_value` string, nullable
            - `trait_type` string, required
            - `value` unknown, required
          - `updated_at` string, required
        - `chain` string, required
        - `criteria` Criteria
          - `collection` CollectionInner
            - `slug` string, required
          - `contract` ContractInner
            - `address` string, required
          - `encoded_token_ids` string, nullable
          - `numeric_traits` NumericTraitData[], nullable
            - `max` number, float, nullable
            - `min` number, float, nullable
            - `type` string, required
          - `traits` TraitData[], nullable
            - `type` string, required
            - `value` string, required
        - `event_timestamp` integer, required
        - `event_type` string, required
        - `expiration_date` integer, nullable
        - `is_private_listing` boolean, required
        - `maker` string, required
        - `order_hash` string
        - `order_type` string, required
        - `payment` Payment
          - `decimals` integer, required
          - `quantity` string, required
          - `symbol` string, required
          - `token_address` string, required
        - `protocol_address` string
        - `quantity` integer, required
        - `start_date` integer, nullable
        - `taker` string, nullable
        - `transaction` string
      - SaleEvent
        - `buyer` string, required
        - `chain` string, required
        - `closing_date` integer, required
        - `event_timestamp` integer, required
        - `event_type` string, required
        - `nft` Nft
          - `collection` string, required
          - `contract` string, required
          - `decimals` integer, nullable
          - `description` string, nullable
          - `display_animation_url` string, nullable
          - `display_image_url` string, nullable
          - `estimated_value_usd` number, double, nullable
          - `identifier` string, required
          - `image_url` string, nullable
          - `is_disabled` boolean, required
          - `is_nsfw` boolean, required
          - `metadata_url` string, nullable
          - `name` string, nullable
          - `opensea_url` string, required
          - `original_animation_url` string, nullable
          - `original_image_url` string, nullable
          - `token_standard` string, required
          - `traits` Trait[], required
            - `display_type` string, nullable
            - `max_value` string, nullable
            - `trait_type` string, required
            - `value` unknown, required
          - `updated_at` string, required
        - `order_hash` string
        - `payment` Payment
          - `decimals` integer, required
          - `quantity` string, required
          - `symbol` string, required
          - `token_address` string, required
        - `protocol_address` string
        - `quantity` integer, required
        - `seller` string, required
        - `transaction` string
      - TransferEvent
        - `chain` string, required
        - `event_timestamp` integer, required
        - `event_type` string, required
        - `from_address` string, required
        - `nft` Nft
          - `collection` string, required
          - `contract` string, required
          - `decimals` integer, nullable
          - `description` string, nullable
          - `display_animation_url` string, nullable
          - `display_image_url` string, nullable
          - `estimated_value_usd` number, double, nullable
          - `identifier` string, required
          - `image_url` string, nullable
          - `is_disabled` boolean, required
          - `is_nsfw` boolean, required
          - `metadata_url` string, nullable
          - `name` string, nullable
          - `opensea_url` string, required
          - `original_animation_url` string, nullable
          - `original_image_url` string, nullable
          - `token_standard` string, required
          - `traits` Trait[], required
            - `display_type` string, nullable
            - `max_value` string, nullable
            - `trait_type` string, required
            - `value` unknown, required
          - `updated_at` string, required
        - `order_hash` string
        - `payment` Payment
          - `decimals` integer, required
          - `quantity` string, required
          - `symbol` string, required
          - `token_address` string, required
        - `protocol_address` string
        - `quantity` integer, required
        - `to_address` string, required
        - `transaction` string
        - `transfer_type` string, required
  - `next` string, nullable

## Other responses

- `400`: For error reasons, review the response data.
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Resource not found
- `409`: Conflict
- `500`: Internal server error. Please open a support ticket so OpenSea can investigate.

## Changes

- **2026-11-03** `2c7935d84f90`: 37 breaking, 35 warning, 10 info
  - removed the enum value `b3` from the `path` request parameter `chain`
  - removed the enum value `blast` from the `path` request parameter `chain`
  - the response property `asset_events/items/oneOf[#/components/schemas/OrderEvent]/allOf[subschema #2]/expiration_date` became nullable for the status `200`
  - the response property `asset_events/items/oneOf[#/components/schemas/OrderEvent]/allOf[subschema #2]/start_date` became nullable for the status `200`
  - …78 more

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/events/chain/:chain/contract/:address/nfts/:identifier/get.md)

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) - [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opensea/apis/opensea-api/revisions/2c7935d84f90?raw)