TL;DR: New /api/2/token/price endpoint with v2 naming convention (priceUSD, marketCapUSD, etc.) and enhanced v1 multi-prices endpoint with market cap & liquidity data.
New Get Token Price Endpoint
Brand new /api/2/token/price endpoint following the v2 naming convention with USD suffix for consistency with other v2 endpoints like Get Token Details.
GET Request
GET /api/2/token/price?assets=0x123...,0x456...&blockchains=Ethereum,BSC
POST Request (Batch - up to 500 tokens)
POST /api/2/token/price
Content-Type: application/json
{
"items": [
{ "address": "0x123...", "blockchain": "Ethereum" },
{ "address": "0x456...", "blockchain": "BSC" }
]
}
{
"data": {
"0x1234...abcd": {
"name": "Token Name",
"symbol": "TKN",
"logo": "https://...",
"priceUSD": 1.23,
"marketCapUSD": 1000000,
"marketCapDilutedUSD": 1500000,
"liquidityUSD": 250000,
"liquidityMaxUSD": 300000
}
}
}
Response Fields
| 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 |
V1 Multi-Prices Enhancement
The /api/1/market/multi-prices endpoint has also been enhanced with additional fields:
| Field | Type | Description |
|---|
marketCap | number | null | Market cap based on circulating supply |
marketCapDiluted | number | null | Fully diluted market cap |
liquidity | number | null | Current liquidity in USD |
liquidityMax | number | null | Maximum liquidity across all pools |
All market data fields are nullable - tokens without supply data will return null for market cap fields.
SDK Updates
@mobula_labs/types v0.1.3
New v2 schemas:
TokenPriceParamsSchema - GET request paramsTokenPriceBatchParamsSchema - POST batch request paramsTokenPriceResponseSchema - Response with USD suffix fields
@mobula/sdk
New method:
import { Mobula } from '@mobula/sdk';
const mobula = new Mobula({ apiKey: 'your-key' });
// GET request
const result = await mobula.fetchTokenPrice({
assets: '0x123...,0x456...',
blockchains: 'Ethereum,BSC'
});
// POST batch request
const batchResult = await mobula.fetchTokenPrice({
items: [
{ address: '0x123...', blockchain: 'Ethereum' },
{ address: '0x456...', blockchain: 'BSC' }
]
});
