Get one public launch token by slug.
GET /api/v1/tokens/{slug}. Get one public launch token by slug.
Request
GET /api/v1/tokens/{slug}
The schema permits anonymous access. Supported credentials: a customer API key with read scope in X-API-Key. Deployment policy can require a key for market-data routes.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
slug | path | string | Yes | min length: 1; max length: 64; pattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$ | — |
X-Request-Id | header | string | No | min length: 8; max length: 128; pattern: ^[A-Za-z0-9._:-]+$ | Optional client correlation identifier. The server always generates a separate authoritative request ID and retains a valid supplied value only as secondary audit correlation metadata. |
cURL
Set SLUG to the path and required query values before running this example. URL-encode path values as needed.
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/tokens/${SLUG}" \
--header "X-API-Key: $SUPANOVA_API_KEY"Responses
200
Public launch token detail.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Type: object.
Additional fields are not allowed.
400
Invalid token slug. Also: VALIDATION_FAILED, AMBIGUOUS_CREDENTIALS.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
401
Credentials are missing, malformed, expired or revoked. Codes: API_KEY_INVALID, API_KEY_REVOKED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
403
The credential may not call this route. Codes: API_KEY_IP_NOT_ALLOWED, PRODUCT_ACCOUNT_RESTRICTED.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
404
Token not found.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
429
The caller exceeded an IP or principal request budget.
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Whole seconds to wait before retrying a rate-limited request. |
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
503
The stage projection is not configured.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
default
Machine-readable API error. The HTTP status identifies the error class.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
Standard envelope: error.code, error.message, optional error.details, and requestId. See error handling and the full code registry.
Nested schemas
Field links above lead to the complete nested object, array, and variant definitions below. Required fields are scoped to their containing object.
Schema 1
Response 200.item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
amm | one or more variants · Schema 3 | No | — | — |
art | string | Yes | allowed: "rings", "grid", "halo", "waves", "monolith", "comet" | — |
banner | one or more variants · Schema 4 | Yes | — | — |
bannerMimeType | one or more variants · Schema 5 | Yes | — | — |
category | string | Yes | allowed: "defi", "payments", "infrastructure", "real_world_assets", "capital_markets", "stablecoins", "identity_compliance", "data_oracles", "consumer", "culture", "other" | — |
change24h | string | Yes | pattern: ^-?(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
createdAt | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
creatorRevenue | exactly one variant · Schema 6 | Yes | — | — |
creator | string | Yes | min length: 1; max length: 100 | — |
creatorHandle | string | Yes | min length: 1; max length: 100 | — |
creatorAvatarPresetId | one or more variants · Schema 7 | No | — | — |
creatorAvatarUrl | one or more variants · Schema 8 | No | — | Public token-scoped custom avatar image path; version changes when the selected image changes. |
description | string | Yes | min length: 1; max length: 2000 | — |
disclaimer | string | Yes | min length: 1; max length: 1000 | — |
docs | one or more variants · Schema 9 | Yes | — | — |
fullyDilutedValue | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
holderChange24h | integer | Yes | minimum: -9007199254740991; maximum: 9007199254740991 | — |
holders | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
id | string | Yes | min length: 1; max length: 100 | — |
image | one or more variants · Schema 4 | Yes | — | — |
imageKind | one or more variants · Schema 10 | Yes | — | — |
imageMimeType | one or more variants · Schema 5 | Yes | — | — |
instrumentId | object · Schema 11 | Yes | — | — |
lastBuyAt | one or more variants · Schema 12 | Yes | — | Ledger time of the newest confirmed buy. Null when the coin has no buy on record (meta.marketActivity.lastBuy is 'published') or when the figure is not published. |
launchProgress | object · Schema 13 | Yes | — | — |
marketCap | one or more variants · Schema 14 | Yes | — | Fully diluted: price x launchProgress.totalSupply (equals fullyDilutedValue). |
name | string | Yes | min length: 1; max length: 100 | — |
palette | array of unspecified · Schema 15 | Yes | min items: 3; max items: 3 | — |
price | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
pricePerMillionTokensCc | string | No | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | CC per million tokens, a display value; present for curve-package tokens. |
raisedCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
references | array of object · Schema 16 | Yes | max items: 20 | — |
rewardDestination | string | Yes | allowed: "creator", "trader_cashback" | — |
slug | string | Yes | min length: 1; max length: 64 | — |
sparkline | array of string · Schema 17 | Yes | max items: 500 | — |
tagline | string | Yes | min length: 1; max length: 200 | — |
ticker | string | Yes | min length: 1; max length: 16 | — |
tradeCount24h | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
verified | boolean | Yes | — | — |
volume24h | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
volume7d | one or more variants · Schema 18 | Yes | — | CC volume over meta.marketActivity.volume7d: "0" when the coin had no fills, null when the figure is not published. |
website | one or more variants · Schema 9 | Yes | — | — |
marketCapUsd | one or more variants · Schema 19 | Yes | — | marketCap x meta.ccUsdQuote.rateUsdPerCc at Decimal10; null without a quote. |
priceUsd | one or more variants · Schema 20 | Yes | — | price x meta.ccUsdQuote.rateUsdPerCc, a display value with significant digits; null without a quote. |
Additional fields are not allowed.
Schema 2
Response 200.meta
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
provenance | object · Schema 21 | Yes | — | — |
schemaVersion | "1" | Yes | — | — |
ccUsdQuote | one or more variants · Schema 22 | Yes | — | — |
marketActivity | one or more variants · Schema 23 | Yes | — | Null when this source does not publish lastBuyAt and volume7d. |
Additional fields are not allowed.
Schema 3
Response 200.item.amm
Type: one or more variants.
At least one of these variants must match:
- Variant 1: object · Schema 24.
- Variant 2: null.
Schema 4
Response 200.item.banner
Type: one or more variants.
At least one of these variants must match:
- Variant 1: one or more variants · Schema 25.
- Variant 2: null.
Schema 5
Response 200.item.bannerMimeType
Type: one or more variants.
At least one of these variants must match:
- Variant 1: string. max length:
100 - Variant 2: null.
Schema 6
Response 200.item.creatorRevenue
Type: exactly one variant.
Exactly one of these variants must match:
Schema 7
Response 200.item.creatorAvatarPresetId
Type: one or more variants.
At least one of these variants must match:
- Variant 1: string. allowed:
"supanova-01","supanova-02","supanova-03","supanova-04","supanova-05","supanova-06","supanova-07","supanova-08","supanova-09","supanova-10","supanova-11","supanova-12" - Variant 2: null.
Schema 8
Response 200.item.creatorAvatarUrl
Type: one or more variants.
Public token-scoped custom avatar image path; version changes when the selected image changes.
At least one of these variants must match:
- Variant 1: string. max length:
113; pattern:^\/api\/v1\/tokens\/[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?\/creator-avatar\?v=[a-f0-9]{16}$ - Variant 2: null.
Schema 9
Response 200.item.docs
Type: one or more variants.
At least one of these variants must match:
- Variant 1: string. format:
uri; max length:2048; pattern:^https:// - Variant 2: null.
Schema 10
Response 200.item.imageKind
Type: one or more variants.
At least one of these variants must match:
- Variant 1: string. allowed:
"image","video" - Variant 2: null.
Schema 11
Response 200.item.instrumentId
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
admin | string | Yes | min length: 1; max length: 512 | — |
id | string | Yes | min length: 1; max length: 512 | — |
Additional fields are not allowed.
Schema 12
Response 200.item.lastBuyAt
Type: one or more variants.
Ledger time of the newest confirmed buy. Null when the coin has no buy on record (meta.marketActivity.lastBuy is 'published') or when the figure is not published.
At least one of these variants must match:
- Variant 1: string. format:
date-time; pattern:^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ - Variant 2: null.
Schema 13
Response 200.item.launchProgress
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
curveAllocation | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
graduationPercent | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
graduationThresholdCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
liquidityReserve | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
remainingCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
stage | string | Yes | allowed: "ignition", "near_escape", "graduating", "in_orbit" | — |
supplyPolicy | object · Schema 28 | Yes | — | — |
totalSupply | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
Additional fields are not allowed.
Schema 14
Response 200.item.marketCap
Type: one or more variants.
Fully diluted: price x launchProgress.totalSupply (equals fullyDilutedValue).
At least one of these variants must match:
- Variant 1: string. pattern:
^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ - Variant 2: null.
Schema 15
Response 200.item.palette
Type: array of unspecified.
min items: 3; max items: 3
Tuple positions (in order):
- string. pattern:
^#[0-9a-f]{6}$ - string. pattern:
^#[0-9a-f]{6}$ - string. pattern:
^#[0-9a-f]{6}$
Schema 16
Response 200.item.references
Type: array of object.
max items: 20
Array items: object · Schema 29.
Schema 17
Response 200.item.sparkline
Type: array of string.
max items: 500
Array items: string. pattern: ^-?(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$
Schema 18
Response 200.item.volume7d
Type: one or more variants.
CC volume over meta.marketActivity.volume7d: "0" when the coin had no fills, null when the figure is not published.
At least one of these variants must match:
- Variant 1: string. pattern:
^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ - Variant 2: null.
Schema 19
Response 200.item.marketCapUsd
Type: one or more variants.
marketCap x meta.ccUsdQuote.rateUsdPerCc at Decimal10; null without a quote.
At least one of these variants must match:
- Variant 1: string. pattern:
^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ - Variant 2: null.
Schema 20
Response 200.item.priceUsd
Type: one or more variants.
price x meta.ccUsdQuote.rateUsdPerCc, a display value with significant digits; null without a quote.
At least one of these variants must match:
- Variant 1: string. pattern:
^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ - Variant 2: null.
Schema 21
Response 200.meta.provenance
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
dataMode | string | Yes | allowed: "projected", "simulated" | — |
disclaimer | string | Yes | min length: 1 | — |
label | string | Yes | min length: 1 | — |
networkId | string | Yes | pattern: ^canton:[-_a-zA-Z0-9]{1,32}$ | — |
visibility | string | Yes | allowed: "aggregated-from-entitled-views", "public-by-design" | — |
Additional fields are not allowed.
Schema 22
Response 200.meta.ccUsdQuote
Type: one or more variants.
At least one of these variants must match:
- Variant 1: object · Schema 30.
- Variant 2: null.
Schema 23
Response 200.meta.marketActivity
Type: one or more variants.
Null when this source does not publish lastBuyAt and volume7d.
At least one of these variants must match:
- Variant 1: object · Schema 31.
- Variant 2: null.
Schema 24
Response 200.item.amm variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
ccReserve | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
feeRate | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
invariant | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
marginalPriceCcPerToken | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
revision | string | Yes | pattern: ^(?:0|[1-9]\d{0,18})$ | — |
tokenReserve | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
Additional fields are not allowed.
Schema 25
Response 200.item.banner variant 1
Type: one or more variants.
At least one of these variants must match:
- Variant 1: string. format:
uri; max length:2048; pattern:^https:// - Variant 2: string. min length:
2; max length:2048
Schema 26
Response 200.item.creatorRevenue variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
eligibility | "eligible" | Yes | — | — |
policy | object · Schema 32 | Yes | — | — |
reason | "accepted-policy-creator-route" | Yes | — | — |
Additional fields are not allowed.
Schema 27
Response 200.item.creatorRevenue variant 2
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
eligibility | "ineligible" | Yes | — | — |
policy | null | Yes | — | — |
reason | string | Yes | allowed: "legacy-no-policy", "trader-cashback" | — |
Additional fields are not allowed.
Schema 28
Response 200.item.launchProgress.supplyPolicy
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
kind | "fixed" | Yes | — | — |
postCreationMinting | "disabled" | Yes | — | — |
version | string | Yes | min length: 1; max length: 100 | — |
Additional fields are not allowed.
Schema 29
Response 200.item.references item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
href | string | Yes | format: uri; max length: 2048; pattern: ^https:// | Public navigation-only HTTPS URL with a DNS hostname; credentials, IP literals, localhost and private/local DNS suffixes are forbidden. This is not permission for server-side fetching. |
kind | string | Yes | allowed: "website", "docs", "x", "telegram", "discord", "instagram", "youtube", "tiktok", "research" | — |
label | string | Yes | min length: 1; max length: 100 | — |
Additional fields are not allowed.
Schema 30
Response 200.meta.ccUsdQuote variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | When this backend fetched the rate. |
rateUsdPerCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | USD per CC. |
roundNumber | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
source | string | Yes | min length: 1; max length: 100 | — |
stale | boolean | Yes | — | — |
Additional fields are not allowed.
Schema 31
Response 200.meta.marketActivity variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
asOf | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | Every fill the participant query store held at this time is included. |
lastBuy | string | Yes | allowed: "published", "unavailable" | 'unavailable': lastBuyAt is null for every coin because it could not be read. |
unit | "CC" | Yes | — | — |
volume24h | object · Schema 33 | Yes | — | — |
volume7d | object · Schema 33 | Yes | — | — |
volumeBasis | "net_reserve_change" | Yes | — | Absolute change of the pool's net CC reserve per confirmed fill. |
Additional fields are not allowed.
Schema 32
Response 200.item.creatorRevenue variant 1.policy
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
hash | "sha256:a926e0a380b3938648b5fa9898136638e1276128947cf94033e760f87a27e8b2" | Yes | — | — |
id | "supanova-creator-revenue-policy" | Yes | — | — |
version | "1" | Yes | — | — |
Additional fields are not allowed.
Schema 33
Response 200.meta.marketActivity variant 1.volume24h
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
windowEnd | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
windowStart | string | Yes | format: date-time; pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | An hour boundary; the window is whole hourly buckets. |
Additional fields are not allowed.
Source contract
This page is generated from the checked-in customer OpenAPI snapshot. Download JSON, download YAML, or compare the live API reference. Snapshot provenance records the retrieval date and checksum.