OpenSea website screenshot

OpenSea

OpenSea is the world's largest NFT marketplace, offering a REST API for querying NFT collections, listings, offers, orders, and events, and for managing programmatic NFT trading across 27+ blockchain chains including Ethereum, Polygon, Base, Solana, Arbitrum, and more.

OpenSea publishes 11 APIs on the APIs.io network, including NFT API, Collection API, Listing API, and 8 more. Tagged areas include NFT, Marketplace, Web3, Blockchain, and Trading.

The OpenSea catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

OpenSea’s developer surface includes authentication, CLI, support, engineering blog, and 13 more developer resources.

50.7/100 developing ▼ -7.9 Agent 35/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
12 APIs
NFTMarketplaceWeb3BlockchainTradingDigital Assets

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 50.7/100 · developing
Contract Quality 12.1 / 25
Developer Ergonomics 6.1 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 6.2 / 13
Governance 7.0 / 12
Discoverability 7.4 / 10
Agent readiness — 35/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 8 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/opensea: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 12

Individual APIs this provider publishes, each with its own machine-readable definition.

OpenSea NFT API

Retrieve individual NFT metadata, ownership, rarity, analytics, and owners across supported blockchain chains. Supports batch NFT retrieval, metadata refresh, validation, and co...

OpenSea Collection API

Query NFT collection details, traits, floor prices, holders, offer aggregates, trending and top collections. Supports batch retrieval by slugs and discovery of new and popular c...

OpenSea Listing API

Create, fulfill, and query NFT listings on OpenSea. Supports best listing retrieval per collection or NFT, cross-chain fulfillment, and collection sweep purchases with automatic...

OpenSea Offer API

Build, create, fulfill, and query NFT offers and bids on OpenSea. Supports collection-wide offers, trait-based offers, item-specific bids, and best-offer retrieval per NFT.

OpenSea Order API

Look up and cancel individual orders by chain, protocol address, and order hash. Supports both Seaport listing and offer orders.

OpenSea Events API

Retrieve historical NFT marketplace events including sales, transfers, mints, and cancellations by account, collection, or individual NFT. Also supports real-time event streamin...

OpenSea Token API

Retrieve fungible token details, balances, holders, liquidity pools, price history, OHLCV candlestick data, trending tokens, and swap quotes for token trading across supported c...

OpenSea Account API

Retrieve OpenSea account profiles, resolve ENS/usernames, and access portfolio analytics including net worth history, P&L tracking, owned collections, favorites, listings, and o...

OpenSea Drops API

Discover NFT drops, check mint eligibility, build mint transactions, deploy NFT contracts, and track transaction receipts for minting operations.

OpenSea Search API

Search across OpenSea collections, NFTs, tokens, and accounts by keyword. Powers discovery of assets and creators across the OpenSea marketplace.

OpenSea Stream API

Real-time WebSocket event streaming for NFT marketplace activity per collection, including item listed, item sold, item transferred, item metadata updates, item cancelled, item ...

OpenSea Swap API

Get swap quotes and execute token trading with executable transaction data across supported blockchain chains.

Scroll for all 12

Pricing Plans 1

Published pricing tiers and plan structures.

Opensea Plans

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Opensea Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Opensea Context

0 classes · 0 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

OpenSea API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 220

Standalone JSON Schema definitions for this provider's data models.

AccountResolveResponse

3 properties

JSON SCHEMA

AccountResponse

8 properties

JSON SCHEMA

AccountSearchResponse

4 properties

JSON SCHEMA

AdditionalRecipient

5 properties

JSON SCHEMA

Address

2 properties

JSON SCHEMA

AdvancedOrder

8 properties

JSON SCHEMA

AgentBindingResponse

4 properties

JSON SCHEMA

AgentNftResponse

3 properties

JSON SCHEMA

AssetEventsResponse

2 properties

JSON SCHEMA

AssetIdentifierResponse

3 properties

JSON SCHEMA

AssetMetadataResponse

6 properties

JSON SCHEMA

AssetQuantityInput

4 properties

JSON SCHEMA

AssetReceiptResponse

3 properties

JSON SCHEMA

BasicOrderParameters

21 properties

JSON SCHEMA

BatchCollectionsRequest

1 properties

JSON SCHEMA

BatchNftsRequest

1 properties

JSON SCHEMA

BatchTokensRequest

1 properties

JSON SCHEMA

BidderResponse

2 properties

JSON SCHEMA

BuildOfferRequest

5 properties

JSON SCHEMA

BuildOfferResponse

3 properties

JSON SCHEMA

CancelRequest

1 properties

JSON SCHEMA

CancelResponse

1 properties

JSON SCHEMA

ChainIdentifier

0 properties

JSON SCHEMA

ChainListResponse

1 properties

JSON SCHEMA

ChainResponse

6 properties

JSON SCHEMA

CollectionBatchResponse

1 properties

JSON SCHEMA

CollectionCriteria

1 properties

JSON SCHEMA

CollectionDetailedResponse

28 properties

JSON SCHEMA

CollectionHolderResponse

3 properties

JSON SCHEMA

CollectionHoldersPaginatedResponse

2 properties

JSON SCHEMA

CollectionInner

1 properties

JSON SCHEMA

CollectionObject

1 properties

JSON SCHEMA

CollectionOfferAggregateResponse

4 properties

JSON SCHEMA

CollectionPaginatedResponse

2 properties

JSON SCHEMA

CollectionRarity

5 properties

JSON SCHEMA

CollectionResponse

20 properties

JSON SCHEMA

CollectionSearchResponse

6 properties

JSON SCHEMA

CollectionStatsResponse

2 properties

JSON SCHEMA

Consideration

6 properties

JSON SCHEMA

ConsiderationItem

6 properties

JSON SCHEMA

ConsiderationObject

2 properties

JSON SCHEMA

Contract

2 properties

JSON SCHEMA

ContractCriteria

1 properties

JSON SCHEMA

ContractInner

1 properties

JSON SCHEMA

ContractResponse

5 properties

JSON SCHEMA

CreateListingActionsRequest

4 properties

JSON SCHEMA

CreateListingActionsResponse

1 properties

JSON SCHEMA

Criteria

5 properties

JSON SCHEMA

CriteriaObject

4 properties

JSON SCHEMA

CriteriaRequest

5 properties

JSON SCHEMA

CriteriaResolver

8 properties

JSON SCHEMA

CrossChainFulfillmentRequest

4 properties

JSON SCHEMA

CrossChainFulfillmentResponse

1 properties

JSON SCHEMA

CrossChainPaymentToken

2 properties

JSON SCHEMA

DropDeployReceiptResponse

4 properties

JSON SCHEMA

DropDeployRequest

6 properties

JSON SCHEMA

DropDeployResponse

4 properties

JSON SCHEMA

DropDetailedResponse

13 properties

JSON SCHEMA

DropMintRequest

2 properties

JSON SCHEMA

DropMintResponse

4 properties

JSON SCHEMA

DropPaginatedResponse

2 properties

JSON SCHEMA

DropResponse

10 properties

JSON SCHEMA

DropStageResponse

8 properties

JSON SCHEMA

Eip3009Fields

9 properties

JSON SCHEMA

Event

0 properties

JSON SCHEMA

EventBase

7 properties

JSON SCHEMA

Fee

3 properties

JSON SCHEMA

FloorPriceHistoryResponse

1 properties

JSON SCHEMA

FloorPricePointResponse

5 properties

JSON SCHEMA

FulfillAdvancedOrder

0 properties

JSON SCHEMA

FulfillAvailableAdvancedOrders

0 properties

JSON SCHEMA

FulfillAvailableOrders

0 properties

JSON SCHEMA

FulfillBasicOrder

0 properties

JSON SCHEMA

FulfillListingResponse

2 properties

JSON SCHEMA

FulfillOrder

0 properties

JSON SCHEMA

FulfillerObject

1 properties

JSON SCHEMA

Fulfillment

5 properties

JSON SCHEMA

FulfillmentComponent

5 properties

JSON SCHEMA

FulfillmentData

2 properties

JSON SCHEMA

FullfillListingRequest

6 properties

JSON SCHEMA

FullfillmentDataRequest

5 properties

JSON SCHEMA

GetOrderResponse

1 properties

JSON SCHEMA

InstantApiKeyResponse

5 properties

JSON SCHEMA

IntervalStat

3 properties

JSON SCHEMA

Item

5 properties

JSON SCHEMA

JsonNode

0 properties

JSON SCHEMA

Listing

0 properties

JSON SCHEMA

ListingItem

7 properties

JSON SCHEMA

ListingObject

3 properties

JSON SCHEMA

ListingOrOffer

0 properties

JSON SCHEMA

ListingPrice

1 properties

JSON SCHEMA

ListingsResponse

2 properties

JSON SCHEMA

MatchAdvancedOrders

0 properties

JSON SCHEMA

MatchOrders

0 properties

JSON SCHEMA

MetadataIngestionError

4 properties

JSON SCHEMA

Nft

17 properties

JSON SCHEMA

NftAnalyticsResponse

2 properties

JSON SCHEMA

NftBatchResponse

1 properties

JSON SCHEMA

NftDetailed

24 properties

JSON SCHEMA

NftIdentifierInput

3 properties

JSON SCHEMA

NftListResponse

2 properties

JSON SCHEMA

NftResponse

1 properties

JSON SCHEMA

NftSalePointResponse

5 properties

JSON SCHEMA

NftSearchResponse

6 properties

JSON SCHEMA

NumericTraitCriteria

3 properties

JSON SCHEMA

NumericTraitData

3 properties

JSON SCHEMA

Offer

0 properties

JSON SCHEMA

OfferAggregatePriceResponse

4 properties

JSON SCHEMA

OfferItem

5 properties

JSON SCHEMA

OfferObject

3 properties

JSON SCHEMA

OfferWithCriteriaRequest

3 properties

JSON SCHEMA

OffersResponse

2 properties

JSON SCHEMA

OhlcvCandleResponse

6 properties

JSON SCHEMA

OhlcvResponse

1 properties

JSON SCHEMA

Order

7 properties

JSON SCHEMA

OrderAsset

2 properties

JSON SCHEMA

OrderData

2 properties

JSON SCHEMA

OrderEvent

0 properties

JSON SCHEMA

OrderParameters

14 properties

JSON SCHEMA

Owner

3 properties

JSON SCHEMA

OwnersPaginatedResponse

2 properties

JSON SCHEMA

Parameters

12 properties

JSON SCHEMA

PartialParameters

3 properties

JSON SCHEMA

Payment

4 properties

JSON SCHEMA

PaymentToken

8 properties

JSON SCHEMA

PortfolioHistoryDataPoint

4 properties

JSON SCHEMA

PortfolioHistoryResponse

2 properties

JSON SCHEMA

PortfolioStatsResponse

6 properties

JSON SCHEMA

Price

3 properties

JSON SCHEMA

PriceHistoryPointResponse

2 properties

JSON SCHEMA

PriceHistoryResponse

1 properties

JSON SCHEMA

PriceResponse

3 properties

JSON SCHEMA

PricingCurrencies

2 properties

JSON SCHEMA

ProfileCollectionResponse

23 properties

JSON SCHEMA

ProfileCollectionsResponse

2 properties

JSON SCHEMA

ProtocolData

2 properties

JSON SCHEMA

Rarity

3 properties

JSON SCHEMA

RateLimitsResponse

3 properties

JSON SCHEMA

RegisteredToolResponse

21 properties

JSON SCHEMA

SaleEvent

0 properties

JSON SCHEMA

SeaportCall

0 properties

JSON SCHEMA

SeaportParameters

12 properties

JSON SCHEMA

SeaportProtocolDataModel

2 properties

JSON SCHEMA

SeaportRequest

3 properties

JSON SCHEMA

SearchResponse

1 properties

JSON SCHEMA

SearchResultResponse

5 properties

JSON SCHEMA

SocialMediaAccount

2 properties

JSON SCHEMA

SubscriptionInfoResponse

3 properties

JSON SCHEMA

SwapAssetInput

3 properties

JSON SCHEMA

SwapCostResponse

2 properties

JSON SCHEMA

SwapExecuteRequest

5 properties

JSON SCHEMA

SwapExecuteResponse

2 properties

JSON SCHEMA

SwapPriceImpact

2 properties

JSON SCHEMA

SwapQuoteDetails

10 properties

JSON SCHEMA

SwapQuoteInput

2 properties

JSON SCHEMA

SwapQuoteResponse

2 properties

JSON SCHEMA

SwapRouteErrorResponse

1 properties

JSON SCHEMA

SwapTransactionResponse

4 properties

JSON SCHEMA

SweepCollectionRequest

6 properties

JSON SCHEMA

SweepCollectionResponse

2 properties

JSON SCHEMA

SweepError

1 properties

JSON SCHEMA

TokenAmountResponse

5 properties

JSON SCHEMA

TokenBalancePaginatedResponse

2 properties

JSON SCHEMA

TokenBalanceResponse

13 properties

JSON SCHEMA

TokenBaseResponse

8 properties

JSON SCHEMA

TokenBatchResponse

1 properties

JSON SCHEMA

TokenContractInput

2 properties

JSON SCHEMA

TokenDetailedResponse

12 properties

JSON SCHEMA

TokenGroupCurrencyResponse

7 properties

JSON SCHEMA

TokenGroupPaginatedResponse

2 properties

JSON SCHEMA

TokenGroupResponse

12 properties

JSON SCHEMA

TokenGroupRollingStatsResponse

6 properties

JSON SCHEMA

TokenGroupSocialsResponse

6 properties

JSON SCHEMA

TokenGroupStatsResponse

7 properties

JSON SCHEMA

TokenHolderDistributionResponse

4 properties

JSON SCHEMA

TokenHolderResponse

5 properties

JSON SCHEMA

TokenHoldersResponse

4 properties

JSON SCHEMA

TokenLiquidityPoolResponse

10 properties

JSON SCHEMA

TokenLiquidityPoolsResponse

2 properties

JSON SCHEMA

TokenPaginatedResponse

2 properties

JSON SCHEMA

TokenResponse

11 properties

JSON SCHEMA

TokenSearchResponse

8 properties

JSON SCHEMA

TokenSocialsResponse

4 properties

JSON SCHEMA

TokenStatsResponse

10 properties

JSON SCHEMA

TokenSwapActivityPaginatedResponse

2 properties

JSON SCHEMA

TokenSwapActivityResponse

9 properties

JSON SCHEMA

ToolAccessResponse

3 properties

JSON SCHEMA

ToolCollectionResponse

5 properties

JSON SCHEMA

ToolListItemResponse

12 properties

JSON SCHEMA

ToolListPaginatedResponse

2 properties

JSON SCHEMA

ToolPaymentStatsResponse

5 properties

JSON SCHEMA

ToolPricingRecipientResponse

6 properties

JSON SCHEMA

ToolRequirementResponse

11 properties

JSON SCHEMA

ToolSearchPaginatedResponse

2 properties

JSON SCHEMA

ToolSearchResultResponse

14 properties

JSON SCHEMA

ToolUsageRequest

7 properties

JSON SCHEMA

ToolUsageResponse

3 properties

JSON SCHEMA

Total

5 properties

JSON SCHEMA

TotalSpentResponse

1 properties

JSON SCHEMA

Trait

4 properties

JSON SCHEMA

TraitCriteria

2 properties

JSON SCHEMA

TraitData

2 properties

JSON SCHEMA

TraitObject

2 properties

JSON SCHEMA

TransactionData

5 properties

JSON SCHEMA

TransactionIdentifierInput

3 properties

JSON SCHEMA

TransactionReceiptRequest

4 properties

JSON SCHEMA

TransactionReceiptResponse

7 properties

JSON SCHEMA

TransferAsset

4 properties

JSON SCHEMA

TransferEvent

0 properties

JSON SCHEMA

TransferRequest

3 properties

JSON SCHEMA

TransferResponse

1 properties

JSON SCHEMA

Type

2 properties

JSON SCHEMA

Uint256

3 properties

JSON SCHEMA

V1ErrorWrapper

1 properties

JSON SCHEMA

ValidateMetadataAssetIdentifier

3 properties

JSON SCHEMA

ValidateMetadataAttribute

3 properties

JSON SCHEMA

ValidateMetadataDetails

9 properties

JSON SCHEMA

ValidateMetadataResponse

4 properties

JSON SCHEMA

X402SettlementFields

3 properties

JSON SCHEMA

Scroll for all 220

Examples 83

Example request and response payloads for these APIs.

Build_Offer_V2

5 fields

EXAMPLE

Cancel_Order

5 fields

EXAMPLE

Create_Instant_Api_Key

5 fields

EXAMPLE

Create_Listing_Actions

5 fields

EXAMPLE

Deploy_Drop_Contract

5 fields

EXAMPLE

Get_Account

5 fields

EXAMPLE

Get_Best_Listing_Nft

5 fields

EXAMPLE

Get_Best_Offer_Nft

5 fields

EXAMPLE

Get_Chains

5 fields

EXAMPLE

Get_Collection

5 fields

EXAMPLE

Get_Collection_Holders

5 fields

EXAMPLE

Get_Collection_Stats

5 fields

EXAMPLE

Get_Collection_Traits

5 fields

EXAMPLE

Get_Collections_Batch

5 fields

EXAMPLE

Get_Contract

5 fields

EXAMPLE

Get_Drop_By_Slug

5 fields

EXAMPLE

Get_Drops

5 fields

EXAMPLE

Get_Nft

5 fields

EXAMPLE

Get_Nft_Analytics

5 fields

EXAMPLE

Get_Nft_Collection

5 fields

EXAMPLE

Get_Nft_Metadata

5 fields

EXAMPLE

Get_Nft_Owners

5 fields

EXAMPLE

Get_Nfts_Batch

5 fields

EXAMPLE

Get_Nfts_By_Account

5 fields

EXAMPLE

Get_Nfts_By_Collection

5 fields

EXAMPLE

Get_Nfts_By_Contract

5 fields

EXAMPLE

Get_Offers_Collection

5 fields

EXAMPLE

Get_Offers_Nft

5 fields

EXAMPLE

Get_Order

5 fields

EXAMPLE

Get_Payment_Token

5 fields

EXAMPLE

Get_Portfolio_History

5 fields

EXAMPLE

Get_Portfolio_Stats

5 fields

EXAMPLE

Get_Profile_Collections

5 fields

EXAMPLE

Get_Profile_Favorites

5 fields

EXAMPLE

Get_Profile_Listings

5 fields

EXAMPLE

Get_Profile_Offers

5 fields

EXAMPLE

Get_Swap_Quote

5 fields

EXAMPLE

Get_Token

5 fields

EXAMPLE

Get_Token_Activity

5 fields

EXAMPLE

Get_Token_Group

5 fields

EXAMPLE

Get_Token_Groups

5 fields

EXAMPLE

Get_Token_Holders

5 fields

EXAMPLE

Get_Token_Liquidity_Pools

5 fields

EXAMPLE

Get_Token_Ohlcv

5 fields

EXAMPLE

Get_Token_Price_History

5 fields

EXAMPLE

Get_Tokens_Batch

5 fields

EXAMPLE

Get_Tool

5 fields

EXAMPLE

Get_Top_Collections

5 fields

EXAMPLE

Get_Top_Tokens

5 fields

EXAMPLE

Get_Transaction_Receipt

5 fields

EXAMPLE

Get_Trending_Collections

5 fields

EXAMPLE

Get_Trending_Tokens

5 fields

EXAMPLE

List_Collections

5 fields

EXAMPLE

List_Events

5 fields

EXAMPLE

List_Events_By_Account

5 fields

EXAMPLE

List_Events_By_Collection

5 fields

EXAMPLE

List_Events_By_Nft

5 fields

EXAMPLE

List_Tools

5 fields

EXAMPLE

Post_Criteria_Offer_V2

5 fields

EXAMPLE

Post_Listing

5 fields

EXAMPLE

Post_Offer

5 fields

EXAMPLE

Post_Swap_Execute

5 fields

EXAMPLE

Refresh_Nft_Metadata

5 fields

EXAMPLE

Report_Tool_Usage

5 fields

EXAMPLE

Resolve_Account

5 fields

EXAMPLE

Search

5 fields

EXAMPLE

Search_Tools

5 fields

EXAMPLE

Sweep_Collection

5 fields

EXAMPLE

Transfer_Assets

5 fields

EXAMPLE

Validate_Nft_Metadata

5 fields

EXAMPLE

Scroll for all 83

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Opensea Authentication

apiKey · 1 scheme

SECURITY

Opensea Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Opensea Vulnerability Disclosure

Bugcrowd · security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Opensea Agentic Access

83 operations · 22 acting

83 operations · 22 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Build 2

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 4

Pricing, plans, and the legal terms of use

Company 1

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: opensea
url: https://raw.githubusercontent.com/api-evangelist/opensea/refs/heads/main/apis.yml
name: OpenSea
kind: company
description: OpenSea is the world's largest NFT marketplace, offering a REST API for querying NFT collections, listings, offers,
  orders, and events, and for managing programmatic NFT trading across 27+ blockchain chains including Ethereum, Polygon,
  Base, Solana, Arbitrum, and more.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- NFT
- Marketplace
- Web3
- Blockchain
- Trading
- Digital Assets
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
apis:
- aid: opensea:nft-api
  name: OpenSea NFT API
  description: Retrieve individual NFT metadata, ownership, rarity, analytics, and owners across supported blockchain chains.
    Supports batch NFT retrieval, metadata refresh, validation, and collection-based listing.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - NFT
  - Metadata
  - Ownership
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:collection-api
  name: OpenSea Collection API
  description: Query NFT collection details, traits, floor prices, holders, offer aggregates, trending and top collections.
    Supports batch retrieval by slugs and discovery of new and popular collections.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Collections
  - Discovery
  - Floor Price
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:listing-api
  name: OpenSea Listing API
  description: Create, fulfill, and query NFT listings on OpenSea. Supports best listing retrieval per collection or NFT,
    cross-chain fulfillment, and collection sweep purchases with automatic substitution for unavailable items.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Listings
  - Marketplace
  - Trading
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:offer-api
  name: OpenSea Offer API
  description: Build, create, fulfill, and query NFT offers and bids on OpenSea. Supports collection-wide offers, trait-based
    offers, item-specific bids, and best-offer retrieval per NFT.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Offers
  - Bids
  - Marketplace
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:order-api
  name: OpenSea Order API
  description: Look up and cancel individual orders by chain, protocol address, and order hash. Supports both Seaport listing
    and offer orders.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Orders
  - Seaport
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:events-api
  name: OpenSea Events API
  description: Retrieve historical NFT marketplace events including sales, transfers, mints, and cancellations by account,
    collection, or individual NFT. Also supports real-time event streaming via the Stream API WebSocket.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Events
  - Analytics
  - History
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:token-api
  name: OpenSea Token API
  description: Retrieve fungible token details, balances, holders, liquidity pools, price history, OHLCV candlestick data,
    trending tokens, and swap quotes for token trading across supported chains.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Tokens
  - DeFi
  - Price
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:account-api
  name: OpenSea Account API
  description: Retrieve OpenSea account profiles, resolve ENS/usernames, and access portfolio analytics including net worth
    history, P&L tracking, owned collections, favorites, listings, and offers.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Accounts
  - Portfolio
  - Identity
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:drops-api
  name: OpenSea Drops API
  description: Discover NFT drops, check mint eligibility, build mint transactions, deploy NFT contracts, and track transaction
    receipts for minting operations.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Drops
  - Minting
  - Contracts
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:search-api
  name: OpenSea Search API
  description: Search across OpenSea collections, NFTs, tokens, and accounts by keyword. Powers discovery of assets and creators
    across the OpenSea marketplace.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Search
  - Discovery
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- aid: opensea:stream-api
  name: OpenSea Stream API
  description: Real-time WebSocket event streaming for NFT marketplace activity per collection, including item listed, item
    sold, item transferred, item metadata updates, item cancelled, item received offer, and item received bid events.
  humanURL: https://docs.opensea.io/reference/stream-js
  baseURL: wss://stream-api.opensea.io/socket
  tags:
  - WebSocket
  - Streaming
  - Real-time
  - Events
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/stream-js
  - type: SDKs
    url: https://github.com/ProjectOpenSea/stream-js
- aid: opensea:swap-api
  name: OpenSea Swap API
  description: Get swap quotes and execute token trading with executable transaction data across supported blockchain chains.
  humanURL: https://docs.opensea.io/reference/api-overview
  baseURL: https://api.opensea.io/api/v2
  tags:
  - Swap
  - DeFi
  - Trading
  properties:
  - type: Documentation
    url: https://docs.opensea.io/reference/api-overview
  - type: OpenAPI
    url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
common:
- type: AgentCard
  url: a2a/opensea-a2a.yml
  name: A2A Agent Card
  description: Agent Card served at /.well-known/agent-card.json (near-conformant against A2A 1.0.0).
- type: AgenticAccess
  url: agentic-access/opensea-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/opensea-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/opensea-domain-security.yml
- type: Authentication
  url: authentication/opensea-authentication.yml
- type: Authentication
  url: https://docs.opensea.io/reference/api-keys
- type: Plans
  url: plans/opensea-plans.yml
- type: RateLimits
  url: rate-limits/opensea-rate-limits.yml
- type: FinOps
  url: finops/opensea-finops.yml
- type: SDKs
  url: https://github.com/ProjectOpenSea/opensea-sdk
- type: CLI
  url: https://github.com/ProjectOpenSea/opensea-cli
- type: OpenAPI
  url: https://raw.githubusercontent.com/ProjectOpenSea/api-types/main/opensea-api.json
- type: TermsOfService
  url: https://opensea.io/tos
- type: PrivacyPolicy
  url: https://opensea.io/privacy
- type: StatusPage
  url: https://status.opensea.io
- type: Support
  url: https://support.opensea.io
- type: Blog
  url: https://opensea.io/blog
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com