Skip to main content
GET
Get token price

Get Price

GET /api/v1/price/:mint returns the current spot USD price for a token, derived entirely from live on-chain pool state — there is no external price feed.
This is a spot/mid price oracle, distinct from GET /api/v1/quote, which returns a size- and slippage-aware execution price for a specific amount. Use /price for display (portfolio values, token lists); use /quote before a swap.

How prices are derived

  • Stablecoins are worth $1.
  • The native token (FOGO) is priced from the deepest native↔stablecoin pool.
  • Every other token is priced from its deepest anchor-paired pool (paired with a stablecoin or FOGO). Using the deepest pool by liquidity prevents a thin or seeded pool from skewing the price.
A token returns price: 0 until an anchor-paired pool for it has been observed (and its decimals resolved). slot and updatedAt are 0 in that case.

Single lookup

string
required
Token mint address (base58-encoded public key).
cURL

Batch lookup

Fetch up to 100 prices in one call with a comma-separated mints query parameter.
string
required
Comma-separated token mint addresses (base58), max 100.
cURL

Response fields

string
The token mint address.
number
Spot USD price. 0 when no price is known yet (no anchor-paired pool observed, or decimals pending).
integer
Fogo slot the price was derived at. 0 for the constant stablecoin price or an unknown token.
integer
Unix seconds when the price was last updated. 0 for constants/unknowns — use it to detect staleness.

Headers

Authorization
string

Optional API key: Bearer vulcx_.... Anonymous calls are allowed but capped at a small per-IP rate limit — see Rate limits.

Example:

"Bearer vulcx_..."

Path Parameters

mint
string
required

Token mint address (base58-encoded public key).

Example:

"So11111111111111111111111111111111111111112"

Response

Price retrieved successfully.

success
boolean
Example:

true

data
object

Spot USD price for a single token.

Last modified on August 31, 2026