List publication-safe public trades for a token.
GET /api/v1/tokens/{slug}/trades. List publication-safe public trades for a token.
Request
GET /api/v1/tokens/{slug}/trades
The schema permits anonymous access. Supported credentials: a customer API key with read scope in X-API-Key. Deployment policy can require a key for market-data routes.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
slug | path | string | Yes | min length: 1; max length: 64; pattern: ^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$ | — |
cursor | query | string | No | min length: 1; max length: 512 | — |
limit | query | integer | No | minimum: 1; maximum: 100; default: 24 | — |
account | query | string | No | default: all; allowed: "all", "creator" | 'creator': only the launch creator's trades, over all of the token's trades. |
minNotionalCc | query | string | No | min length: 1; max length: 80; default: 0; pattern: ^(?:0|[1-9]\d*)(?:\.\d+)?$ | — |
q | query | string | No | min length: 1; max length: 64; pattern: ^[a-zA-Z0-9_-]+$ | Substring of a participantHint or publicReference. Searches only the newest 1,000 trades (of the creator with account=creator); page.search reports the window and page.total counts matches inside it. |
side | query | string | No | allowed: "buy", "sell" | — |
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
Set SLUG to the path and required query values before running this example. URL-encode path values as needed.
curl --fail-with-body --silent --show-error \
--request GET \
--url "https://launch-api.supanova.app/api/v1/tokens/${SLUG}/trades" \
--header "X-API-Key: $SUPANOVA_API_KEY"Responses
200
Public trade projection page.
| 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 | — | — |
meta | object · Schema 2 | Yes | — | — |
page | object · Schema 3 | Yes | — | — |
Additional fields are not allowed.
400
Invalid token slug, filters, or cursor. Also: VALIDATION_FAILED, AMBIGUOUS_CREDENTIALS.
| 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: API_KEY_INVALID, API_KEY_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: API_KEY_IP_NOT_ALLOWED, PRODUCT_ACCOUNT_RESTRICTED.
| 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.
404
Token not found.
| 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
The stage projection is not configured.
| 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.
Array items: object · Schema 4.
Schema 2
Response 200.meta
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
provenance | object · Schema 5 | Yes | — | — |
schemaVersion | "1" | Yes | — | — |
Additional fields are not allowed.
Schema 3
Response 200.page
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
hasMore | boolean | Yes | — | — |
limit | integer | Yes | minimum: 1; maximum: 100 | — |
nextCursor | string or null | Yes | — | — |
total | integer | Yes | minimum: 0; maximum: 9007199254740991 | — |
search | object · Schema 6 | No | — | Present only for a hint search (q): the search ran over the newest scanLimit trades, and total counts the matches inside that window, not over all trades. |
Additional fields are not allowed.
Schema 4
Response 200.items item
Type: object.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
avatarTone | integer | Yes | minimum: 0; maximum: 5 | — |
id | string | Yes | min length: 1; max length: 100 | Positional list key for this page only: it shifts as new fills arrive. Use publicReference to identify a trade. |
isCreator | boolean | Yes | — | — |
notionalCc | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
occurredAt | 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)))$ | — |
participantHint | string | Yes | pattern: ^holder_[0-9a-f]{24}$ | — |
publicReference | string | Yes | pattern: ^trade_ref_[0-9a-f]{32}$ | Stable public identifier of the trade; key, deduplicate and link on this field. |
side | string | Yes | allowed: "buy", "sell" | — |
tokenAmount | string | Yes | pattern: ^(?:0|[1-9]\d{0,27})(?:\.\d{1,10})?$ | — |
Additional fields are not allowed.
Schema 5
Response 200.meta.provenance
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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ | — |
dataMode | string | Yes | allowed: "projected", "simulated" | — |
disclaimer | string | Yes | min length: 1 | — |
label | string | Yes | min length: 1 | — |
networkId | string | Yes | pattern: ^canton:[-_a-zA-Z0-9]{1,32}$ | — |
visibility | string | Yes | allowed: "aggregated-from-entitled-views", "public-by-design" | — |
Additional fields are not allowed.
Schema 6
Response 200.page.search
Type: object.
Present only for a hint search (q): the search ran over the newest scanLimit trades, and total counts the matches inside that window, not over all trades.
| Field | Type | Required | Constraints | Description |
|---|---|---|---|---|
scanLimit | integer | Yes | maximum: 9007199254740991; greater than: 0 | Most trades one search scans. |
scanned | integer | Yes | minimum: 0; maximum: 9007199254740991 | Trades scanned for this search. |
truncated | boolean | Yes | — | True when older trades exist beyond the window; matches there are not counted. |
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.