> ## 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.

# ✨ January 12, 2026 - Get Token Price Endpoint

> New v2 token/price endpoint with USD suffix naming and enhanced v1 multi-prices response

**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

```bash theme={null}
GET /api/2/token/price?assets=0x123...,0x456...&blockchains=Ethereum,BSC
```

### POST Request (Batch - up to 500 tokens)

```bash theme={null}
POST /api/2/token/price
Content-Type: application/json

{
  "items": [
    { "address": "0x123...", "blockchain": "Ethereum" },
    { "address": "0x456...", "blockchain": "BSC" }
  ]
}
```

### Response Format

```json theme={null}
{
  "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     |

<Note>
  All market data fields are nullable - tokens without supply data will return `null` for market cap fields.
</Note>

***

## SDK Updates

### @mobula\_labs/types v0.1.3

New v2 schemas:

* `TokenPriceParamsSchema` - GET request params
* `TokenPriceBatchParamsSchema` - POST batch request params
* `TokenPriceResponseSchema` - Response with USD suffix fields

### @mobula/sdk

New method:

```typescript theme={null}
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' }
  ]
});
```