> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Get In-depth Token Details Across Ethereum, Solana, BNB, Base & More

> Use the Token Details endpoint to retrieve in-depth information for a token by contract address.

The [**Get Token Details**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/UJrFOvhXb9k" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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](https://admin.mobula.io/)

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**](https://docs.mobula.io/rest-api-reference/endpoint/token-trades)

If you need top holders and holder tags, use: [**Get Token Holders**](https://docs.mobula.io/rest-api-reference/endpoint/market-token-holders)

If you need historical prices for charting, use: [**Get Asset Price History**](https://docs.mobula.io/rest-api-reference/endpoint/asset-price-history)

***

## Walkthrough to Get Token Details

### 1. Prepare your query

The `token/details` endpoint requires two parameters:

| Parameter    | Description                                                    |
| ------------ | -------------------------------------------------------------- |
| `blockchain` | Blockchain identifier (example: `ethereum`, `solana`, `evm:1`) |
| `address`    | Token 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](https://mobula-demo-endpoint-production.up.railway.app/)

[Token Details Demo UI](https://mobula-demo-endpoint-production.up.railway.app/token-details)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/token-details)

***

## Summary

The [**Get Token Details**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://admin.mobula.io/)