Price charts, the screener and wallet pages read from a separate datafeed service, not from the REST API. These endpoints issue the JWTs that service accepts.
A chart token is scoped to the mint of a launch the caller owns or holds a share on and authenticates the datafeed WebSocket for that mint. An unscoped token is issued to the account for the screener or the wallet reads. The web app decodes each token's exp claim to renew it before it lapses.
Create a chart token
/charts/{launch_id}/subscribe Issues a datafeed token scoped to the mint of a launch the caller owns or holds a share on.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry Each call issues a new token and may register the token's pools with the indexer again; nothing else changes.
The token is a JWT whose mint claim names the launch's token; the web app uses it to authenticate the datafeed WebSocket for that mint and calls this endpoint again when a renewal is due. The call also registers the token's pools with the indexer.
The SDK retries when the response carries no token or the call fails, up to maxRetries times (default 5) with a linear backoff of 1 s, 2 s, 3 s... The datafeed provider passes maxRetries = 0 and runs its own exponential backoff instead.
Path parameters
-
launch_idstring RequiredThe launchext_id.Example101920010239643
Returns 200 OK · application/json
-
okbooleantrueon success. -
chainstringChain ID of the launch. -
mintstringToken mint or contract address the token is scoped to. -
tokenstringDatafeed JWT carryingmintandexpclaims. Valid for one week.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id. |
| 403 | forbidden | The caller reaches the launch through a share that does not carry launch.read. Ask the owner to add launch.read to your grant. |
| 404 | not_found | The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the ext_id against your own launches and List launches shared with you. |
| 404 | not_found | The launch is on an EVM chain and its token is not deployed yet. Request the token again with backoff once the deploy has landed. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.charts.subscribe(launchId, options, maxRetries) src/lib/proxima/endpoints/charts.ts
Create an unscoped datafeed token
/charts/{audience}/token Issues a five-minute datafeed token to the account for the screener or the wallet reads.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry Each call issues a new token and counts toward the limit of 30 per minute.
The SDK throws when the response has no token, and defaults expires_in to 300 when it is missing. The app caches the token and fetches a new one 60 seconds before exp, or immediately when the datafeed answers 401.
Path parameters
-
audienceenum RequiredDatafeed audience the token is issued for.Possible valuesscreenerwallet
Returns 200 OK · application/json
-
tokenstringDatafeed JWT. -
expires_inintegerLifetime in seconds.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 403 | forbidden | audience is screener and the caller is not an admin. Call it with an admin account's session. |
| 403 | forbidden | audience is wallet and the caller is not an admin. Call it with an admin account's session. |
| 429 | too_many_requests | More than 30 tokens for this audience in a minute for this account. For wallet, the message names wallet_token. Reuse the token until 60 seconds before its exp. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.charts.unscopedToken(audience) src/lib/proxima/endpoints/charts.ts