> ## 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.
# Get Token Price (Batch)
> Retrieve real-time DeFi pool-based token prices, market cap, and liquidity for up to 500 tokens in a single request.
### Request Body
```json theme={null}
{
"items": [
{ "address": "So11111111111111111111111111111111111111112", "blockchain": "Solana" },
{ "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "blockchain": "Solana" }
]
}
```
| Field | Type | Description |
| -------------------- | ------ | -------------------------------- |
| `items` | array | Array of token objects (max 500) |
| `items[].address` | string | Token contract address |
| `items[].blockchain` | string | Optional blockchain name or ID |
Maximum **500 tokens** per request. For larger datasets, split into multiple requests.
### Response Format
| Field | Type | Description |
| --------------------- | ---------------- | -------------------------------------- |
| `priceUSD` | `number \| null` | Current token price in USD |
| `marketCapUSD` | `number \| null` | Market cap based on circulating supply |
| `marketCapDilutedUSD` | `number \| null` | Fully diluted market cap |
| `liquidityUSD` | `number \| null` | Current liquidity in USD |
| `liquidityMaxUSD` | `number \| null` | Maximum liquidity across all pools |
| `name` | `string \| null` | Token name |
| `symbol` | `string \| null` | Token symbol |
| `logo` | `string \| null` | Token logo URL |
### Usage Examples
```bash theme={null}
curl -X POST "https://api.mobula.io/api/2/token/price" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "address": "So11111111111111111111111111111111111111112", "blockchain": "Solana" },
{ "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "blockchain": "Solana" }
]
}'
```
### Example Response
```json theme={null}
{
"payload": [
{
"name": "Wrapped SOL",
"symbol": "SOL",
"logo": "https://...",
"priceUSD": 187.45,
"marketCapUSD": 91000000000,
"marketCapDilutedUSD": 110000000000,
"liquidityUSD": 250000000,
"liquidityMaxUSD": 300000000
},
{
"name": "USD Coin",
"symbol": "USDC",
"logo": "https://...",
"priceUSD": 1.0,
"marketCapUSD": 45000000000,
"marketCapDilutedUSD": 45000000000,
"liquidityUSD": 500000000,
"liquidityMaxUSD": 600000000
}
]
}
```
All market data fields are nullable - tokens without supply data will return `null` for market cap fields.
## OpenAPI
````yaml post /2/token/price
openapi: 3.0.0
info:
version: 1.0.0
title: Mobula API
description: >-
Documentation of the Mobula API
**Demo API**: The default server (demo-api.mobula.io) is a demo API with
rate limits.
For production use, please use api.mobula.io with an API key from
https://admin.mobula.io
servers:
- url: https://demo-api.mobula.io/api/
description: Demo API (rate limited, for testing only)
- url: https://api.mobula.io/api/
description: Production API (requires API key)
security: []
tags:
- name: V2 - Token
description: Token details, price, security, ATH, and holder data
- name: V2 - Market Data
description: Market details, OHLCV history, and lighthouse metrics
- name: V2 - Trades
description: Token trades, enriched trades, and trade filters
- name: V2 - Wallet
description: Wallet positions, activity, trades, analysis, and labels
- name: V2 - Assets
description: Cross-chain asset details and price history
- name: V2 - Swap
description: Swap quoting and execution
- name: V2 - Perps
description: Perpetual futures quoting, execution, and positions
- name: V2 - Bridge
description: Cross-chain bridge quoting and intent status (Alpha Preview)
- name: V2 - DeFi
description: Bonding pools and pulse data
- name: V2 - Search
description: Universal fast search
- name: V2 - Blockchains
description: System metadata and chain listings
- name: V1 - Market Data
description: Market prices, history, sparklines, pairs, and multi-data
- name: V1 - Wallet
description: Wallet portfolio, transactions, history, and NFTs
- name: V1 - Token
description: First buyers
- name: V1 - Trades
description: Market trades by pair
- name: V1 - Metadata
description: Token metadata, categories, trendings, and news
- name: V1 - Assets
description: List all assets
- name: V1 - Search
description: Search for assets, tokens, and pairs
- name: V1 - DeFi
description: Bonding pool pulse data
- name: V1 - Blockchains
description: Blockchain listings, pairs, and stats
- name: V1 - Webhooks
description: Webhook management
- name: V1 - Feed
description: Custom feed creation
paths:
/2/token/price:
post:
tags:
- V2 - Token
summary: Get current token price (batch)
description: >-
Fetch current price, market cap, liquidity and other market data for
multiple tokens in a single batch. Returns data with USD suffix naming
convention. Max 500 items per request. For historical point-in-time
prices, use `POST /2/token/price-at`.
requestBody:
content:
application/json:
schema:
anyOf:
- type: array
items:
type: object
properties:
chainId:
type: string
blockchain:
type: string
address:
type: string
- type: object
properties:
items:
type: array
items:
type: object
properties:
chainId:
type: string
blockchain:
type: string
address:
type: string
required:
- items
responses:
'200':
description: Token price batch response
content:
application/json:
schema:
type: object
properties:
payload:
type: array
items:
anyOf:
- type: object
properties:
name:
type: string
nullable: true
symbol:
type: string
nullable: true
logo:
type: string
nullable: true
priceUSD:
type: number
nullable: true
marketCapUSD:
type: number
nullable: true
marketCapDilutedUSD:
type: number
nullable: true
liquidityUSD:
type: number
nullable: true
liquidityMaxUSD:
type: number
nullable: true
required:
- name
- symbol
- logo
- priceUSD
- marketCapUSD
- marketCapDilutedUSD
- liquidityUSD
- liquidityMaxUSD
- type: object
properties:
error:
type: string
- nullable: true
required:
- payload
````