Token Prices

The prices stream sends a price event when a token's price moves: its price in USD and SOL, market cap and symbol.

Channel
prices sends price events
Plans
  • FreeNot included
  • Starter and upEvery price, filters optional
History

Filters

Filters narrow prices events before they are sent to you. A filter the prices channel doesn't take is rejected with invalid_filters, not ignored.

sourcesstring[]

Filter by the venue that set the price, 1–20 names.

Use internal for SOL, USDC and USDT. Every name must be a documented source; an unknown name is rejected with invalid_filters.

All 24 values
pump_funpump_ammraydium_launchlabraydium_cpmmraydium_clmmraydium_v4meteora_dbcmeteora_damm_v2meteora_dlmmmeteora_poolsorca_whirlpoolpancakeswapjupiter_order_enginetessera_vbisonfigoonfi_v2zerofiscorchalphaqbyreal_clmmmanifestderiversebonkfuninternal

Example ["pump_fun"]

mintsstring[]

Filter to one or more token mint addresses (1–100).

SOL, USDC and USDT are accepted here, e.g. the SOL mint for SOL's own price.

Example ["EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm"]

Event fields

Every field of the price event the prices stream sends, as shown in the example.

typestring

Always "price".

sourcestring

The venue of the busiest pool in the price. "internal" for SOL, USDC and USDT, which are priced from their market USD rate rather than a trade.

mintstring

Token mint.

symbolstring | null

The token's on-chain symbol. null until the token is resolved, or when it has none.

A label, not an identity: anyone can name a token USDC, so key on mint.

priceobject

{ sol, usd }: a volume-weighted blend of the token's main pools' latest rates, fees excluded, each converted to SOL through its quote token's current price, so tokens that only trade against other tokens are priced too.

A trade worth under $1 counts toward its pool's volume but doesn't move its rate. For SOL, sol is always 1 and usd is the SOL/USD rate every token's usd is computed with, updated about every 10 seconds (at least every 60). USDC and USDT use their market rate, so a depeg shows.

marketCapUsdnumber | null

Market capitalisation in USD. null when unknown.

For SOL: circulating supply × price. For USDC and USDT: their supply on Solana only.

slotnumber

Solana slot the event landed in.

Use for ordering and gap recovery.

timestampnumber | null

When the trade behind the price happened (unix ms), so a quiet token's timestamp can be minutes or hours old.

For SOL, when the rate was published.

Last updated · Changelog