List the total supplies a curve launch may choose, with display opening and terminal prices and the smallest sellable lot.
GET /api/v1/token-launches/supply-options. List the total supplies a curve launch may choose, with display opening and terminal prices and the smallest sellable lot.
Request
GET /api/v1/token-launches/supply-options
The schema permits anonymous access.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
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
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/token-launches/supply-options"Responses
200
The Registrar allowed supplies under its economics, or the suggested set when the Registrar is not readable. Prices are display values with significant digits.
| Header | Type | Description |
|---|---|---|
X-Request-Id | string | Server-generated request correlation identifier to retain for support and reconciliation. |
Content type: application/json
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))$ | — |
display | object · Schema 1 | Yes | — | — |
economics | object · Schema 2 | Yes | — | — |
feeConfig | one or more variants · Schema 3 | Yes | — | — |
options | array of object · Schema 4 | Yes | max items: 64 | — |
policy | object · Schema 5 | Yes | — | — |
source | string | Yes | allowed: "registrar", "suggested" | registrar: the live Registrar allowed set and economics. suggested: the product default set under the default economics, served when the Registrar cannot be read. |
Additional fields are not allowed.
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.
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.display
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
kind | "display-only" | Yes | — | — |
significantDigits | 12 | Yes | — | — |
Additional fields are not allowed.
Schema 2
Response 200.economics
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
curveAllocationBps | integer | Yes | minimum: 5001; maximum: 9999 | — |
graduationNetCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
maxFeeBps | integer | Yes | minimum: 0; maximum: 5000 | — |
minFeeClaimCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
Additional fields are not allowed.
Schema 3
Response 200.feeConfig
Type: one or more variants.
At least one of these variants must match:
- Variant 1: object · Schema 6.
- Variant 2: null.
Schema 4
Response 200.options
Type: array of object.
max items: 64
Array items: object · Schema 7.
Schema 5
Response 200.policy
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
hash | "sha256:f0cf06fab397cb2593557dcc8d90701becc653607388286ddbe51a91be73144c" | Yes | — | — |
id | "supanova-curve-launch-policy" | Yes | — | — |
version | "1" | Yes | — | — |
Additional fields are not allowed.
Schema 6
Response 200.feeConfig variant 1
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
feeBps | integer | Yes | minimum: 0; maximum: 5000 | — |
platformShareBps | integer | Yes | minimum: 0; maximum: 10000 | — |
Additional fields are not allowed.
Schema 7
Response 200.options item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
curveAllocation | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
dexAllocation | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
display | object · Schema 8 | Yes | — | — |
totalSupply | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
Additional fields are not allowed.
Schema 8
Response 200.options item.display
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
openingPriceCcPerToken | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
openingPricePerMillionTokensCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
smallestSellableLotTokens | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
terminalPriceCcPerToken | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
terminalPricePerMillionTokensCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$ | — |
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.