Offer Endpoints

Create a criteria offer

Changed on Nov 3, 2026

Create a criteria offer to purchase any NFT in a collection or which matches the specified trait. For trait offers where the Build Offer endpoint returns identifierOrCriteria '0', use that value directly — trait matching is validated server-side at fulfillment time rather than via onchain merkle proof.

post/api/v2/offers

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/offers/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

protocol_addressstring required

Response

Criteria offer created successfully

chainstring required

order_created_atinteger nullable

order_hashstring

Seaport order hash, a 0x-prefixed 32-byte value. Absent on an order that settles through a Solana marketplace program, which has no Seaport identity and carries svm_order instead. Every EVM order has one.

protocolstring

Marketplace protocol a Solana order settles through, which is what tells you which identity shape the order uses. Absent on a Seaport order, whose payload is unchanged. Only orders we can build fulfillment for carry a value here.

protocol_addressstring

remaining_quantityinteger required

status'ACTIVE' | 'INACTIVE' | 'FULFILLED' | 'EXPIRED' | 'CANCELLED' required

Example response

{
  "svm_order": {
    "id": "5j7s1QzqC8sT4Kz1oB9dYnUZ4qHnKX6h9YmZ6Zt7Zb3Q:CvhyBLWDcNwMatkNvMYuHALvbG1NzYrGw32dGzREaQKc"
  }
}

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the / request property type changed from object to no type
- breaking
  the / request property type changed from object to no type
- 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
  removed the required property // from the response with the status
- warning
  removed the request property //
- warning
  removed the request property //
- warning
  removed the request property //
- 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 subschema #2 to the / request property anyOf list
- info
  added subschema #2 to the / request property anyOf list
- info
  the request property / became nullable
- info
  the request property /// became nullable
- info
  the request property /// became nullable
- info
  the request property / became nullable
- 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 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 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

Operation history