supanovasupanovaDOCS
Open Launchpad
Launchpad documentation
superapp wallet

List typed transaction cards for the authenticated account.

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

Request

GET /api/v1/me/activity

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

Parameters

NameInTypeRequiredConstraintsDescription
limitqueryintegerNominimum: 1; maximum: 50; default: 20—
cursorquerystringNomin length: 1; max length: 512—
toquerystringNoformat: date-time—
fromquerystringNoformat: date-time—
statusquerystringNoallowed: "recorded", "pending", "confirmed", "failed"—
qquerystringNomin length: 1; max length: 100—
groupquerystringNoallowed: "trades", "transfers", "rewards", "launches", "deposits", "graduations"—
kindquerystringNoallowed: "buy", "sell", "swap", "send", "deposit", "launch", "graduation", "creator_reward"—
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.

cURL

bash
curl --fail-with-body --silent --show-error \
  --request GET \
  --url "https://launch-api.supanova.app/api/v1/me/activity" \
  --header "Authorization: Bearer $SUPANOVA_SESSION_TOKEN"

Responses

200

Typed, cursor-paginated activity cards.

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

Content type: application/json

Type: object.

FieldTypeRequiredConstraintsDescription
itemsarray of exactly one variant · Schema 1Yes——
metaobject · Schema 2Yes——
pageobject · Schema 3Yes——

Additional fields are not allowed.

400

Invalid activity filters or pagination cursor. Also: 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.

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 reviewed Canton activity projection is not configured. Also: 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

Response 200.items

Type: array of exactly one variant.

Array items: exactly one variant · Schema 4.

Schema 2

Response 200.meta

Type: object.

FieldTypeRequiredConstraintsDescription
asOfstringYesformat: 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)))$—
dataModestringYesallowed: "projected", "simulated"—
disclaimerstringYesmin length: 1; max length: 1024—
networkIdstringYespattern: ^canton:[-_a-zA-Z0-9]{1,32}$—
schemaVersion"1"Yes——

Additional fields are not allowed.

Schema 3

Response 200.page

Type: object.

FieldTypeRequiredConstraintsDescription
hasMorebooleanYes——
limitintegerYesminimum: 1; maximum: 50—
nextCursorone or more variants · Schema 5Yes——
totalintegerYesminimum: 0; maximum: 9007199254740991—

Additional fields are not allowed.

Schema 4

Response 200.items item

Type: exactly one variant.

Exactly one of these variants must match:

Schema 5

Response 200.page.nextCursor

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: string. max length: 512
  • Variant 2: null.

Schema 6

Response 200.items item variant 1

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 16Yes——
kind"buy"Yes——

Additional fields are not allowed.

Schema 7

Response 200.items item variant 2

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 17Yes——
kind"sell"Yes——

Additional fields are not allowed.

Schema 8

Response 200.items item variant 3

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 18Yes——
kind"swap"Yes——

Additional fields are not allowed.

Schema 9

Response 200.items item variant 4

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 19Yes——
kind"send"Yes——

Additional fields are not allowed.

Schema 10

Response 200.items item variant 5

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 20Yes——
kind"deposit"Yes——

Additional fields are not allowed.

Schema 11

Response 200.items item variant 6

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 21Yes——
kind"launch"Yes——

Additional fields are not allowed.

Schema 12

Response 200.items item variant 7

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 22Yes——
kind"graduation"Yes——

Additional fields are not allowed.

Schema 13

Response 200.items item variant 8

Type: object.

FieldTypeRequiredConstraintsDescription
displayobject · Schema 14Yes——
finalitystringYesallowed: "ledger-confirmed", "product-record", "simulated"—
idstringYesmin length: 1; max length: 128—
occurredAtstringYesformat: 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)))$—
operationIdone or more variants · Schema 15Yes——
statusstringYesallowed: "recorded", "pending", "confirmed", "failed"—
detailsobject · Schema 23Yes——
kind"creator_reward"Yes——

Additional fields are not allowed.

Schema 14

Response 200.items item variant 1.display

Type: object.

FieldTypeRequiredConstraintsDescription
primaryAmountobject · Schema 24Yes——
secondaryAmountone or more variants · Schema 25Yes——
subtitlestringYesmin length: 1; max length: 200—
titlestringYesmin length: 1; max length: 100—

Additional fields are not allowed.

Schema 15

Response 200.items item variant 1.operationId

Type: one or more variants.

At least one of these variants must match:

  • Variant 1: string. format: 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)$
  • Variant 2: null.

Schema 16

Response 200.items item variant 1.details

Type: object.

FieldTypeRequiredConstraintsDescription
feeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
notionalCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
quoteReferencestringYesmin length: 1; max length: 128—
tokenobject · Schema 26Yes——
tokenAmountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
unitPriceCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 17

Response 200.items item variant 2.details

Type: object.

FieldTypeRequiredConstraintsDescription
feeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
netProceedsCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
notionalCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
quoteReferencestringYesmin length: 1; max length: 128—
tokenobject · Schema 26Yes——
tokenAmountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
unitPriceCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 18

Response 200.items item variant 3.details

Type: object.

FieldTypeRequiredConstraintsDescription
feeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
inputobject · Schema 27Yes——
notionalCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
outputobject · Schema 27Yes——
quoteReferencestringYesmin length: 1; max length: 128—
routearray of object · Schema 28Yesmin items: 2; max items: 8—

Additional fields are not allowed.

Schema 19

Response 200.items item variant 4.details

Type: object.

FieldTypeRequiredConstraintsDescription
amountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
counterpartyHintstringYesmin length: 1; max length: 100—
instrumentIdobject · Schema 29Yes——
ccDebitCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
feeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
memoone or more variants · Schema 30Yes——
symbolstringYesmin length: 1; max length: 32—
userMemostringNomin length: 1; max length: 128—

Additional fields are not allowed.

Schema 20

Response 200.items item variant 5.details

Type: object.

FieldTypeRequiredConstraintsDescription
amountCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
sourceHintstringYesmin length: 1; max length: 100—

Additional fields are not allowed.

Schema 21

Response 200.items item variant 6.details

Type: object.

FieldTypeRequiredConstraintsDescription
creationFeeCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
launchReferencestringYesmin length: 1; max length: 128—
tokenobject · Schema 26Yes——

Additional fields are not allowed.

Schema 22

Response 200.items item variant 7.details

Type: object.

FieldTypeRequiredConstraintsDescription
graduationThresholdCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
tokenobject · Schema 26Yes——

Additional fields are not allowed.

Schema 23

Response 200.items item variant 8.details

Type: object.

FieldTypeRequiredConstraintsDescription
amountCcstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
distributionReferencestringYesmin length: 1; max length: 128—
tokenobject · Schema 26Yes——

Additional fields are not allowed.

Schema 24

Response 200.items item variant 1.display.primaryAmount

Type: object.

FieldTypeRequiredConstraintsDescription
amountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—
signstringYesallowed: "credit", "debit", "neutral"—
symbolstringYesmin length: 1; max length: 32—

Additional fields are not allowed.

Schema 25

Response 200.items item variant 1.display.secondaryAmount

Type: one or more variants.

At least one of these variants must match:

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

Schema 26

Response 200.items item variant 1.details.token

Type: object.

FieldTypeRequiredConstraintsDescription
instrumentIdobject · Schema 29Yes——
namestringYesmin length: 1; max length: 100—
slugstringYesmin length: 1; max length: 64; pattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$—
tickerstringYesmin length: 1; max length: 16—

Additional fields are not allowed.

Schema 27

Response 200.items item variant 3.details.input

Type: object.

FieldTypeRequiredConstraintsDescription
instrumentIdobject · Schema 29Yes——
slugone or more variants · Schema 31Yes——
symbolstringYesmin length: 1; max length: 32—
amountstringYespattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$—

Additional fields are not allowed.

Schema 28

Response 200.items item variant 3.details.route

Type: array of object.

min items: 2; max items: 8

Array items: object · Schema 29.

Schema 29

Response 200.items item variant 4.details.instrumentId

Type: object.

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

Additional fields are not allowed.

Schema 30

Response 200.items item variant 4.details.memo

Type: one or more variants.

At least one of these variants must match:

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

Schema 31

Response 200.items item variant 3.details.input.slug

Type: one or more variants.

At least one of these variants must match:

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

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