supanovasupanovaDOCS
Open Launchpad
Launchpad documentation
token-launches

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.

POST /api/v1/token-launches/quote. 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 config

Request

POST /api/v1/token-launches/quote

Authentication is required. Supported credentials: a signed-in customer session token in Authorization: Bearer …. This route does not accept customer API keys.

Parameters

NameInTypeRequiredConstraintsDescription
X-Service-Act-AsheaderstringNomin length: 3; max length: 512Service-principal path only (local and devnet stages; refused by configuration on mainnet). With an OAuth client-credentials bearer token from the validator, names the allow-listed Party the client acts as. Missing: 400 SERVICE_ACT_AS_REQUIRED; not allow-listed: 403 SERVICE_PARTY_NOT_ALLOWED. Ignored for customer session tokens.
X-Request-IdheaderstringNomin 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.

Request body

A body is required.

Content type: application/json

Type: object.

FieldTypeRequiredConstraintsDescription
creatorRevenuePolicyAcceptanceobject · Schema 1Yes——
legalAcceptanceobject · Schema 2Yes——
metadataobject · Schema 3Yes——
openingBuyobject · Schema 4No——
rewardConfigurationexactly one variant · Schema 5Yes—Strict reward-routing authority union. Party IDs are opaque and case-sensitive; no trimming, casing, aliasing, or normalization is allowed.
walletConnectionIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
totalSupplystringNopattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$Required on the curve ledger model, where it is one of GET /api/v1/token-launches/supply-options; rejected on the registry model.

Additional fields are not allowed.

cURL

Create request.json using the request-body schema. The example sends the file bytes unchanged.

bash
curl --fail-with-body --silent --show-error \
  --request POST \
  --url "https://launch-api.supanova.app/api/v1/token-launches/quote" \
  --header "Authorization: Bearer $SUPANOVA_SESSION_TOKEN" \
  --header "Content-Type: application/json" \
  --data-binary @request.json

Responses

201

A short-lived simulated launch quote: the 0.2.0 quote on the registry model, the version 2 quote on the curve model.

HeaderTypeDescription
X-Request-IdstringServer-generated request correlation identifier to retain for support and reconciliation.

Content type: application/json

Type: one or more variants.

At least one of these variants must match:

400

The request is malformed or failed validation. Codes: VALIDATION_FAILED, AMBIGUOUS_CREDENTIALS, SERVICE_ACT_AS_REQUIRED.

HeaderTypeDescription
X-Request-IdstringServer-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: AUTHENTICATION_REQUIRED, INVALID_AUTHORIZATION_HEADER, INVALID_ACCESS_TOKEN, SESSION_REVOKED.

HeaderTypeDescription
X-Request-IdstringServer-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: ACCOUNT_RESTRICTED, ANONYMOUS_ACCOUNT_NOT_ALLOWED, API_KEY_ROUTE_NOT_ALLOWED, SERVICE_PARTY_NOT_ALLOWED, SERVICE_PRINCIPAL_NOT_ALLOWED, SIGNUP_NOT_INVITED.

HeaderTypeDescription
X-Request-IdstringServer-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

A referenced quote or media item does not exist.

HeaderTypeDescription
X-Request-IdstringServer-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.

413

The request body exceeds the size limit.

HeaderTypeDescription
X-Request-IdstringServer-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.

422

The launch cannot be quoted as requested: LAUNCH_MEDIA_NOT_PUBLISHED, LAUNCH_MEDIA_ROLE_MISMATCH, CREATOR_REWARD_PARTY_SOURCE_MISMATCH, TOKEN_LAUNCH_OPENING_BUY_NOT_SUPPORTED.

HeaderTypeDescription
X-Request-IdstringServer-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.

428

The signed-in account must accept the current product terms first. Codes: PRODUCT_LEGAL_ACCEPTANCE_REQUIRED.

HeaderTypeDescription
X-Request-IdstringServer-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.

HeaderTypeDescription
Retry-AfterintegerWhole seconds to wait before retrying a rate-limited request.
X-Request-IdstringServer-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

A dependency is unavailable or the feature is not enabled on this deployment. Codes: AUTHENTICATION_UNAVAILABLE, AUTHORIZATION_UNAVAILABLE.

HeaderTypeDescription
X-Request-IdstringServer-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.

HeaderTypeDescription
X-Request-IdstringServer-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

Request body.creatorRevenuePolicyAcceptance

Type: object.

FieldTypeRequiredConstraintsDescription
acceptedtrueYes——
policyHash"sha256:a926e0a380b3938648b5fa9898136638e1276128947cf94033e760f87a27e8b2"Yes——
policyId"supanova-creator-revenue-policy"Yes——
policyVersion"1"Yes——

Additional fields are not allowed.

Schema 2

Request body.legalAcceptance

Type: object.

FieldTypeRequiredConstraintsDescription
acceptedtrueYes——
documentsarray of unspecified · Schema 8Yesmin items: 3; max items: 3—
documentSetDigest"sha256:334747f374e7ba4ae02b71918bd94f5d4400b19b20997244ccdf7550719296ff"Yes——
documentVersion"1.2"Yes——
effectiveAt"2026-08-04T00:00:00.000Z"Yes——
policyId"supanova-permissionless-curve-launch"Yes——
policyVersion"3"Yes——
updatedAt"2026-08-12T00:00:00.000Z"Yes——

Additional fields are not allowed.

Schema 3

Request body.metadata

Type: object.

FieldTypeRequiredConstraintsDescription
bannerMediaIdstringNoformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
categorystringYesallowed: "defi", "payments", "infrastructure", "real_world_assets", "capital_markets", "stablecoins", "identity_compliance", "data_oracles", "consumer", "culture", "other"—
descriptionstringYesmin length: 30; max length: 1200—
docsstringNoformat: 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.
iconMediaIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
namestringYesmin length: 2; max length: 32—
socialReferencesobject · Schema 9No——
summarystringYesmin length: 10; max length: 120—
tickerstringYesmin length: 2; max length: 15; pattern: ^[A-Z0-9]{2,15}$—
websitestringNoformat: 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.

Additional fields are not allowed.

Schema 4

Request body.openingBuy

Type: object.

FieldTypeRequiredConstraintsDescription
amountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
unitstringYesallowed: "cc", "token"—

Additional fields are not allowed.

Schema 5

Request body.rewardConfiguration

Type: exactly one variant.

Strict reward-routing authority union. Party IDs are opaque and case-sensitive; no trimming, casing, aliasing, or normalization is allowed.

Exactly one of these variants must match:

Schema 6

Response 201 variant 1

Type: object.

FieldTypeRequiredConstraintsDescription
creatorRevenuePolicyobject · Schema 12Yes——
creatorRevenuePolicyAcceptanceobject · Schema 1Yes——
damlRewardRoutingobject · Schema 13Yes——
economicsobject · Schema 14Yes——
execution"simulated"Yes——
expiresAtstringYesformat: 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))$—
feesobject · Schema 15Yes——
issuedAtstringYesformat: 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))$—
legalAcceptanceobject · Schema 16Yes——
mediaobject · Schema 17Yes——
metadataobject · Schema 18Yes——
networkIdstringYespattern: ^canton:[-_a-zA-Z0-9]{1,32}$—
openingBuyone or more variants · Schema 19Yes——
policyobject · Schema 20Yes——
proposedInstrumentobject · Schema 21Yes——
proposedSlugstringYespattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$—
quoteHashstringYespattern: ^sha256:[a-f0-9]{64}$—
quoteIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
requestHashstringYespattern: ^sha256:[a-f0-9]{64}$—
rewardConfigurationexactly one variant · Schema 5Yes—Strict reward-routing authority union. Party IDs are opaque and case-sensitive; no trimming, casing, aliasing, or normalization is allowed.
rewardRoutingPolicyobject · Schema 22Yes——
walletContextobject · Schema 23Yes——

Additional fields are not allowed.

Schema 7

Response 201 variant 2

Type: object.

FieldTypeRequiredConstraintsDescription
allocationobject · Schema 24Yes——
creatorRevenuePolicyobject · Schema 12Yes——
creatorRevenuePolicyAcceptanceobject · Schema 1Yes——
curvePolicyobject · Schema 25Yes——
damlRewardRoutingobject · Schema 13Yes——
displayobject · Schema 26Yes——
economicsobject · Schema 27Yes——
execution"simulated"Yes——
expiresAtstringYesformat: 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))$—
feeConfigobject · Schema 28Yes——
feesobject · Schema 29Yes——
issuedAtstringYesformat: 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))$—
ledgerCreationFeeCcstringNopattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
legalAcceptanceobject · Schema 16Yes——
mediaobject · Schema 17Yes——
metadataobject · Schema 18Yes——
networkIdstringYespattern: ^canton:[-_a-zA-Z0-9]{1,32}$—
openingBuynullYes——
policyobject · Schema 20Yes——
proposedInstrumentobject · Schema 21Yes——
proposedSlugstringYespattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$—
quoteHashstringYespattern: ^sha256:[a-f0-9]{64}$—
quoteIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
requestHashstringYespattern: ^sha256:[a-f0-9]{64}$—
rewardConfigurationexactly one variant · Schema 5Yes—Strict reward-routing authority union. Party IDs are opaque and case-sensitive; no trimming, casing, aliasing, or normalization is allowed.
rewardRoutingPolicyobject · Schema 22Yes——
totalSupplystringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
walletContextobject · Schema 23Yes——

Additional fields are not allowed.

Schema 8

Request body.legalAcceptance.documents

Type: array of unspecified.

min items: 3; max items: 3

Tuple positions (in order):

  1. "terms".
  2. "launch-terms".
  3. "risk".

Schema 9

Request body.metadata.socialReferences

Type: object.

FieldTypeRequiredConstraintsDescription
discordstringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS discord profile/channel URL. Approved hosts: discord.gg, discord.com, discordapp.com.
instagramstringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS instagram profile/channel URL. Approved hosts: instagram.com.
telegramstringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS telegram profile/channel URL. Approved hosts: t.me, telegram.me.
tiktokstringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS tiktok profile/channel URL. Approved hosts: tiktok.com.
xstringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS x profile/channel URL. Approved hosts: x.com, twitter.com.
youtubestringNoformat: uri; max length: 2048; pattern: ^https://Non-root HTTPS youtube profile/channel URL. Approved hosts: youtube.com, youtu.be.

Additional fields are not allowed.

Schema 10

Request body.rewardConfiguration variant 1

Type: object.

Creator rewards route only to the exact immutable Party named by this branch.

FieldTypeRequiredConstraintsDescription
creatorRewardPartyIdstringYesmin length: 3; max length: 512Exact opaque, case-sensitive Canton Party ID. It is preserved byte-for-byte: launcher source must equal the verified launcher Party; external source must differ.
creatorRewardPartySourcestringYesallowed: "launcher", "external"Authority rule for creatorRewardPartyId: launcher requires exact equality with the verified launch wallet Party; external requires exact inequality.
rewardDestination"creator"Yes——

Additional fields are not allowed.

Schema 11

Request body.rewardConfiguration variant 2

Type: object.

Trader cashback forbids creator Party source and Party ID fields.

FieldTypeRequiredConstraintsDescription
rewardDestination"trader_cashback"Yes——

Additional fields are not allowed.

Schema 12

Response 201 variant 1.creatorRevenuePolicy

Type: object.

FieldTypeRequiredConstraintsDescription
attributionobject · Schema 30Yes——
eligibilityobject · Schema 31Yes——
formulaId"supanova-creator-revenue-v1"Yes——
hash"sha256:a926e0a380b3938648b5fa9898136638e1276128947cf94033e760f87a27e8b2"Yes——
id"supanova-creator-revenue-policy"Yes——
immutabletrueYes——
numericScale10Yes——
numericDomainobject · Schema 32Yes——
roundingobject · Schema 33Yes——
settlementobject · Schema 34Yes——
sourcesarray of unspecified · Schema 35Yesmin items: 3; max items: 3—
version"1"Yes——

Additional fields are not allowed.

Schema 13

Response 201 variant 1.damlRewardRouting

Type: object.

FieldTypeRequiredConstraintsDescription
creatorRewardBeneficiaryone or more variants · Schema 36Yes——
rewardDestinationstringYesallowed: "CreatorRewardDestination", "TraderCashbackDestination"—
rewardRoutingPolicyDigest"sha256:fe83c99bff082060a46d8a30ea9de61fc1f165ccd2c28c595b85f393accd86dd"Yes——
rewardRoutingPolicyVersion"1"Yes——

Additional fields are not allowed.

Schema 14

Response 201 variant 1.economics

Type: object.

FieldTypeRequiredConstraintsDescription
creationFeeCc"25"Yes——
curveAllocation"800000000"Yes——
curveobject · Schema 37Yes——
dexReserve"200000000"Yes——
fixedSupplytrueYes——
graduationobject · Schema 38Yes——
graduationThresholdCc"250000"Yes——
openingPriceCcPerToken"0.000078125"Yes——
postGraduationAmmobject · Schema 39Yes——
totalSupply"1000000000"Yes——
tradingFeeRate"0.01"Yes——

Additional fields are not allowed.

Schema 15

Response 201 variant 1.fees

Type: object.

FieldTypeRequiredConstraintsDescription
creationFeeCc"25"Yes——
openingTradingFeeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
totalDebitCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
tradingFeeRate"0.01"Yes——

Additional fields are not allowed.

Schema 16

Response 201 variant 1.legalAcceptance

Type: object.

FieldTypeRequiredConstraintsDescription
acceptedtrueYes——
acceptedAtstringYesformat: 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))$—
documentSetDigest"sha256:334747f374e7ba4ae02b71918bd94f5d4400b19b20997244ccdf7550719296ff"Yes——
documentsarray of unspecified · Schema 8Yesmin items: 3; max items: 3—
effectiveAt"2026-08-04T00:00:00.000Z"Yes——
documentVersion"1.2"Yes——
policyId"supanova-permissionless-curve-launch"Yes——
policyVersion"3"Yes——
updatedAt"2026-08-12T00:00:00.000Z"Yes——

Additional fields are not allowed.

Schema 17

Response 201 variant 1.media

Type: object.

FieldTypeRequiredConstraintsDescription
bannerone or more variants · Schema 40Yes——
iconobject · Schema 41Yes——

Additional fields are not allowed.

Schema 18

Response 201 variant 1.metadata

Type: object.

FieldTypeRequiredConstraintsDescription
bannerMediaIdstringNoformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
categorystringYesallowed: "defi", "payments", "infrastructure", "real_world_assets", "capital_markets", "stablecoins", "identity_compliance", "data_oracles", "consumer", "culture", "other"—
descriptionstringYesmin length: 30; max length: 1200—
docsstringNoformat: 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.
iconMediaIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
namestringYesmin length: 2; max length: 32—
socialReferencesobject · Schema 9No——
summarystringYesmin length: 10; max length: 120—
tickerstringYespattern: ^[A-Z0-9]{1,16}$—
websitestringNoformat: 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.

Additional fields are not allowed.

Schema 19

Response 201 variant 1.openingBuy

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: object · Schema 42.
  • Variant 2: null.

Schema 20

Response 201 variant 1.policy

Type: object.

FieldTypeRequiredConstraintsDescription
documentobject · Schema 43Yes——
hash"sha256:c843cc6204a25e687e40fff5f8033416031fb28d191f40b00e530855d70dd0ce"Yes——
id"supanova-permissionless-curve-launch"Yes——
immutabletrueYes——
version"3"Yes——

Additional fields are not allowed.

Schema 21

Response 201 variant 1.proposedInstrument

Type: object.

FieldTypeRequiredConstraintsDescription
instrumentIdobject · Schema 44Yes——
standard"CIP-0056"Yes——
status"proposed"Yes——

Additional fields are not allowed.

Schema 22

Response 201 variant 1.rewardRoutingPolicy

Type: object.

FieldTypeRequiredConstraintsDescription
authorityobject · Schema 45Yes——
beneficiaryobject · Schema 46Yes——
hash"sha256:fe83c99bff082060a46d8a30ea9de61fc1f165ccd2c28c595b85f393accd86dd"Yes——
id"supanova-token-launch-reward-routing"Yes——
immutabletrueYes——
privacyobject · Schema 47Yes——
settlementobject · Schema 48Yes——
version"1"Yes——

Additional fields are not allowed.

Schema 23

Response 201 variant 1.walletContext

Type: object.

FieldTypeRequiredConstraintsDescription
creatorPartyIdstringYesmin length: 3; max length: 512Opaque, case-sensitive Canton Party ID containing 3-512 Unicode scalar values with no normalization, edge whitespace, or C0/C1 control characters.
networkIdstringYespattern: ^canton:[-_a-zA-Z0-9]{1,32}$—
walletConnectionIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—

Additional fields are not allowed.

Schema 24

Response 201 variant 2.allocation

Type: object.

FieldTypeRequiredConstraintsDescription
curveAllocationstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
dexAllocationstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 25

Response 201 variant 2.curvePolicy

Type: object.

FieldTypeRequiredConstraintsDescription
hash"sha256:f0cf06fab397cb2593557dcc8d90701becc653607388286ddbe51a91be73144c"Yes——
id"supanova-curve-launch-policy"Yes——
version"1"Yes——

Additional fields are not allowed.

Schema 26

Response 201 variant 2.display

Type: object.

FieldTypeRequiredConstraintsDescription
openingPriceCcPerTokenstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$—
openingPricePerMillionTokensCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$—
smallestSellableLotTokensstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$—
terminalPriceCcPerTokenstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$—
terminalPricePerMillionTokensCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$—

Additional fields are not allowed.

Schema 27

Response 201 variant 2.economics

Type: object.

FieldTypeRequiredConstraintsDescription
curveAllocationBpsintegerYesminimum: 5001; maximum: 9999—
graduationNetCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
maxFeeBpsintegerYesminimum: 0; maximum: 5000—
minFeeClaimCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 28

Response 201 variant 2.feeConfig

Type: object.

FieldTypeRequiredConstraintsDescription
feeBpsintegerYesminimum: 0; maximum: 5000—
platformShareBpsintegerYesminimum: 0; maximum: 10000—

Additional fields are not allowed.

Schema 29

Response 201 variant 2.fees

Type: object.

FieldTypeRequiredConstraintsDescription
creationFeeCc"25"Yes——
openingTradingFeeCc"0"Yes——
totalDebitCc"25"Yes——

Additional fields are not allowed.

Schema 30

Response 201 variant 1.creatorRevenuePolicy.attribution

Type: object.

FieldTypeRequiredConstraintsDescription
featuredApp"authoritative-cc-event-uniquely-correlated-to-one-accepted-launch-instrument-only"Yes——
reversal"append-only-exact-opposite-once-and-only-before-any-distribution-allocation"Yes——
routedTokenToToken"one-source-event-per-supaswap-leg-attributed-to-that-leg-token-launch"Yes——
unattributedActivity"reject-never-api-prorate"Yes——

Additional fields are not allowed.

Schema 31

Response 201 variant 1.creatorRevenuePolicy.eligibility

Type: object.

FieldTypeRequiredConstraintsDescription
activation"exact-policy-accepted-launches-only-no-retroactive-attribution"Yes——
beneficiary"immutable-token-launch-reward-route-party"Yes——
rewardDestination"creator"Yes——
traderCashback"ineligible-pending-explicit-product-decision"Yes——

Additional fields are not allowed.

Schema 32

Response 201 variant 1.creatorRevenuePolicy.numericDomain

Type: object.

FieldTypeRequiredConstraintsDescription
dust"reject-if-gross-or-creator-rounds-to-zero"Yes——
maximumBasisAmountCc"999999999999999999999999.9999999999"Yes——

Additional fields are not allowed.

Schema 33

Response 201 variant 1.creatorRevenuePolicy.rounding

Type: object.

FieldTypeRequiredConstraintsDescription
grossRevenue"round10-half-even(source-basis-cc*source-rate)"Yes——
split"creator=round10-half-even(gross-revenue-cc*creator-share-rate);protocol=gross-revenue-cc-creator-revenue-cc"Yes——

Additional fields are not allowed.

Schema 34

Response 201 variant 1.creatorRevenuePolicy.settlement

Type: object.

FieldTypeRequiredConstraintsDescription
execution"not-enabled"Yes——
featuredAppExternalPartyRequirement"beneficiary-mint-delegation-or-manual-mint-each-round-required"Yes——
legalApproval"required-before-live"Yes——
readiness"canton-attribution-and-distribution-writers-not-configured"Yes——

Additional fields are not allowed.

Schema 35

Response 201 variant 1.creatorRevenuePolicy.sources

Type: array of unspecified.

min items: 3; max items: 3

Tuple positions (in order):

  1. object · Schema 49.
  2. object · Schema 50.
  3. object · Schema 51.

Schema 36

Response 201 variant 1.damlRewardRouting.creatorRewardBeneficiary

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: string. min length: 3; max length: 512
  • Variant 2: null.

Schema 37

Response 201 variant 1.economics.curve

Type: object.

FieldTypeRequiredConstraintsDescription
finalFillPolicy"reject-overfill-and-unexecutable-remainder"Yes——
formulaId"supanova-virtual-cpmm-v1"Yes——
initialVirtualCcReserve"83333.3333333333"Yes——
initialVirtualTokenReserve"1066666666.6666666667"Yes——
minimumGrossBuyCc"0.01"Yes——
minimumGrossSellCc"0.0099"Yes——
minimumNetBuyCc"0.0099"Yes——
nonTerminalMaxGraduationPercent"99.9999999999"Yes——
numericScale10Yes——
openingMarginalPriceCcPerToken"0.000078125"Yes——
roundingPolicy"ledger-decimal10-half-even-each-operation"Yes——
sellResidualPolicy"reject-nonzero-reserve-below-minimum-gross-sell"Yes——
terminalMarginalPriceCcPerToken"0.00125"Yes——

Additional fields are not allowed.

Schema 38

Response 201 variant 1.economics.graduation

Type: object.

FieldTypeRequiredConstraintsDescription
acceptedReserveDepthDropBps"2500"Yes——
feeTreatment"outside-active-reserve"Yes——
firstOrderPriceImpactMultiplier"1.3333333333"Yes——
initialDexCcReserve"250000"Yes——
initialDexTokenReserve"200000000"Yes——
postGraduationReserveScale"0.75"Yes——
priceContinuity"ratio-matched"Yes——
reserveDepthContinuityfalseYes——
terminalVirtualCcReserve"333333.3333333333"Yes——
terminalVirtualTokenReserve"266666666.6666666667"Yes——
trigger"curve-inventory-exhausted-and-net-cc-reserve-reached"Yes——
virtualReservesMigratedfalseYes——

Additional fields are not allowed.

Schema 39

Response 201 variant 1.economics.postGraduationAmm

Type: object.

FieldTypeRequiredConstraintsDescription
authorizationMaxTtlSeconds900Yes——
feeobject · Schema 52Yes——
formulaId"supanova-real-cpmm-v1"Yes——
goldenManifestDigest"sha256:7fc5b0d592eaf85cb083775101efe73a099b404e6334cd85ac1683ac753626d0"Yes——
initialRealCcReserve"250000"Yes——
initialRealTokenReserve"200000000"Yes——
invariantobject · Schema 53Yes——
lifecycle"atomic-graduation-seed-then-revisioned-real-reserve"Yes——
minimumGrossBuyCc"0.01"Yes——
minimumGrossSellCc"0.0099"Yes——
minimumGrossSellDerivation"gross-cc-from-reserve-before-fee"Yes——
numericScale10Yes——
roundingobject · Schema 54Yes——
rootUniquenessAssumption"participant-inventory-and-submission-policy-required"Yes——
settlementReadiness"external-settlement-adapter-unproven"Yes——

Additional fields are not allowed.

Schema 40

Response 201 variant 1.media.banner

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: object · Schema 41.
  • Variant 2: null.

Schema 41

Response 201 variant 1.media.icon

Type: object.

FieldTypeRequiredConstraintsDescription
contentTypestringYesallowed: "image/gif", "image/jpeg", "image/png", "image/webp", "video/mp4"—
dataModestringYesallowed: "durable", "simulated"—
heightone or more variants · Schema 55Yes——
mediaIdstringYesformat: uuid; pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$—
publicUrlone or more variants · Schema 56Yes——
rolestringYesallowed: "token_banner", "token_icon"—
sha256stringYespattern: ^[0-9a-f]{64}$—
sizeBytesintegerYesminimum: -9007199254740991; maximum: 9007199254740991—
statusstringYesallowed: "preview_accepted", "published", "quarantined", "rejected", "taken_down"—
storagestringYesallowed: "discarded-preview", "removed", "supabase-private", "supabase-public", "supabase-quarantine"—
widthone or more variants · Schema 55Yes——

Additional fields are not allowed.

Schema 42

Response 201 variant 1.openingBuy variant 1

Type: object.

FieldTypeRequiredConstraintsDescription
averagePriceCcPerTokenstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
creatorRevenueAllocationexactly one variant · Schema 57Yes——
grossCcAmountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
inputAmountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
inputUnitstringYesallowed: "cc", "token"—
netCcToCurvestringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
priceImpactBpsstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
stateAfterobject · Schema 58Yes——
tokenAmountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
tradingFeeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 43

Response 201 variant 1.policy.document

Type: object.

FieldTypeRequiredConstraintsDescription
documentSetDigest"sha256:334747f374e7ba4ae02b71918bd94f5d4400b19b20997244ccdf7550719296ff"Yes——
documentsarray of unspecified · Schema 59Yesmin items: 3; max items: 3—
effectiveAt"2026-08-04T00:00:00.000Z"Yes——
updatedAt"2026-08-12T00:00:00.000Z"Yes——
version"1.2"Yes——

Additional fields are not allowed.

Schema 44

Response 201 variant 1.proposedInstrument.instrumentId

Type: object.

FieldTypeRequiredConstraintsDescription
adminstringYesmin length: 1; max length: 512—
idstringYesmin length: 1; max length: 512—

Additional fields are not allowed.

Schema 45

Response 201 variant 1.rewardRoutingPolicy.authority

Type: object.

FieldTypeRequiredConstraintsDescription
prepareRevalidation"exact-active-verified-wallet-context"Yes——
quoteBinding"verified-wallet-connection-party-and-network"Yes——
quoteReuse"single-operation-idempotency-key"Yes——

Additional fields are not allowed.

Schema 46

Response 201 variant 1.rewardRoutingPolicy.beneficiary

Type: object.

FieldTypeRequiredConstraintsDescription
identity"opaque-case-sensitive-canton-party-id"Yes——
routesobject · Schema 60Yes——

Additional fields are not allowed.

Schema 47

Response 201 variant 1.rewardRoutingPolicy.privacy

Type: object.

FieldTypeRequiredConstraintsDescription
partyIdentifiers"backend-and-entitled-ledger-projection-only"Yes——

Additional fields are not allowed.

Schema 48

Response 201 variant 1.rewardRoutingPolicy.settlement

Type: object.

FieldTypeRequiredConstraintsDescription
execution"not-enabled"Yes——
readiness"daml-command-builder-not-configured"Yes——

Additional fields are not allowed.

Schema 49

Response 201 variant 1.creatorRevenuePolicy.sources position 1

Type: object.

FieldTypeRequiredConstraintsDescription
basis"gross-curve-trade-notional-cc"Yes——
creatorShareRate"0.80"Yes——
id"virtual-curve-trading-fee"Yes——
protocolShareRate"0.20"Yes——
revenueRate"0.01"Yes——
settlementStrategy"accounted-then-ledger-distribution"Yes——

Additional fields are not allowed.

Schema 50

Response 201 variant 1.creatorRevenuePolicy.sources position 2

Type: object.

FieldTypeRequiredConstraintsDescription
basis"gross-supaswap-trade-notional-cc"Yes——
creatorShareRate"0.80"Yes——
id"supaswap-amm-trading-fee"Yes——
protocolShareRate"0.20"Yes——
revenueRate"0.01"Yes——
settlementStrategy"accounted-then-ledger-distribution"Yes——

Additional fields are not allowed.

Schema 51

Response 201 variant 1.creatorRevenuePolicy.sources position 3

Type: object.

FieldTypeRequiredConstraintsDescription
basis"coin-attributable-featured-app-reward-cc"Yes——
creatorShareRate"0.50"Yes——
id"featured-app-cc-reward"Yes——
protocolShareRate"0.50"Yes——
revenueRate"1.00"Yes——
settlementStrategy"weighted-featured-app-marker-direct"Yes——

Additional fields are not allowed.

Schema 52

Response 201 variant 1.economics.postGraduationAmm.fee

Type: object.

FieldTypeRequiredConstraintsDescription
asset"cc"Yes——
buySide"deduct-from-gross-before-cc-enters-pool"Yes——
policy"outside-active-reserves"Yes——
rate"0.01"Yes——
routing"creator-revenue-policy-outside-pool"Yes——
sellSide"deduct-from-gross-cc-after-cc-leaves-pool"Yes——

Additional fields are not allowed.

Schema 53

Response 201 variant 1.economics.postGraduationAmm.invariant

Type: object.

FieldTypeRequiredConstraintsDescription
anchor"50000000000000"Yes——
anchorRelation"initial=exact-seed;buy=tokenReserve==round10(k/ccReserve);sell=ccReserve==round10(k/tokenReserve)"Yes——
driftPolicy"reject-any-noncanonical-anchor-relation"Yes——
transition"oppositeReserve=round10(k/nextInputReserve)"Yes——

Additional fields are not allowed.

Schema 54

Response 201 variant 1.economics.postGraduationAmm.rounding

Type: object.

FieldTypeRequiredConstraintsDescription
buyGrouping"fee=round10(gross*rate);net=round10(gross-fee);x1=round10(x+net);y1=round10(k/x1);out=round10(y-y1)"Yes——
mode"ledger-decimal10-half-even-per-operation"Yes——
sellGrouping"y1=round10(y+tokenIn);x1=round10(k/y1);gross=round10(x-x1);fee=round10(gross*rate);net=round10(gross-fee)"Yes——

Additional fields are not allowed.

Schema 55

Response 201 variant 1.media.icon.height

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: integer. minimum: -9007199254740991; maximum: 9007199254740991
  • Variant 2: null.

Schema 56

Response 201 variant 1.media.icon.publicUrl

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: string. format: uri
  • Variant 2: null.

Schema 57

Response 201 variant 1.openingBuy variant 1.creatorRevenueAllocation

Type: exactly one variant.

Exactly one of these variants must match:

Schema 58

Response 201 variant 1.openingBuy variant 1.stateAfter

Type: object.

FieldTypeRequiredConstraintsDescription
formulaId"supanova-virtual-cpmm-v1"Yes——
graduatedbooleanYes——
graduationPercentstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
marginalPriceCcPerTokenstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
netCcReservestringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
tokensRemainingstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
tokensSoldstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 59

Response 201 variant 1.policy.document.documents

Type: array of unspecified.

min items: 3; max items: 3

Tuple positions (in order):

  1. object · Schema 63.
  2. object · Schema 64.
  3. object · Schema 65.

Schema 60

Response 201 variant 1.rewardRoutingPolicy.beneficiary.routes

Type: object.

FieldTypeRequiredConstraintsDescription
creatorobject · Schema 66Yes——
trader_cashbackobject · Schema 67Yes——

Additional fields are not allowed.

Schema 61

Response 201 variant 1.openingBuy variant 1.creatorRevenueAllocation variant 1

Type: object.

FieldTypeRequiredConstraintsDescription
basisAmountCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
creatorRevenueCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
eligibility"eligible"Yes——
grossRevenueCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
lineage"bind-on-confirmed-launch-route"Yes——
policyobject · Schema 68Yes——
protocolRevenueCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
source"virtual-curve-trading-fee"Yes——

Additional fields are not allowed.

Schema 62

Response 201 variant 1.openingBuy variant 1.creatorRevenueAllocation variant 2

Type: object.

FieldTypeRequiredConstraintsDescription
eligibility"ineligible"Yes——
reason"trader-cashback"Yes——

Additional fields are not allowed.

Schema 63

Response 201 variant 1.policy.document.documents position 1

Type: object.

FieldTypeRequiredConstraintsDescription
digest"sha256:ae3001c9110291ba6d97fe27343218a23ec93427ac7f7654e45e77b3fe08523d"Yes——
slug"terms"Yes——

Additional fields are not allowed.

Schema 64

Response 201 variant 1.policy.document.documents position 2

Type: object.

FieldTypeRequiredConstraintsDescription
digest"sha256:44b4ddbc306824bc9c44f1f2c57892169b3fa737df453897c66f36c8127123f5"Yes——
slug"launch-terms"Yes——

Additional fields are not allowed.

Schema 65

Response 201 variant 1.policy.document.documents position 3

Type: object.

FieldTypeRequiredConstraintsDescription
digest"sha256:3d54b4c54d38211c9cb5b5789e97607bd7c49157f7cff5928d2e348c66d04c84"Yes——
slug"risk"Yes——

Additional fields are not allowed.

Schema 66

Response 201 variant 1.rewardRoutingPolicy.beneficiary.routes.creator

Type: object.

FieldTypeRequiredConstraintsDescription
external"must-differ-from-launcher-party"Yes——
launcher"must-equal-launcher-party"Yes——
partyId"required"Yes——

Additional fields are not allowed.

Schema 67

Response 201 variant 1.rewardRoutingPolicy.beneficiary.routes.trader_cashback

Type: object.

FieldTypeRequiredConstraintsDescription
partyId"forbidden"Yes——
partySource"forbidden"Yes——

Additional fields are not allowed.

Schema 68

Response 201 variant 1.openingBuy variant 1.creatorRevenueAllocation variant 1.policy

Type: object.

FieldTypeRequiredConstraintsDescription
hash"sha256:a926e0a380b3938648b5fa9898136638e1276128947cf94033e760f87a27e8b2"Yes——
id"supanova-creator-revenue-policy"Yes——
version"1"Yes——

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.

Generated from the public API contractDeveloper settings