Skip to main content
The Get Token Details endpoint lets you retrieve in-depth token information using a contract address. This includes token metadata, supply details, market data, and volume statistics across chains like Solana, Ethereum, BNB Chain, Base, and more.

​
What this endpoint does

With this API, you can:
  • Retrieve detailed token information for a specific token by address
  • Return metadata like name, symbol, decimals, and logo
  • Include supply and market fields like total supply, circulating supply, market cap, and liquidity
  • Return volume, trades, and price change data across multiple timeframes
  • Support optional multi-currency price conversion using the currencies parameter

​
What you’ll need

  • Basic knowledge of REST APIs
  • A token contract address
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener (to quickly find token contract addresses)

​
When to use Token Details

Use this endpoint when you want to:
  • Display token metadata and market stats for a contract address
  • Check supply and market cap details, including diluted market cap
  • Track price changes and volume across multiple timeframes
  • Analyze liquidity and reserve data for a token
  • Pull token info for dashboards, watchlists, and token research pages
If you need live trades for a token or pool, use: Get Token Trades If you need top holders and holder tags, use: Get Token Holders If you need historical prices for charting, use: Get Asset Price History

​
Walkthrough to Get Token Details

​
1. Prepare your query

The token/details endpoint requires two parameters:
ParameterDescription
blockchainBlockchain identifier (example: ethereum, solana, evm:1)
addressToken contract address
Optional parameters you can use:
  • currencies: Comma-separated fiat currencies for conversion (example: EUR,USD)
    Default is USD.

​
2. Find a token address to test

To retrieve real token data:
  • Open DexScreener
  • Pick any token
  • Copy the token contract address from the token page
This address is used as the address parameter.

​
3. Fill the API form

Once your token address is ready:
  • Enter the blockchain value (example: solana)
  • Paste the token contract into the address field
  • (Optional) add currencies like currencies=EUR,USD
  • Click Send to retrieve the token details snapshot

​
Reviewing the response

Key fields you will typically use:
  • address / chainId: Token contract address and chain identifier
  • symbol / name / decimals: Core metadata for display and formatting
  • logo / originLogoUrl: Token image URLs when available
  • priceUSD: Current token price in USD
  • liquidityUSD / liquidityMaxUSD: Liquidity depth metrics
  • totalSupply / circulatingSupply: Supply figures for valuation
  • marketCapUSD / marketCapDilutedUSD: Market cap values derived from supply and price
  • priceChange*: Price change percentages across multiple timeframes
  • volume*: Volume metrics across windows like 1h, 4h, 24h
  • trades* / buys* / sells*: Trade counts split by timeframe
  • holdersCount: Estimated number of holders when available
  • socials: Website, Twitter, Telegram links when available
  • security: Basic security flags such as honeypot or malicious signals
  • organic* fields: Cleaner metrics with bot activity filtered out
Multi-currency note: If you set currencies=EUR,USD, the response adds converted fields like:
  • priceEUR
  • marketCapEUR
  • volume24hEUR

​
Try It Live with Mobula Token Details Demo (UI)

Demo UI Homepage Token Details Demo UI Docs

​
Summary

The Get Token Details endpoint helps you:
  • Retrieve metadata, supply, market cap, liquidity, and volume stats
  • Add multi-currency output using the currencies parameter
  • Use organic metrics for deeper token research
  • Visualize token snapshots instantly in the demo UI

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here