List token launches attributed to the active product account.

Request

GET /api/v1/me/created-launches

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

Parameters

Name	In	Type	Required	Constraints	Description
`X-Service-Act-As`	header	string	No	min length: `3`; max length: `512`	Service-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-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/me/created-launches" \
  --header "Authorization: Bearer $SUPANOVA_SESSION_TOKEN"

Responses

200

Owned creator launch projection.

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
`items`	array of object · Schema 1	Yes	max items: `1000`	—
`meta`	one or more variants · Schema 2	Yes	—	—

Additional fields are not allowed.

400

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

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: AUTHENTICATION_REQUIRED, INVALID_AUTHORIZATION_HEADER, INVALID_ACCESS_TOKEN, SESSION_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: ACCOUNT_RESTRICTED, ANONYMOUS_ACCOUNT_NOT_ALLOWED, API_KEY_ROUTE_NOT_ALLOWED, SERVICE_PARTY_NOT_ALLOWED, SERVICE_PRINCIPAL_NOT_ALLOWED, SIGNUP_NOT_INVITED.

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

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

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.items

Type: array of object.

max items: 1000

Array items: object · Schema 3.

Schema 2

Response 200.meta

Type: one or more variants.

At least one of these variants must match:

Variant 1: object · Schema 4.
Variant 2: object · Schema 5.

Schema 3

Response 200.items item

Type: object.

Field	Type	Required	Constraints	Description
`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))$`	—
`token`	object · Schema 6	Yes	—	—

Additional fields are not allowed.

Schema 4

Response 200.meta 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))$`	—
`dataMode`	`"simulated"`	Yes	—	—
`disclaimer`	string	Yes	min length: `1`; max length: `512`	—
`networkId`	string	Yes	pattern: `^canton:[-_a-zA-Z0-9]{1,32}$`	—
`projection`	null	Yes	—	—

Additional fields are not allowed.

Schema 5

Response 200.meta variant 2

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))$`	—
`dataMode`	`"projected"`	Yes	—	—
`disclaimer`	string	Yes	min length: `1`; max length: `512`	—
`networkId`	string	Yes	pattern: `^canton:[-_a-zA-Z0-9]{1,32}$`	—
`source`	`"confirmed-launch-operations"`	Yes	—	—

Additional fields are not allowed.

Schema 6

Response 200.items item.token

Type: object.

Field	Type	Required	Constraints	Description
`amm`	one or more variants · Schema 7	No	—	—
`art`	string	Yes	allowed: `"rings"`, `"grid"`, `"halo"`, `"waves"`, `"monolith"`, `"comet"`	—
`banner`	one or more variants · Schema 8	Yes	—	—
`bannerMimeType`	one or more variants · Schema 9	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 10	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 11	No	—	—
`creatorAvatarUrl`	one or more variants · Schema 12	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 13	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 8	Yes	—	—
`imageKind`	one or more variants · Schema 14	Yes	—	—
`imageMimeType`	one or more variants · Schema 9	Yes	—	—
`instrumentId`	object · Schema 15	Yes	—	—
`lastBuyAt`	one or more variants · Schema 16	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 17	Yes	—	—
`marketCap`	one or more variants · Schema 18	Yes	—	Fully diluted: price x launchProgress.totalSupply (equals fullyDilutedValue).
`name`	string	Yes	min length: `1`; max length: `100`	—
`palette`	array of unspecified · Schema 19	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 20	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 21	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 22	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 13	Yes	—	—

Additional fields are not allowed.

Schema 7

Response 200.items item.token.amm

Type: one or more variants.

At least one of these variants must match:

Variant 1: object · Schema 23.
Variant 2: null.

Schema 8

Response 200.items item.token.banner

Type: one or more variants.

At least one of these variants must match:

Variant 1: one or more variants · Schema 24.
Variant 2: null.

Schema 9

Response 200.items item.token.bannerMimeType

Type: one or more variants.

At least one of these variants must match:

Variant 1: string. max length: 100
Variant 2: null.

Schema 10

Response 200.items item.token.creatorRevenue

Type: exactly one variant.

Exactly one of these variants must match:

Variant 1: object · Schema 25.
Variant 2: object · Schema 26.

Schema 11

Response 200.items item.token.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 12

Response 200.items item.token.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 13

Response 200.items item.token.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 14

Response 200.items item.token.imageKind

Type: one or more variants.

At least one of these variants must match:

Variant 1: string. allowed: "image", "video"
Variant 2: null.

Schema 15

Response 200.items item.token.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 16

Response 200.items item.token.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 17

Response 200.items item.token.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 27	Yes	—	—
`totalSupply`	string	Yes	pattern: `^(?:0\|[1-9]\d{0,27})(?:\.\d{1,10})?$`	—

Additional fields are not allowed.

Schema 18

Response 200.items item.token.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 19

Response 200.items item.token.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 20

Response 200.items item.token.references

Type: array of object.

max items: 20

Array items: object · Schema 28.

Schema 21

Response 200.items item.token.sparkline

Type: array of string.

max items: 500

Array items: string. pattern: ^-?(?:0|[1-9]\d{0,27})(?:\.\d{1,40})?$

Schema 22

Response 200.items item.token.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 23

Response 200.items item.token.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 24

Response 200.items item.token.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 25

Response 200.items item.token.creatorRevenue variant 1

Type: object.

Field	Type	Required	Constraints	Description
`eligibility`	`"eligible"`	Yes	—	—
`policy`	object · Schema 29	Yes	—	—
`reason`	`"accepted-policy-creator-route"`	Yes	—	—

Additional fields are not allowed.

Schema 26

Response 200.items item.token.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 27

Response 200.items item.token.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 28

Response 200.items item.token.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 29

Response 200.items item.token.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.

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.

Request#

Parameters

cURL

Responses#

200

400

401

403

429

503

default

Nested schemas#

Schema 1

Schema 2

Schema 3

Schema 4

Schema 5

Schema 6

Schema 7

Schema 8

Schema 9

Schema 10

Schema 11

Schema 12

Schema 13

Schema 14

Schema 15

Schema 16

Schema 17

Schema 18

Schema 19

Schema 20

Schema 21

Schema 22

Schema 23

Schema 24

Schema 25

Schema 26

Schema 27

Schema 28

Schema 29

Source contract#

Request

Responses

Nested schemas

Source contract