Collections
Launch and monitor NFT collections and their owners.
Create Collection
Launch an NFT collection on Solana mainnet. We currently support two types:
Static passes: All NFTs in a static pass collection have the same image.
Numbered passes: Like static passes, numbered passes all share the same image, but NFTs are distinguishable by a number at the bottom of the image. NFTs are minted in order, where the first NFT minted says "#1" at the bottom.
After calling this endpoint, Comet will automatically start deploying the collection on Solana mainnet. This usually takes 30-60 seconds. To monitor the progress of the deployment, use the GET /collection
endpoint below.
Note: This endpoint requires an image upload, so the request should be in the form of multipart/form-data
.
Create a new NFT collection on Solana mainnet.
POST
https://api.withcomet.com/v1/collection
This endpoint requires an image upload, so the request should be in the form of multipart/form-data
.
Headers
Authorization*
String
Bearer token with your Comet API key
Request Body
name*
String
The name of the collection.
symbol*
String
The symbol of the collection.
description*
String
The description of the collection.
subtype
String
numbered_pass
(default): the edition number will be displayed at the bottom of the NFT image.
static_pass
: the edition number will not be shown on the NFT, only the uploaded image.
pricingModel
String
pay_once
(default): This NFT requires a one-time payment to be minted by a user.
free
: This NFT is free to mint for anyone.
price
Float
If pricingModel
is pay_once
, the price that users will need to pay to mint this NFT, in $USD.
infiniteSupply
Boolean
If true
, this collection has an infinite number of tokens.
If false
(default), the maxSupply
parameter must be supplied.
maxSupply
Integer
If infiniteSupply
is false
, the maximum number of tokens that can be minted from this collection.
backgroundUpload*
File
Uploaded via multipart/form-data
request. An image file (JPG, or PNG) that will be displayed on all NFTs in the collection.
Get Launched Collections
Get a list of collections you've launched.
GET
https://api.withcomet.com/v1/collection
Headers
Authorization*
String
Bearer token
Get Collection by ID
Retrieve a collection given its ID.
GET
https://api.withcomet.com/v1/collection/:id
Headers
Authorization*
String
Bearer token
Get Collection Holders
For a given collection, return a list of the Comet users and/or addresses who hold tokens in that collection.
Gets a collection's holders.
GET
https://api.withcomet.com/rest/v1/collection/:id/holders
Path Parameters
collectionId
String
id of collection
Headers
Authorization*
String
Bearer token
Last updated