POST
/
collections
Create NFT Collection
curl --request POST \
  --url https://createkit.b3.fun/collections \
  --header 'Content-Type: application/json' \
  --data '{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "symbol": "<string>",
  "creator": "<string>",
  "gameOwner": "<string>",
  "gameId": "<string>",
  "chainId": 8453,
  "creatorSignature": "<string>",
  "baseURI": "",
  "maxSupply": "10000",
  "mintPrice": "0.001",
  "startTime": "<string>",
  "endTime": "<string>",
  "tokenStandard": "ERC721",
  "maxPerWallet": "5",
  "isWhitelistEnabled": false,
  "image": "<string>",
  "description": "<string>",
  "external_url": "<string>",
  "animation_url": "<string>",
  "attributes": [
    {
      "trait_type": "<string>",
      "value": "<string>"
    }
  ],
  "whitelistMerkleRoot": "<string>",
  "referrer": "<string>"
}'
{
  "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>"
  }
}

Body

application/json

Request to create a new NFT collection

name
string
required

Collection name

symbol
string
required

Collection symbol (e.g., "BAYC")

creator
string
required

Creator wallet address

creatorSignature
string
required

Signature authorizing collection creation

uuid
string<uuid>

Optional UUID (generated if not provided)

gameOwner
string

Game owner wallet address (defaults to creator)

gameId
string | null

Optional game identifier

chainId
integer
default:8453

Blockchain chain ID (defaults to B3 Mainnet)

baseURI
string
default:""

Base URI for token metadata

maxSupply
string
default:10000

Maximum number of tokens (as string for BigInt)

mintPrice
string
default:0.001

Price per mint in ETH (as string for BigInt)

startTime
string

Mint start time (Unix timestamp, defaults to now)

endTime
string

Mint end time (Unix timestamp, defaults to 30 days from now)

tokenStandard
enum<string>
default:ERC721

NFT standard to use

Available options:
ERC721,
ERC1155
maxPerWallet
string
default:5

Maximum tokens per wallet (as string for BigInt)

isWhitelistEnabled
boolean
default:false

Whether whitelist is enabled

image
string

Collection image URL

description
string

Collection description

external_url
string

External URL for collection

animation_url
string

URL to multimedia attachment

attributes
object[]

OpenSea-compatible attributes

whitelistMerkleRoot
string

Optional whitelist Merkle root

referrer
string

Optional referrer ID for tracking

Response

Collection created successfully

success
boolean
Example:

true

collection
object

Complete NFT collection data