Skip to main content
GET
/
2
/
token
/
ath
Get Token ATH/ATL Values
curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/ath
{
  "data": {
    "address": "<string>",
    "chainId": "<unknown>",
    "symbol": "<string>",
    "name": "<string>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "priceUSD": 0
  },
  "hostname": "<string>"
}
Batch Support Available: This endpoint supports batch queries via POST method for fetching ATH/ATL data for multiple tokens in a single request. Jump to Batch Query section

​
Overview

The Token ATH endpoint provides a lightweight response containing only the All-Time High and All-Time Low values for a token, along with their respective dates. This is ideal when you only need ATH/ATL data without the comprehensive token details returned by the /token/details endpoint.

​
GET Method - Single Item Query

Retrieve ATH/ATL information for a single token.

​
Query Parameters

  • blockchain (required) — The blockchain identifier (e.g., evm:1, solana, ethereum, base)
  • address (required) — Direct token address
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD. Supported currencies: USD, EUR, GBP, JPY, CHF, CAD, AUD, CNY, KRW, INR, BRL

​
Usage Examples

# Get ATH/ATL for a Solana token
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=solana&address=So11111111111111111111111111111111111111112"

# Get ATH/ATL for an Ethereum token
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=ethereum&address=0xdac17f958d2ee523a2206206994597c13d831ec7"

# Get ATH/ATL for a Base token with multi-currency support
curl -X GET "https://api.mobula.io/api/2/token/ath?blockchain=base&address=0x4200000000000000000000000000000000000006&currencies=EUR,USD"

​
Response Format

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

​
POST Method - Batch Query

Retrieve ATH/ATL data for multiple tokens in a single request for improved efficiency.

​
Request Body

[
  {
    "blockchain": "ethereum",
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  },
  {
    "blockchain": "solana",
    "address": "So11111111111111111111111111111111111111112"
  },
  {
    "blockchain": "base",
    "address": "0x4200000000000000000000000000000000000006"
  }
]

​
Body Parameters

The request body is an array of query objects, where each object contains:
  • blockchain (required) — Blockchain id or name
  • address (required) — Direct token address
  • currencies (optional) — Comma-separated list of fiat currencies for price conversion. Defaults to USD

​
Usage Examples

# Batch query for multiple tokens
curl -X POST "https://api.mobula.io/api/2/token/ath" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": "ethereum",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
    },
    {
      "blockchain": "solana",
      "address": "So11111111111111111111111111111111111111112"
    }
  ]'

# Batch query with multi-currency
curl -X POST "https://api.mobula.io/api/2/token/ath" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "blockchain": "ethereum",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "currencies": "EUR,USD,GBP"
    },
    {
      "blockchain": "base",
      "address": "0x4200000000000000000000000000000000000006",
      "currencies": "EUR,USD"
    }
  ]'

​
Response Format

{
  "payload": [
    {
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "chainId": "evm:1",
      "symbol": "USDT",
      "name": "Tether USD",
      "priceUSD": 1.00,
      "athUSD": 1.32,
      "atlUSD": 0.57,
      "athDate": "2018-07-24T00:00:00.000Z",
      "atlDate": "2015-03-02T00:00:00.000Z"
    },
    {
      "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"
    }
  ]
}

​
Multi-Currency Support

When you specify multiple currencies using the currencies parameter, the response will include additional fields for each currency.

​
Example with currencies=EUR,USD

{
  "data": {
    "address": "So11111111111111111111111111111111111111112",
    "chainId": "solana",
    "symbol": "SOL",
    "name": "Solana",
    "priceUSD": 125.45,
    "priceEUR": 115.21,
    "athUSD": 260.06,
    "athEUR": 238.86,
    "atlUSD": 0.50,
    "atlEUR": 0.46,
    "athDate": "2021-11-06T21:54:00.000Z",
    "atlDate": "2020-05-11T19:35:00.000Z"
  }
}

​
Converted Fields

The following field patterns are automatically converted:
  • priceUSD → price{CURRENCY}
  • athUSD → ath{CURRENCY}
  • atlUSD → atl{CURRENCY}
Exchange rates are fetched from reliable forex data providers and cached for optimal performance. Rates are updated every 30 minutes.

​
Response Field Definitions

FieldTypeDescription
addressstringToken contract address
chainIdstringBlockchain identifier
symbolstringToken symbol
namestringToken name
priceUSDnumberCurrent token price in USD
athUSDnumberAll-Time High price in USD
atlUSDnumberAll-Time Low price in USD
athDatestring (ISO 8601)Date when ATH was recorded
atlDatestring (ISO 8601)Date when ATL was recorded

​
Use Cases

  • Portfolio Tracking: Display ATH/ATL values alongside current prices to show distance from extremes
  • Trading Signals: Identify tokens approaching their ATH or recovering from ATL
  • Historical Analysis: Track when tokens reached their price extremes
  • Market Dashboards: Show ATH/ATL data without fetching comprehensive token details
  • Alert Systems: Monitor tokens for new ATH/ATL events

​
Comparison with Token Details

Feature/token/ath/token/details
Response SizeMinimal (~200 bytes)Comprehensive (~5KB)
ATH/ATL DataYesYes
Volume DataNoYes
Holdings DataNoYes
Trading ActivityNoYes
Social DataNoYes
Use /token/ath when you only need ATH/ATL values for faster responses and lower bandwidth usage.

Query Parameters

​
blockchain
string
​
address
string
​
currencies
string
default:USD
​
instanceTracking
boolean

Response

200 - application/json

Token ATH/ATL response

​
data
object
required
​
hostname
string