How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

OpenSea NFT Endpoints API

NFT endpoints to retrieve individual NFTs, metadata, ownership, and rarity

OpenSea NFT Endpoints API is one of 17 APIs that OpenSea publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include NFT Endpoints. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 11 paths, and defines 27 schemas. It is described by OpenAPI 3.1.0, at version 2.0.0.

Requests are made against a single base URL, https://api.opensea.io.

11 operations 11 paths 27 schemas 7 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0.0
Base URL
https://api.opensea.io/api/v2
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

OpenSea NFT Endpoints API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key required for authentication

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 7 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

NFT Endpoints 11

NFT endpoints to retrieve individual NFTs, metadata, ownership, and rarity

POST
/api/v2/nfts/batch
Get NFTs by identifiers
get_nfts_batch body → 200400500
POST
/api/v2/chain/{chain}/contract/{address}/nfts/{identifier}/validate-metadata
Validate NFT metadata
validate_nft_metadata 4 params → 200400404500
POST
/api/v2/chain/{chain}/contract/{address}/nfts/{identifier}/refresh
Refresh NFT metadata
refresh_nft_metadata 4 params → 200400404500
POST
/api/v2/assets/transfer
Transfer NFTs or tokens between wallets
transfer_assets body → 200400500
GET
/api/v2/metadata/{chain}/{contractAddress}/{tokenId}
Get NFT metadata
get_nft_metadata 3 params → 200400404500
GET
/api/v2/collection/{slug}/nfts
Get NFTs by collection
get_nfts_by_collection 5 params → 200400404500
GET
/api/v2/chain/{chain}/contract/{address}/nfts
Get NFTs by contract
get_nfts_by_contract 4 params → 200400500
GET
/api/v2/chain/{chain}/contract/{address}/nfts/{identifier}
Get NFT
get_nft 3 params → 200400404500
GET
/api/v2/chain/{chain}/contract/{address}/nfts/{identifier}/owners
Get NFT owners
get_nft_owners 5 params → 200400404500
GET
/api/v2/chain/{chain}/contract/{address}/nfts/{identifier}/analytics
Get NFT analytics
get_nft_analytics 3 params → 200400404500
GET
/api/v2/chain/{chain}/account/{address}/nfts
Get NFTs by account
get_nfts_by_account 5 params → 200400404500

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are NftDetailed (24 properties), Nft (17 properties), ValidateMetadataDetails (9 properties), AssetMetadataResponse (6 properties). Each schema is shown below with its type and property counts.

AgentNftResponse
object
3 properties 3 required
NftSalePointResponse
object
A sale data point for an NFT
5 properties 4 required
Trait
object
4 properties 2 required
ValidateMetadataAssetIdentifier
object
3 properties 3 required
Rarity
object
3 properties 2 required
AgentBindingResponse
object
4 properties 3 required
ValidateMetadataResponse
object
4 properties 1 required
NftAnalyticsResponse
object
Analytics data for an NFT including sales and floor price history
2 properties 2 required
OwnersPaginatedResponse
object
2 properties 1 required
NftDetailed
object
24 properties 12 required
NftIdentifierInput
object
An NFT identifier consisting of chain, contract address, and token ID
3 properties 3 required
AssetMetadataResponse
object
6 properties 1 required
TransferRequest
object
Request to transfer NFTs or tokens between wallets
3 properties 3 required
NftResponse
object
1 property 1 required
ValidateMetadataAttribute
object
3 properties 2 required
NftBatchResponse
object
1 property 1 required
NftListResponse
object
2 properties 1 required
JsonNode
TransferResponse
object
Response containing ordered blockchain actions to execute for an asset transfer
1 property 1 required
Nft
object
17 properties 9 required
ValidateMetadataDetails
object
9 properties 1 required
TransferAsset
object
An asset to transfer
4 properties 4 required
BatchNftsRequest
object
Request body for batch NFT retrieval by identifiers
1 property 1 required
MetadataIngestionError
object
4 properties 2 required
FloorPricePointResponse
object
A floor price data point
5 properties 1 required
SubscriptionInfoResponse
object
3 properties 2 required
Owner
object
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opensea-nft-endpoints-api-openapi.yml Raw ↑

Other APIs OpenSea publishes across the network.

OpenSea Stream API
OpenSea Account Endpoints API
OpenSea Analytics Endpoints API
OpenSea Auth Endpoints API
OpenSea Chain Endpoints API
OpenSea Collection Endpoints API
OpenSea Contract Endpoints API
OpenSea Drops Endpoints API
OpenSea Listing Endpoints API
OpenSea Offer Endpoints API
OpenSea Order Endpoints API
OpenSea Search Endpoints API
Where this information came from

This is an independent, third-party profile of OpenSea NFT Endpoints API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.