Skip to main content
GET
https://api.krownlabs.app
/
api
/
offers
curl "https://api.krownlabs.app/api/offers?status=active&sortBy=price&sortOrder=desc"
{
  "offers": [
    {
      "isExpired": false,
      "_id": "695a5e5a26d520ede4a7255c",
      "id": "0x0f6ebb292d61653346539e93f8a4e15c0f5ec9a9-54",
      "offerId": 54,
      "offeror": "0xc957215773a8b86c8d8bab235451e467caaf944c",
      "collectionAddress": "0x0f6ebb292d61653346539e93f8a4e15c0f5ec9a9",
      "tokenId": 1,
      "price": "1000000000000000000",
      "pricePerItem": "1000000000000000000",
      "expirationTime": 1767544440,
      "isActive": false,
      "isCollectionOffer": false,
      "nftType": "ERC721",
      "amount": 1,
      "maxItems": 1,
      "remainingItems": 1,
      "createdAt": 1767530074,
      "updatedAt": "2026-01-04T12:45:37.938Z",
      "__v": 0,
      "cancelledAt": 1767530737
    }
  ],
  "totalPages": 68,
  "currentPage": 34,
  "total": 68
}

Query Parameters

page
integer
default:"1"
Page number
limit
integer
default:"50"
Results per page (max 100)
status
string
Filter by statusOptions: active, accepted, cancelled, expired
offerType
string
Filter by offer typeOptions: collection (collection-wide offers), token (specific NFT offers)
sortBy
string
default:"createdAt"
Sort fieldOptions: createdAt, expiresAt, price
sortOrder
string
default:"desc"
Sort order

Response

offers
array
Array of offer objects
pagination
object
Pagination metadata
curl "https://api.krownlabs.app/api/offers?status=active&sortBy=price&sortOrder=desc"
{
  "offers": [
    {
      "isExpired": false,
      "_id": "695a5e5a26d520ede4a7255c",
      "id": "0x0f6ebb292d61653346539e93f8a4e15c0f5ec9a9-54",
      "offerId": 54,
      "offeror": "0xc957215773a8b86c8d8bab235451e467caaf944c",
      "collectionAddress": "0x0f6ebb292d61653346539e93f8a4e15c0f5ec9a9",
      "tokenId": 1,
      "price": "1000000000000000000",
      "pricePerItem": "1000000000000000000",
      "expirationTime": 1767544440,
      "isActive": false,
      "isCollectionOffer": false,
      "nftType": "ERC721",
      "amount": 1,
      "maxItems": 1,
      "remainingItems": 1,
      "createdAt": 1767530074,
      "updatedAt": "2026-01-04T12:45:37.938Z",
      "__v": 0,
      "cancelledAt": 1767530737
    }
  ],
  "totalPages": 68,
  "currentPage": 34,
  "total": 68
}