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 Offer Endpoints API

Offer endpoints for building, creating, fulfilling, and querying offers

OpenSea Offer 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 Offer Endpoints. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 9 operations across 9 paths, and defines 58 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.

9 operations 9 paths 58 schemas 5 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 Offer 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 9

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

Offer Endpoints 9

Offer endpoints for building, creating, fulfilling, and querying offers

POST
/api/v2/orders/{chain}/{protocol}/offers
Create an item offer
post_offer 2 params body → 200400500
POST
/api/v2/offers
Create a criteria offer
post_criteria_offer_v2 body → 200400500
POST
/api/v2/offers/fulfillment_data
Fulfill an offer
generate_offer_fulfillment_data_v2 body → 200400500
POST
/api/v2/offers/build
Build a criteria offer
build_offer_v2 body → 200400500
GET
/api/v2/offers/collection/{slug}
Get offers by collection
get_offers_collection 3 params → 200400404500
GET
/api/v2/offers/collection/{slug}/traits
Get trait offers for a collection
get_offers_collection_trait 11 params → 200400404500
GET
/api/v2/offers/collection/{slug}/nfts/{identifier}
Get offers by NFT
get_offers_nft 4 params → 200400404500
GET
/api/v2/offers/collection/{slug}/nfts/{identifier}/best
Get best offer by NFT
get_best_offer_nft 2 params → 200400404500
GET
/api/v2/offers/collection/{slug}/all
Get all offers by collection
list_offers_collection_all 4 params → 200400404500

Schemas 58

The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are BasicOrderParameters (21 properties), OrderParameters (14 properties), Parameters (12 properties), SeaportParameters (12 properties). Each schema is shown below with its type and property counts.

FulfillerObject
object
1 property 1 required
BuildOfferResponse
object
3 properties 2 required
CollectionInner
object
1 property 1 required
Address
object
2 properties
CollectionCriteria
object
1 property 1 required
MatchAdvancedOrders
4 required
TraitCriteria
object
2 properties 2 required
MatchOrders
2 required
SeaportCall
AdvancedOrder
object
8 properties
TraitObject
object
2 properties 2 required
CollectionObject
object
1 property 1 required
ContractCriteria
object
1 property 1 required
BuildOfferRequest
object
5 properties 5 required
Fulfillment
object
5 properties
Parameters
object
12 properties 12 required
Consideration
object
6 properties 6 required
SeaportProtocolDataModel
object
2 properties 2 required
Uint256
object
3 properties
AdditionalRecipient
object
5 properties
FulfillmentComponent
object
5 properties
NumericTraitCriteria
object
3 properties 1 required
Item
object
5 properties 5 required
ListingOrOffer
OrderAsset
object
2 properties 1 required
CriteriaResolver
object
8 properties
NumericTraitData
object
3 properties 1 required
FulfillListingResponse
object
2 properties 2 required
FulfillmentData
object
2 properties 2 required
OfferItem
object
5 properties 5 required
Price
object
3 properties 3 required
TransactionData
object
5 properties 5 required
FulfillAvailableAdvancedOrders
7 required
Offer
5 required
Criteria
object
5 properties
FullfillmentDataRequest
object
5 properties 2 required
FulfillBasicOrder
1 required
SeaportRequest
object
3 properties 3 required
FulfillAdvancedOrder
4 required
TraitData
object
2 properties 2 required
CriteriaRequest
object
Criteria for collection or trait offers. When traits are specified, the offer targets NFTs matching those traits. For supported collections, the identifierOrCr…
5 properties 1 required
Order
object
7 properties 3 required
ConsiderationItem
object
6 properties 6 required
OfferWithCriteriaRequest
object
3 properties 3 required
ContractInner
object
1 property 1 required
CriteriaObject
object
4 properties 1 required
ProtocolData
object
2 properties 1 required
Type
object
2 properties
OrderParameters
object
14 properties
OffersResponse
object
2 properties 1 required
ConsiderationObject
object
2 properties 2 required
PartialParameters
object
3 properties 3 required
SeaportParameters
object
12 properties 11 required
OrderData
object
2 properties 2 required
FulfillAvailableOrders
5 required
FulfillOrder
2 required
OfferObject
object
3 properties 3 required
BasicOrderParameters
object
21 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

opensea-offer-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 NFT Endpoints API
OpenSea Order Endpoints API
OpenSea Search Endpoints API
Where this information came from

This is an independent, third-party profile of OpenSea Offer 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.