Get Collection by Address

Retrieves a single collection by its predicted deployment address. Results are cached for 30 days for optimal performance.

GET /collections/{predictedAddress}

Retrieves a single collection by its predicted deployment address. Results are cached for 30 days for optimal performance.

Path Parameters

predictedAddress string required path

Predicted deployment address of the collection

Responses

200 Collection retrieved successfully

application/json

success boolean

collection object

Complete NFT collection data

uuid string

Unique collection identifier

predictedAddress string

Predicted deployment address

creator string

Creator wallet address

gameOwner string

Game owner wallet address

gameId string | null

Game identifier

chainId integer

Blockchain chain ID

creatorSignature string

Authorization signature

name string

Collection name

symbol string

Collection symbol

baseURI string

Base URI for metadata

maxSupply string

Maximum token supply

mintPrice string

Price per mint in ETH

startTime string

Mint start timestamp

endTime string

Mint end timestamp

tokenStandard string

NFT token standard

Enum: ERC721, ERC1155

maxPerWallet string

Maximum tokens per wallet

isWhitelistEnabled boolean

Whitelist status

image string

Collection image URL

description string

Collection description

external_url string

External collection URL

animation_url string

Multimedia attachment URL

attributes object[]

Collection attributes

Array of:

trait_type string

value string

createdAt string

Creation timestamp

whitelistMerkleRoot string | null

Whitelist Merkle root

referrer string | null

Referrer ID

400 Bad Request - Invalid address format

404 Collection not found

curl -X GET 'https://createkit.b3.fun/collections/string'

const response = await fetch('https://createkit.b3.fun/collections/string', {
  method: 'GET'
});

const data = await response.json();
console.log(data);

import requests

response = requests.get('https://createkit.b3.fun/collections/string')
print(response.json())

200 Response

{
  "success": true,
  "collection": {
    "uuid": "<string>",
    "predictedAddress": "<string>",
    "creator": "<string>",
    "gameOwner": "<string>",
    "gameId": "<string>",
    "chainId": 123,
    "creatorSignature": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "baseURI": "<string>",
    "maxSupply": "<string>",
    "mintPrice": "<string>",
    "startTime": "<string>",
    "endTime": "<string>",
    "tokenStandard": "ERC721",
    "maxPerWallet": "<string>",
    "isWhitelistEnabled": true,
    "image": "<string>",
    "description": "<string>",
    "external_url": "<string>",
    "animation_url": "<string>",
    "attributes": [
      {
        "trait_type": "<string>",
        "value": "<string>"
      }
    ],
    "createdAt": "<string>",
    "whitelistMerkleRoot": "<string>",
    "referrer": "<string>"
  }
}

400 Response

{
  "success": false,
  "error": "<string>"
}

404 Response

{
  "success": false,
  "error": "<string>"
}

GET /collections/{predictedAddress}

Base URL

Path Parameters

predictedAddress string required

Response

Was this page helpful?

Previous Count Collections

Next Bulk Delete Collections