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.

This cookbook demonstrates how to retrieve All-Time High (ATH) and All-Time Low (ATL) values for tokens across multiple blockchains including Solana, Base, Ethereum, and 50+ other chains supported by Mobula.
Quick Start: Get your free API key at admin.mobula.io to start querying ATH/ATL data immediately.

​
Overview

ATH and ATL values are essential metrics for understanding a token’s price history:
  • ATH (All-Time High): The highest price the token has ever reached
  • ATL (All-Time Low): The lowest price the token has ever reached
These values help traders and investors:
  • Gauge how far a token is from its historical peak
  • Identify potential recovery opportunities from ATL levels
  • Set realistic price targets based on historical data

​
Basic Usage

​
Single Token Query

Fetch ATH/ATL for a single token using a simple GET request: 
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=solana&address=So11111111111111111111111111111111111111112" \
  -H "Authorization: YOUR_API_KEY"
Response: 
{
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "chainId": "solana",
    "symbol": "SOL",
    "name": "Solana",
    "priceUSD": 125.45,
    "athUSD": 260.06,
    "atlUSD": 0.50,
    "athDate": "2021-11-06T21:54:00.000Z",
    "atlDate": "2020-05-11T19:35:00.000Z"
  }
}

​
JavaScript/TypeScript Implementation

import { Mobula } from "@mobula/sdk";

const mobula = new Mobula({ apiKey: "YOUR_API_KEY" });

async function getTokenAth(blockchain: string, address: string) {
  const response = await fetch(
    `https://api.mobula.io/api/2/token/ath?blockchain=${blockchain}&address=${address}`,
    {
      headers: {
        "Authorization": "YOUR_API_KEY",
      },
    }
  );
  
  const data = await response.json();
  return data.data;
}

// Get SOL ATH/ATL
const solAth = await getTokenAth("solana", "So11111111111111111111111111111111111111112");
console.log(`SOL ATH: $${solAth.athUSD} on ${new Date(solAth.athDate).toLocaleDateString()}`);
console.log(`SOL ATL: $${solAth.atlUSD} on ${new Date(solAth.atlDate).toLocaleDateString()}`);
console.log(`Distance from ATH: ${((1 - solAth.priceUSD / solAth.athUSD) * 100).toFixed(2)}%`);

​
Python Implementation

import requests

def get_token_ath(blockchain: str, address: str, api_key: str) -> dict:
    """Fetch ATH/ATL data for a token."""
    response = requests.get(
        f"https://api.mobula.io/api/2/token/ath",
        params={
            "blockchain": blockchain,
            "address": address,
        },
        headers={
            "Authorization": api_key,
        }
    )
    response.raise_for_status()
    return response.json()["data"]

# Example: Get SOL ATH/ATL
sol_data = get_token_ath(
    blockchain="solana",
    address="So11111111111111111111111111111111111111112",
    api_key="YOUR_API_KEY"
)

print(f"SOL ATH: ${sol_data['athUSD']:.2f}")
print(f"SOL ATL: ${sol_data['atlUSD']:.2f}")
print(f"Current Price: ${sol_data['priceUSD']:.2f}")

​
Multi-Chain Examples

​
Ethereum (ERC-20 Tokens)

# USDT on Ethereum
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=ethereum&address=0xdac17f958d2ee523a2206206994597c13d831ec7"

# USDC on Ethereum
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=ethereum&address=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"

​
Base Chain

# WETH on Base
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=base&address=0x4200000000000000000000000000000000000006"

​
Solana

# SOL
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=solana&address=So11111111111111111111111111111111111111112"

# BONK
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=solana&address=DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

​
Arbitrum

# ARB Token
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=arbitrum&address=0x912CE59144191C1204E64559FE8253a0e49E6548"

​
Batch Queries

Fetch ATH/ATL for multiple tokens in a single request: 
curl -X POST "https://api.mobula.io/api/2/token/ath" \
  -H "Content-Type: application/json" \
  -H "Authorization: YOUR_API_KEY" \
  -d '[
    {"blockchain": "solana", "address": "So11111111111111111111111111111111111111112"},
    {"blockchain": "ethereum", "address": "0xdac17f958d2ee523a2206206994597c13d831ec7"},
    {"blockchain": "base", "address": "0x4200000000000000000000000000000000000006"},
    {"blockchain": "arbitrum", "address": "0x912CE59144191C1204E64559FE8253a0e49E6548"}
  ]'

​
TypeScript Batch Example

async function getMultipleTokensAth(tokens: Array<{blockchain: string, address: string}>) {
  const response = await fetch("https://api.mobula.io/api/2/token/ath", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "YOUR_API_KEY",
    },
    body: JSON.stringify(tokens),
  });
  
  const data = await response.json();
  return data.payload;
}

// Fetch ATH/ATL for multiple tokens across different chains
const tokens = [
  { blockchain: "solana", address: "So11111111111111111111111111111111111111112" },
  { blockchain: "ethereum", address: "0xdac17f958d2ee523a2206206994597c13d831ec7" },
  { blockchain: "base", address: "0x4200000000000000000000000000000000000006" },
];

const results = await getMultipleTokensAth(tokens);
results.forEach((token) => {
  console.log(`${token.symbol}: ATH $${token.athUSD}, ATL $${token.atlUSD}`);
});

​
Multi-Currency Support

Get ATH/ATL values in multiple currencies: 
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=solana&address=So11111111111111111111111111111111111111112&currencies=EUR,GBP,JPY"
Response: 
{
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "chainId": "solana",
    "symbol": "SOL",
    "name": "Solana",
    "priceUSD": 125.45,
    "priceEUR": 115.21,
    "priceGBP": 98.67,
    "priceJPY": 18867.50,
    "athUSD": 260.06,
    "athEUR": 238.86,
    "athGBP": 204.65,
    "athJPY": 39129.00,
    "atlUSD": 0.50,
    "atlEUR": 0.46,
    "atlGBP": 0.39,
    "atlJPY": 75.25,
    "athDate": "2021-11-06T21:54:00.000Z",
    "atlDate": "2020-05-11T19:35:00.000Z"
  }
}

​
Practical Use Cases

​
ATH Distance Calculator

interface TokenAthData {
  symbol: string;
  priceUSD: number;
  athUSD: number;
  atlUSD: number;
  athDate: string;
  atlDate: string;
}

function calculateAthMetrics(data: TokenAthData) {
  const distanceFromAth = ((data.athUSD - data.priceUSD) / data.athUSD) * 100;
  const distanceFromAtl = ((data.priceUSD - data.atlUSD) / data.atlUSD) * 100;
  const athRecoveryNeeded = ((data.athUSD - data.priceUSD) / data.priceUSD) * 100;
  
  return {
    symbol: data.symbol,
    currentPrice: data.priceUSD,
    ath: data.athUSD,
    atl: data.atlUSD,
    distanceFromAth: `${distanceFromAth.toFixed(2)}%`,
    distanceFromAtl: `${distanceFromAtl.toFixed(2)}%`,
    athRecoveryNeeded: `${athRecoveryNeeded.toFixed(2)}%`,
    daysSinceAth: Math.floor(
      (Date.now() - new Date(data.athDate).getTime()) / (1000 * 60 * 60 * 24)
    ),
    daysSinceAtl: Math.floor(
      (Date.now() - new Date(data.atlDate).getTime()) / (1000 * 60 * 60 * 24)
    ),
  };
}

​
Portfolio ATH Tracker

async function trackPortfolioAth(portfolio: Array<{blockchain: string, address: string, amount: number}>) {
  const athData = await getMultipleTokensAth(
    portfolio.map(({ blockchain, address }) => ({ blockchain, address }))
  );
  
  return portfolio.map((holding, index) => {
    const token = athData[index];
    const currentValue = holding.amount * token.priceUSD;
    const athValue = holding.amount * token.athUSD;
    
    return {
      symbol: token.symbol,
      holding: holding.amount,
      currentValue,
      athValue,
      potentialUpside: athValue - currentValue,
      percentFromAth: ((1 - token.priceUSD / token.athUSD) * 100).toFixed(2),
    };
  });
}

​
Supported Chains

The /token/ath endpoint supports 50+ blockchains including:
ChainIdentifier
Solanasolana:solana
Ethereumevm:1
Baseevm:8453
Arbitrumevm:42161
Polygonevm:137
BSCevm:56
Avalancheevm:43114
Optimismevm:10
For a complete list of supported chains, see our Blockchains documentation.

​
Error Handling

async function safeGetTokenAth(blockchain: string, address: string) {
  try {
    const response = await fetch(
      `https://api.mobula.io/api/2/token/ath?blockchain=${blockchain}&address=${address}`,
      {
        headers: { "Authorization": "YOUR_API_KEY" },
      }
    );
    
    if (!response.ok) {
      if (response.status === 404) {
        throw new Error("Token not found");
      }
      throw new Error(`API error: ${response.status}`);
    }
    
    return await response.json();
  } catch (error) {
    console.error(`Failed to fetch ATH for ${address}:`, error);
    return null;
  }
}

​
Rate Limits

  • The endpoint uses 1 credit per request for GET calls
  • Batch POST requests use 1 credit per token in the array
  • For high-volume applications, consider using batch requests to optimize credit usage

​
Need Help?

Telegram

Fast support

Discord

Community

Slack

Enterprise

Email

Contact us