Docs / Subscriptions / Register a mint
Register a mint
POST /v1/tokens/register🔑 API key required
Subscribe a slot. Enqueues a historical backfill only if the mint is new to the platform and a credit is free.
Devnet slots are free : they don't count against your plan's mint slots (separate per-network pools), carry no commitment lock and never consume rotations — but devnet is not indexed yet, so its data endpoints return empty until the devnet ingestor ships (the response says so in coverage.note).
Body
Field Type Description mintrequired string The token mint to track. networkoptional mainnet | devnet Which network. default mainnet
Response fields
Field Type Description statusstring live (mainnet) / pending. subscriptionobject { created, novel, lockedUntil }. backfillobject { scheduled, chunks } or a reason it wasn't. usageobject Slot usage after the change. statusUrlstring Poll this for backfill progress.
cURL
JavaScript
copy curl -X POST "https://www.quanaris.com/v1/tokens/register" \
-H "x-api-key: $QUANARIS_KEY" \
-H "content-type: application/json" \
-d '{ "mint": "C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ", "network": "mainnet" }' copy const res = await fetch("https://www.quanaris.com/v1/tokens/register" , {
method: "POST" ,
headers: { "x-api-key" : process.env.QUANARIS_KEY, "content-type" : "application/json" },
body: JSON.stringify({ mint: "C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ" , network: "mainnet" })
});
const data = await res.json();
Response example
copy {
"mint" : "C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ" , "network" : "mainnet" , "status" : "live" ,
"subscription" : { "created" : true , "novel" : true , "lockedUntil" : "2026-07-04T…" } ,
"backfill" : { "scheduled" : true , "chunks" : 76 } ,
"usage" : { "activeSlots" : 3 , "maxMints" : 50 } ,
"statusUrl" : "/v1/tokens/C7heQqfNzdMbUFQwcHkL9FvdwsFsDRBnfwZDDyWYCLTZ/backfill?network=mainnet"
}