Token Details & Metrics

Get comprehensive metadata and real-time metrics for any SPL token on Solana. This endpoint returns everything you need for a token profile page: price, volume, market cap, holder count, supply data, and social links—all sourced from vetted markets

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

ParameterTypeDescription
mintAddressstringToken mint public key (required)

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

FieldDescription
priceCurrent USD price from vetted pools
priceChange1hPrice change in the last hour
priceChange24hPrice change in the last 24 hours
priceChange7dPrice change in the last 7 days

Volume & Market Data

FieldDescription
volume24h24-hour trading volume in USD
volumeChange24hVolume change vs previous 24h
marketCapCirculating supply × current price
fdvFully diluted valuation (total supply × price)
poolCountNumber of active liquidity pools

Holder Data

FieldDescription
holdersCurrent number of unique holders
holdersChange24hChange in holder count (24h)

Supply Data

FieldDescription
circulatingSupplyTokens currently in circulation
totalSupplyTotal minted tokens
maxSupplyMaximum possible supply (null if unlimited)

Metadata

FieldDescription
nameFull token name
symbolToken ticker symbol
decimalsToken decimal places
logoUrlToken logo image URL
descriptionToken description
websiteOfficial website
twitterTwitter/X handle
verifiedWhether 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

FieldDescription
priceSort by current price
volume24hSort by 24-hour trading volume
marketCapSort by market capitalization
holdersSort by number of holders
nameSort alphabetically by name
symbolSort alphabetically by symbol

Common Use Cases

Use CaseImplementation
Token Profile PageDisplay comprehensive token analytics
Token ScreenerFilter and sort tokens by metrics
WatchlistTrack favorite tokens
Research ToolAnalyze fundamentals for due diligence
Trading TerminalShow token info alongside charts
Alert SystemMonitor 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