This endpoint retrieves active offers on a specific NFT for the Seaport contract. Below is the detailed API reference for integrating this functionality into your Web3 applications.
Request Details
Endpoint
GET https://web3.okx.com/api/v5/mktplace/nft/markets/offers
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
chain | String | Yes | Supported blockchain (e.g., ETH, Polygon). View full list. |
collectionAddress | String | No | NFT contract address. |
tokenId | String | No | NFT token identifier. |
maker | String | No | Filter by maker’s wallet address. |
createAfter | String | No | Orders listed after this UNIX timestamp (seconds). |
createBefore | String | No | Orders listed before this UNIX timestamp (seconds). |
updateAfter | String | No | Orders updated after this UNIX timestamp (seconds). |
updateBefore | String | No | Orders updated before this UNIX timestamp (seconds). |
status | String | No | Order status: active, inactive, cancelled, sold. |
sort | String | No | Sorting options: create_time_desc, update_time_desc, price_desc, price_asc. Default: ascending. |
limit | String | No | Number of listings (default: 50). |
cursor | String | No | Pagination cursor. |
Response Format
Returns an array of OKX Order Models with the following fields:
| Parameter | Type | Description |
|---|---|---|
orderId | String | Unique order identifier. |
createTime | Long | Order creation timestamp. |
updateTime | Long | Last update timestamp. |
listingTime | Long | Listing timestamp. |
expirationTime | Long | Order expiry block timestamp. |
status | String | Order status (active, cancelled, etc.). |
orderHash | String | Cryptographic hash of the order. |
protocolData | String | Order parameters (JSON). |
protocolAddress | String | Contract address for order fulfillment. |
chain | String | Blockchain name. |
maker | String | Maker’s wallet address. |
orderType | String | Offer (bid) or BuyNow (listing). |
price | String | NFT unit price. |
currencyAddress | String | Payment currency address. |
collectionAddress | String | NFT contract address. |
tokenId | String | NFT token identifier. |
amount | String | NFT quantity in the order. |
How to Use This API
- Filtering Offers: Narrow results by
collectionAddress,tokenId, ormakerfor targeted queries. - Sorting: Use
sortto prioritize high-value offers (price_desc) or recent updates (update_time_desc). - Pagination: Employ
limitandcursorto manage large datasets efficiently.
👉 Explore more Web3 APIs to enhance your NFT marketplace integration.
FAQs
Q1: What chains are supported?
A1: ETH, Polygon, BSC, Avalanche, OKTC, and other EVM-compatible networks.
Q2: How do I track order status changes?
A2: Poll the API with updateAfter or use WebSocket for real-time updates.
Q3: Can I fetch expired offers?
A3: No—only active or recently updated orders are returned by default.
Q4: What’s the maximum limit value?
A4: 100 per request; use pagination (cursor) for larger datasets.
Q5: How are prices denominated?
A5: In the native token of the specified currencyAddress.
Optimize your NFT trading strategy with this API—seamlessly query offers and integrate with Seaport contracts. 👉 Get started with OKX Web3.
### Key SEO Features:
- **Keywords**: NFT offers, Seaport contract, OKX Order API, Web3 marketplace.