Query Offers
Use this endpoint to fetch active offers made on a specific collection or individual NFT.
Offers that are collection-wide or trait-specific are automatically returned when querying a compatible NFT token ID.
Query Offers
Request
GET /v1/offers
Headers:
x-api-key:mp_part_yourkey
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
collectionAddress | string | Yes | The contract address of the NFT collection. |
tokenId | string | No | The token ID to query. If provided, returns offers specifically targeting this token ID, plus any collection-wide/trait offers that are compatible with this token's attributes. |
buyer | string | No | Filter offers by the buyer's wallet address. |
cursor | integer | No | Offset for pagination (default: 0). |
limit | integer | No | Max number of offers to return (default: 20, max 100). |
Response
JSON
{ "success": true, "offers": [ { "orderHash": "0xabcde12345...", "buyer": "0x9876543210abcdef9876543210abcdef98765432", "collectionAddress": "0x29efca787c5337614c8f2709da0105de6b30a393", "priceWei": "100000000000000000000", "price": "100000000000000000000", "tokenId": null, "amount": 1, "strategy": "0x...", "currency": "WCRO", "currencyAddress": "0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23", "nonce": "1718274092", "startTime": 1718274092, "endTime": 1718878892, "expiresAt": "2026-06-25T13:00:00.000Z", "traitsFilter": null, "createdByPartner": true, "partnerId": 2, "partnerName": "Partner Beta", "signature": "0xsig..." } ], "nextCursor": null}