Developers

API reference

Every public endpoint, with request parameters, response schemas, and links to the source contract.

116 endpoints · Public API

BASE URLhttps://launch-api.supanova.app

116 endpoints · OpenAPI 3.1

catalog

List curated public assets./api/v1/catalog/assets

List curated public markets./api/v1/catalog/markets

List public Supanova launches./api/v1/catalog/launches

Get one public launch by stable ID or slug./api/v1/catalog/launches/{launchReference}

configuration

Return the safe runtime and feature configuration for the frontend./api/v1/app-config

creator

List token launches attributed to the active product account./api/v1/me/created-launches

Read bounded creator revenue accounting and distribution history./api/v1/me/creator-rewards

Total, claimed and pending creator rewards of the caller's launches, from live maker fee accruals and confirmed maker claims./api/v1/me/creator-rewards/summary

fee claims

Read the connected creator wallet’s accrued and claimable maker fees without preparing or submitting a claim./api/v1/fee-claims/maker

Prepare the creator's wallet-signed maker fee claim of one token./api/v1/fee-claims/maker/prepare

Ledger-confirmed outcome of the caller's prepared maker fee claim, with the exact credited amount./api/v1/fee-claims/maker/{commandId}/status

wallet

Create a short-lived, origin-bound CIP-0103 wallet ownership challenge./api/v1/wallet/connections/challenges

Consume a challenge and verify the Party-key signature over its binding digest once./api/v1/wallet/connections/verify

Read the authenticated user’s wallet portfolio projection./api/v1/wallet/portfolio

Create an idempotent wallet-authorized transfer intent./api/v1/wallet/transfers/prepare

Value the connected account in USD: wallet CC, trading balance and token holdings, with rate source, completeness and in-flight funds./api/v1/wallet/valuation

Value the connected account at every hour or day of a range: wallet CC, trading balance and tokens in CC, and in USD from the first recorded CC/USD round./api/v1/wallet/valuation/history

operations

List the authenticated user’s operation lifecycle./api/v1/operations

Get one owned operation./api/v1/operations/{operationId}

Record a wallet submission hint; ledger observation remains authoritative./api/v1/operations/{operationId}/wallet-report

Execute a prepared operation on the ledger with the wallet’s signatures (local ledger configuration only)./api/v1/operations/{operationId}/submit

superapp tokens

Discover public Supanova launch tokens./api/v1/tokens

Get public Supanova launch-market aggregate counters./api/v1/tokens/summary

Get the canonical category dictionary used by discovery and coin creation./api/v1/tokens/categories

Get one public launch token by slug./api/v1/tokens/{slug}

Get bounded public CC-denominated candles for a token./api/v1/tokens/{slug}/candles

Get bounded public USD candles for a token: each fill at the CC/USD rate of its time, with rate changes as price events./api/v1/tokens/{slug}/candles/usd

List publication-safe holder rows for a token./api/v1/tokens/{slug}/holders

List publication-safe public trades for a token./api/v1/tokens/{slug}/trades

Read a confirmed token creator's current published avatar./api/v1/tokens/{slug}/creator-avatar

identity

Idempotently revoke the verified current Privy session before provider logout./api/v1/me/session

Return acceptance status for the current product legal policy./api/v1/me/legal-acceptance

Idempotently accept the exact current Supanova product legal policy./api/v1/me/legal-acceptance

Return the authenticated Supanova profile./api/v1/me

Atomically update presentation-only profile fields./api/v1/me

Check normalized username availability without reserving the name./api/v1/me/username-availability

Irreversibly close the product account and clear presentation data./api/v1/me/account-closure

List wallet-neutral Canton Party connections./api/v1/me/wallets

Update an owned wallet label or make it primary./api/v1/me/wallets/{connectionId}

Disconnect an owned wallet; reconnection requires a fresh proof./api/v1/me/wallets/{connectionId}

A 10-minute signed URL for the caller’s published custom avatar./api/v1/me/avatar

Upload a custom avatar (PNG, JPEG or WebP, at most 5 MiB). Returns the avatarPath to set on the profile./api/v1/me/avatar

api keys

List your API keys and the limits that apply to them./api/v1/me/api-keys

Create an API key. The secret is returned once. A trade key needs an Ed25519 public key and a wallet-signed trade-key authorisation./api/v1/me/api-keys

Start a trade key: a 5-minute challenge that a bound Party’s wallet signs (signHash), naming the Ed25519 key the trade key will sign with./api/v1/me/api-keys/trade-authorizations

Revoke an API key. Takes effect within 5 seconds everywhere./api/v1/me/api-keys/{keyId}

deposit balance

Read the spendable deposit balance, wallet CC, and pending flows./api/v1/wallet/deposit-balance

Where to send CC to fund trading (registrar Party)./api/v1/wallet/deposit-address

Initiate a real-CC deposit into the trading balance./api/v1/wallet/deposits

Read one owned deposit saga, advancing it when stalled./api/v1/wallet/deposits/{depositId}

Read the deposit a signed CC transfer funded, by the transfer update id./api/v1/wallet/deposits/by-transfer/{updateId}

Initiate a real-CC withdrawal from the trading balance./api/v1/wallet/withdrawals

Read one owned withdrawal saga, advancing it when stalled./api/v1/wallet/withdrawals/{withdrawalId}

Cancel an owned withdrawal before its payout; restores the balance./api/v1/wallet/withdrawals/{withdrawalId}/cancel

Prepare a wallet-signed on-ledger withdrawal request./api/v1/wallet/withdrawals/prepare

Prepare a wallet-signed cancel of an open withdrawal request./api/v1/wallet/withdrawals/{withdrawalId}/cancel-prepare

activity

List the authenticated user’s activity read model./api/v1/activity

market data

Exchange info, latest block and limits./api/v1/market/info

List listed tokens with metadata and headline figures./api/v1/market/tokens

One token by its CIP-56 instrument id./api/v1/market/tokens/{assetId}

Holder count and largest holders (keyed addresses)./api/v1/market/tokens/{assetId}/holders

List pairs with price, liquidity, market cap, volume, price change and trade counts./api/v1/market/pairs

One pair with its full figures./api/v1/market/pairs/{pairId}

Recent trades of a pair, newest first./api/v1/market/pairs/{pairId}/trades

OHLCV candles of the pair token (one series across graduation), in CC or USD./api/v1/market/pairs/{pairId}/candles

Compact price/volume ticker of every pair./api/v1/market/tickers

dextools adapter

Newest block whose events are all served./api/v1/dextools/latest-block

Block by number, or the youngest at or before a time./api/v1/dextools/block

Asset by id (instrument id, or Amulet for CC)./api/v1/dextools/asset

Holders by quantity, descending (keyed addresses)./api/v1/dextools/asset/holders

The Supanova exchange (factory = registrar Party)./api/v1/dextools/exchange

Pair by id (<instrument id>:curve or :amm)./api/v1/dextools/pair

Creation, swap and join events in the inclusive block (ledger offset) range./api/v1/dextools/events

wallet providers

Read stage-specific Supanova wallet provider readiness./api/v1/wallet/providers

superapp wallet

Read deposit instructions for an owned, server-verified wallet connection./api/v1/me/wallets/{connectionId}/deposit-instructions

Read unfiltered account-wide activity metrics for the dashboard cards./api/v1/me/activity/summary

Read one owned typed transaction record for the authenticated account./api/v1/me/activity/{activityId}

List typed transaction cards for the authenticated account./api/v1/me/activity

Read the lifetime weighted-average cost position per instrument of the account’s verified wallet Party./api/v1/me/positions

swaps

Create a short-lived preview quote./api/v1/swaps/quote

Create an idempotent wallet-authorized swap operation./api/v1/swaps/prepare

launch applications

List the authenticated issuer’s launch applications./api/v1/launch-applications

Create a private launch application draft./api/v1/launch-applications

Get one owned launch application./api/v1/launch-applications/{applicationId}

Edit a draft or changes-requested application./api/v1/launch-applications/{applicationId}

List document verification status for an owned application./api/v1/launch-applications/{applicationId}/documents

Register a completed quota-reserved private document upload./api/v1/launch-applications/{applicationId}/documents

Submit a complete application to Mission Control./api/v1/launch-applications/{applicationId}/submit

Withdraw an owned application before final decision./api/v1/launch-applications/{applicationId}/withdraw

Reserve quota and authorize one exact private PDF upload./api/v1/launch-applications/{applicationId}/documents/uploads

launch participation

Create an idempotent wallet-authorized launch contribution intent./api/v1/launches/{launchReference}/participations/prepare

launch media

Reserve an exact launch-media upload descriptor./api/v1/launch-media/uploads

Consume a reservation with exact multipart bytes: quarantine, validate, strip metadata, scan, publish./api/v1/launch-media/uploads/{uploadId}/content

Read owned launch-media processing status./api/v1/launch-media/{mediaId}

points

Read the public product Points preview policy and daily reset./api/v1/points/program

Read a bounded Points leaderboard containing opted-in public profiles only./api/v1/points/leaderboard

Read the authenticated account Points summary and streak./api/v1/me/points

Read bounded, cursor-paginated account Points activity./api/v1/me/points/activity

Read the authenticated account referral preview state./api/v1/me/referral

token-launches

Read the launch policy: the live Registrar terms (supplies, economics, fees, referral share) and the legacy fixed-supply preview./api/v1/token-launches/policy

Quote the immutable permissionless curve-launch policy. On the curve ledger model the request carries the chosen totalSupply and the quote carries the Registrar economics and fee configuration./api/v1/token-launches/quote

Prepare an idempotent wallet review for a quoted token launch./api/v1/token-launches/prepare

List the total supplies a curve launch may choose, with display opening and terminal prices and the smallest sellable lot./api/v1/token-launches/supply-options

Read the wallet metadata of a launched token: instrument id, admin party, decimals, symbol, name and logo reference./api/v1/tokens/{instrumentId}/wallet-metadata

trade orders

Prepare one wallet-signed TradeOrder create from a bound quote./api/v1/orders/prepare

Create a TradeOrder for an allow-listed hosted Party./api/v1/orders/hosted

Status of an order: pending, open, filled, rejected, cancelled or expired./api/v1/orders/{commandId}/status

Prepare the wallet-signed TradeOrder_Cancel of an open order./api/v1/orders/{orderId}/cancel/prepare

trading-referrals

Read this account's referral code, invite URL, referees and ledger earnings (earned, paid, owed)./api/v1/me/trading-referrals

List referral payouts credited to this account, newest first./api/v1/me/trading-referrals/payouts

Accept one referral before the first prepared trade./api/v1/me/trading-referral

Resolve an active invitation without disclosing account identifiers./api/v1/referrals/{username}

user-signed trades

Prepare plain JSON Ledger API commands + disclosures for a wallet-signed trade./api/v1/trades/prepare

Reconciliation status of a prepared user-signed submission (ledger truth)./api/v1/trades/{commandId}/status

waitlists

Acknowledge Nova interest in isolated product preview./api/v1/waitlists/nova

client-errors

Report a browser-side edge or fatal failure the API never saw./api/v1/client-errors

Generated from the public API contractDeveloper settings