Collections

Only active, verified collections can be listed on the Mintpad marketplace. Use the Collections endpoints to verify compatibility and query floor listings before starting the listing flow.

Fetch Whitelisted Collections

Use GET /v1/collections to retrieve all contracts available for listing. Match the NFT's contract address against the returned address field (case-insensitive) to confirm eligibility.

Request

GET /v1/collections

Headers:

x-api-key: mp_part_yourkey

Query Parameters

chainId (integer, optional) - The chain ID (defaults to 25).
collectionAddress (string, optional) - Filter and return only the specific collection details matching this address.
search (string, optional) - Search collections by name.
cursor (string, optional) - Paginated query cursor.
limit (integer, optional) - Paginated items limit.

Response

JSON

{
  "success": true,
  "collections": [
    {
      "chainId": 25,
      "address": "0x29efca787c5337614c8f2709da0105de6b30a393",
      "name": "Mintpad Collection",
      "slug": "mintpad-collection",
      "logo": "https://mintpad.app/images/logo.png",
      "coverImage": "https://mintpad.app/images/logo.png",
      "banner": "https://mintpad.app/images/banner.png",
      "bannerImage": "https://mintpad.app/images/banner.png",
      "floorPriceWei": "100000000000000000000",
      "totalVolumeWei": "5000000000000000000000",
      "activeListings": 42,
      "royalty": {
        "bps": 250,
        "recipient": "0x29efca787c5337614c8f2709da0105de6b30a393"
      },
      "supply": {
        "maxSupply": 10000,
        "minted": 4200
      },
      "socials": {
        "website": "https://mintpad.app",
        "twitter": "https://twitter.com/mintpad",
        "discord": "https://discord.gg/mintpad"
      },
      "volume24hr": "15000000000000000000000",
      "volume24hrWei": "15000000000000000000000",
      "owners": 1250
    }
  ],
  "nextCursor": null
}

Field	Type	Description
`chainId`	integer	Chain identifier (e.g. `25` for Cronos)
`address`	string	Smart contract address of the collection
`name`	string	Human-readable name of the collection
`slug`	string	URL-friendly unique identifier
`logo` / `coverImage`	string	URL to the collection's logo/avatar
`banner` / `bannerImage`	string	URL to the collection's banner image
`floorPriceWei`	string	Current floor price in Wei (null if no active listings)
`totalVolumeWei`	string	Cumulative traded volume in Wei
`activeListings`	integer	Total count of active listings on the marketplace
`royalty`	object	Royalty parameters: `bps` (basis points, e.g. 250 for 2.5%) and `recipient` address
`supply`	object	Mint parameters: `maxSupply` and `minted` count
`socials`	object	Associated community links: `website`, `twitter`, and `discord`
`volume24hr` / `volume24hrWei`	string	Traded volume in the last 24 hours in Wei
`owners`	integer	Total unique address count holding tokens in this collection

Fetch Collection Items

Use GET /v1/collections/:address to retrieve paginated NFT items of a given collection, including active listing details from any Mintpad source or partner. This allows you to show unlisted tokens as well as tokens listed globally.

Request

GET /v1/collections/0x29efca787c5337614c8f2709da0105de6b30a393

Headers:

x-api-key: mp_part_yourkey

Query Parameters

cursor (integer, optional) - Pagination offset (defaults to 0).
limit (integer, optional) - Number of items to return (defaults to 20, max 100).
owner (string, optional) - Filter items by owner's wallet address.
sort (string, optional) - Sort strategy. Options: tokenId_asc, tokenId_desc, price_asc, price_desc, rarity_asc, rarity_desc.

Response

JSON

{
  "success": true,
  "items": [
    {
      "tokenId": "1",
      "name": "Mintpad Token #1",
      "image": "https://mintpad.app/images/token-1.jpg",
      "owner": "0x9876543210abcdef9876543210abcdef98765432",
      "rarityRank": 5,
      "listing": {
        "orderHash": "0xabcde12345...",
        "priceWei": "100000000000000000000",
        "price": "100000000000000000000",
        "currency": "WCRO",
        "currencyAddress": "0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23",
        "nonce": "1718274092",
        "endTime": 1781874000,
        "expiresAt": "2026-07-18T13:00:00.000Z",
        "createdByPartner": true,
        "partnerId": 2
      }
    },
    {
      "tokenId": "2",
      "name": "Mintpad Token #2",
      "image": "https://mintpad.app/images/token-2.jpg",
      "owner": "0x9876543210abcdef9876543210abcdef98765432",
      "rarityRank": 12,
      "listing": null
    }
  ],
  "nextCursor": "20"
}

Field	Description
`tokenId`	NFT unique token ID
`name`	Item name
`image`	Item image URL
`owner`	Owner's wallet address
`rarityRank`	Rarity rank of this token
`listing`	The active listing object if listed anywhere on Mintpad or by a partner, otherwise `null`
`nextCursor`	Cursor parameter value for the next page, or `null` if last page

Fetch Wallet Owned Items

Use GET /v1/wallets/:owner/items to retrieve all NFT items owned by a specific wallet across active, verified collections. This endpoint returns both listed and unlisted tokens.

Request

GET /v1/wallets/0x9876543210abcdef9876543210abcdef98765432/items

Headers:

x-api-key: mp_part_yourkey

Query Parameters

cursor (integer, optional) - Pagination offset (defaults to 0).
limit (integer, optional) - Number of items to return (defaults to 20, max 100).

Response

JSON

{
  "success": true,
  "items": [
    {
      "tokenId": "1",
      "name": "Mintpad Token #1",
      "image": "https://mintpad.app/images/token-1.jpg",
      "owner": "0x9876543210abcdef9876543210abcdef98765432",
      "rarityRank": 5,
      "collectionAddress": "0x29efca787c5337614c8f2709da0105de6b30a393",
      "collectionName": "Mintpad Collection",
      "collectionSymbol": "MNTPAD",
      "collectionSlug": "mintpad-collection",
      "collectionImage": "https://mintpad.app/images/logo.png",
      "listing": {
        "orderHash": "0xabcde12345...",
        "priceWei": "100000000000000000000",
        "price": "100000000000000000000",
        "currency": "WCRO",
        "currencyAddress": "0x5C7F8A570d578ED84E63fdFA7b1eE72dEae1AE23",
        "nonce": "1718274092",
        "endTime": 1781874000,
        "expiresAt": "2026-07-18T13:00:00.000Z",
        "createdByPartner": true,
        "partnerId": 2
      }
    }
  ],
  "nextCursor": null
}

Field	Description
`tokenId`	NFT unique token ID
`name`	Item name
`image`	Item image URL
`owner`	Owner's wallet address
`rarityRank`	Rarity rank of this token
`collectionAddress`	Smart contract address of the collection
`collectionName`	Human-readable name of the collection
`collectionSymbol`	Token symbol of the collection
`collectionSlug`	URL-friendly unique identifier of the collection
`collectionImage`	URL to the collection's cover/logo image
`listing`	The active listing object if listed anywhere on Mintpad or by a partner, otherwise `null`
`nextCursor`	Cursor parameter value for the next page, or `null` if last page

PREVIOUSAuthentication

NEXTDrops