Solana Token Details API (Token-2022 & SPL)

Get complete token metadata and real-time metrics for any Solana token, including price, trading volume, market cap, FDV, holder count, and supply data. All data is sourced from vetted liquidity pools to eliminate fake wicks and wash trading, ensuring accurate and reliable analytics.

Ideal for building token profile pages, dashboards, trading terminals, and research tools that require a single, trusted source of token information.

Why This Endpoint?

When building token analytics, trading terminals, or research tools, you need a single source of truth for token data. The token details endpoint provides:

Accurate pricing from vetted liquidity pools (no fake wicks)
Volume metrics that exclude wash trading
Holder statistics updated every 3 hours
Supply information including circulating, total, and max supply
Metadata including logos, descriptions, and social links
Verification status to identify legitimate tokens

One API call gives you everything needed to render a complete token profile.

Endpoint

GET /tokens/{mintAddress}

Parameters

Parameter	Type	Description
`mintAddress`	string	Token mint public key (required)

Demo for Token Stats & Metadata API

The free live demo for these endpoints can be found here:

Live demo: https://solana-token-stats-metadata-api.vybenetwork.com
GitHub repo: https://github.com/vybenetwork/solana-token-stats-metadata-api

You can visit this link to access and try the demo: https://solana-token-stats-metadata-api.vybenetwork.com

Example Request

curl "https://api.vybenetwork.com/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -H "X-API-Key: YOUR_API_KEY"

Example Response

{
  "mintAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "name": "USD Coin",
  "symbol": "USDC",
  "decimals": 6,
  "logoUrl": "https://raw.githubusercontent.com/.../usdc.png",
  "description": "USDC is a fully collateralized US dollar stablecoin.",
  "website": "https://www.circle.com/usdc",
  "twitter": "https://twitter.com/circle",
  "verified": true,
  "price": "1.00",
  "priceChange1h": "0.0%",
  "priceChange24h": "-0.01%",
  "priceChange7d": "+0.02%",
  "volume24h": "2345678901.23",
  "volumeChange24h": "+15.4%",
  "marketCap": "34567890123.45",
  "fdv": "34567890123.45",
  "holders": 2345678,
  "holdersChange24h": "+1234",
  "circulatingSupply": "34567890123.45",
  "totalSupply": "34567890123.45",
  "maxSupply": null,
  "poolCount": 234,
  "lastUpdated": "2024-01-15T12:00:00Z"
}

Response Fields Explained

Pricing Data

Field	Description
`price`	Current USD price from vetted pools
`priceChange1h`	Price change in the last hour
`priceChange24h`	Price change in the last 24 hours
`priceChange7d`	Price change in the last 7 days

Volume & Market Data

Field	Description
`volume24h`	24-hour trading volume in USD
`volumeChange24h`	Volume change vs previous 24h
`marketCap`	Circulating supply × current price
`fdv`	Fully diluted valuation (total supply × price)
`poolCount`	Number of active liquidity pools

Holder Data

Field	Description
`holders`	Current number of unique holders
`holdersChange24h`	Change in holder count (24h)

Supply Data

Field	Description
`circulatingSupply`	Tokens currently in circulation
`totalSupply`	Total minted tokens
`maxSupply`	Maximum possible supply (null if unlimited)

Metadata

Field	Description
`name`	Full token name
`symbol`	Token ticker symbol
`decimals`	Token decimal places
`logoUrl`	Token logo image URL
`description`	Token description
`website`	Official website
`twitter`	Twitter/X handle
`verified`	Whether token is verified

Token List Endpoint

To browse all tracked tokens with sorting and pagination:

GET /tokens

curl "https://api.vybenetwork.com/tokens?sortByDesc=volume24h&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Sort Options

Field	Description
`price`	Sort by current price
`volume24h`	Sort by 24-hour trading volume
`marketCap`	Sort by market capitalization
`holders`	Sort by number of holders
`name`	Sort alphabetically by name
`symbol`	Sort alphabetically by symbol

Common Use Cases

Use Case	Implementation
Token Profile Page	Display comprehensive token analytics
Token Screener	Filter and sort tokens by metrics
Watchlist	Track favorite tokens
Research Tool	Analyze fundamentals for due diligence
Trading Terminal	Show token info alongside charts
Alert System	Monitor price/volume/holder changes

Token Dashboard Example

async function getTokenDashboard(mintAddress) {
  const response = await fetch(
    `https://api.vybenetwork.com/tokens/${mintAddress}`,
    { headers: { "X-API-Key": API_KEY } }
  );
  const token = await response.json();
  
  // Format for display
  const formatNumber = (n) => {
    if (n >= 1e9) return `$${(n / 1e9).toFixed(2)}B`;
    if (n >= 1e6) return `$${(n / 1e6).toFixed(2)}M`;
    if (n >= 1e3) return `$${(n / 1e3).toFixed(2)}K`;
    return `$${n.toFixed(2)}`;
  };
  
  return {
    // Header
    name: token.name,
    symbol: token.symbol,
    logo: token.logoUrl,
    verified: token.verified,
    
    // Price section
    price: `$${parseFloat(token.price).toLocaleString()}`,
    change1h: token.priceChange1h,
    change24h: token.priceChange24h,
    change7d: token.priceChange7d,
    
    // Market data
    marketCap: formatNumber(parseFloat(token.marketCap)),
    fdv: formatNumber(parseFloat(token.fdv)),
    volume24h: formatNumber(parseFloat(token.volume24h)),
    
    // Holder data
    holders: token.holders.toLocaleString(),
    holdersChange: token.holdersChange24h,
    
    // Supply
    circulatingSupply: parseFloat(token.circulatingSupply).toLocaleString(),
    totalSupply: parseFloat(token.totalSupply).toLocaleString(),
    
    // Links
    website: token.website,
    twitter: token.twitter
  };
}

Related Endpoints

Holders - Get top 1,000 holders with labels
Holder History - Track holder count over time
Token Candles - OHLCV price data for charts
Token List - Browse all tokens