Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

Charts

Issue the short-lived tokens that authenticate the charts datafeed.

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.

GET /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_id string Required
    The launch ext_id.
    Example101920010239643

Returns 200 OK · application/json

  • ok boolean
    true on success.
  • chain string
    Chain ID of the launch.
  • mint string
    Token mint or contract address the token is scoped to.
  • token string
    Datafeed JWT carrying mint and exp claims. Valid for one week.

Errors

StatusCodeWhen 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

GET /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

  • audience enum Required
    Datafeed audience the token is issued for.
    Possible values screenerwallet

Returns 200 OK · application/json

  • token string
    Datafeed JWT.
  • expires_in integer
    Lifetime in seconds.

Errors

StatusCodeWhen 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