Skip to main content

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.

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" }
  ]
}

​
Response Format

{
  "data": {
    "0x1234...abcd": {
      "name": "Token Name",
      "symbol": "TKN",
      "logo": "https://...",
      "priceUSD": 1.23,
      "marketCapUSD": 1000000,
      "marketCapDilutedUSD": 1500000,
      "liquidityUSD": 250000,
      "liquidityMaxUSD": 300000
    }
  }
}

​
Response Fields

FieldTypeDescription
priceUSDnumber | nullCurrent token price in USD
marketCapUSDnumber | nullMarket cap based on circulating supply
marketCapDilutedUSDnumber | nullFully diluted market cap
liquidityUSDnumber | nullCurrent liquidity in USD
liquidityMaxUSDnumber | nullMaximum liquidity across all pools

​
V1 Multi-Prices Enhancement

The /api/1/market/multi-prices endpoint has also been enhanced with additional fields:
FieldTypeDescription
marketCapnumber | nullMarket cap based on circulating supply
marketCapDilutednumber | nullFully diluted market cap
liquiditynumber | nullCurrent liquidity in USD
liquidityMaxnumber | nullMaximum 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 params
  • TokenPriceBatchParamsSchema - POST batch request params
  • TokenPriceResponseSchema - 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' }
  ]
});