> ## 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.
# Get Token ATH/ATL
> Retrieve All-Time High (ATH) and All-Time Low (ATL) values for a token, including the dates when these price extremes were recorded.
**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](#post-method-batch-query)
## 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
```bash theme={null}
# 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¤cies=EUR,USD"
```
### Response Format
```json theme={null}
{
"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
```json theme={null}
[
{
"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
```bash theme={null}
# 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
```json theme={null}
{
"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`
```json theme={null}
{
"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
| Field | Type | Description |
| ---------- | ----------------- | -------------------------- |
| `address` | string | Token contract address |
| `chainId` | string | Blockchain identifier |
| `symbol` | string | Token symbol |
| `name` | string | Token name |
| `priceUSD` | number | Current token price in USD |
| `athUSD` | number | All-Time High price in USD |
| `atlUSD` | number | All-Time Low price in USD |
| `athDate` | string (ISO 8601) | Date when ATH was recorded |
| `atlDate` | string (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 Size | Minimal (\~200 bytes) | Comprehensive (\~5KB) |
| ATH/ATL Data | Yes | Yes |
| Volume Data | No | Yes |
| Holdings Data | No | Yes |
| Trading Activity | No | Yes |
| Social Data | No | Yes |
Use `/token/ath` when you only need ATH/ATL values for faster responses and lower bandwidth usage.
## OpenAPI
````yaml get /2/token/ath
openapi: 3.0.0
info:
version: 1.0.0
title: Mobula API
description: >-
Documentation of the Mobula API
**Demo API**: The default server (demo-api.mobula.io) is a demo API with
rate limits.
For production use, please use api.mobula.io with an API key from
https://admin.mobula.io
servers:
- url: https://demo-api.mobula.io/api/
description: Demo API (rate limited, for testing only)
- url: https://api.mobula.io/api/
description: Production API (requires API key)
security: []
tags:
- name: V2 - Token
description: Token details, price, security, ATH, and holder data
- name: V2 - Market Data
description: Market details, OHLCV history, and lighthouse metrics
- name: V2 - Trades
description: Token trades, enriched trades, and trade filters
- name: V2 - Wallet
description: Wallet positions, activity, trades, analysis, and labels
- name: V2 - Assets
description: Cross-chain asset details and price history
- name: V2 - Swap
description: Swap quoting and execution
- name: V2 - Perps
description: Perpetual futures quoting, execution, and positions
- name: V2 - Bridge
description: Cross-chain bridge quoting and intent status (Alpha Preview)
- name: V2 - DeFi
description: Bonding pools and pulse data
- name: V2 - Search
description: Universal fast search
- name: V2 - Blockchains
description: System metadata and chain listings
- name: V1 - Market Data
description: Market prices, history, sparklines, pairs, and multi-data
- name: V1 - Wallet
description: Wallet portfolio, transactions, history, and NFTs
- name: V1 - Token
description: First buyers
- name: V1 - Trades
description: Market trades by pair
- name: V1 - Metadata
description: Token metadata, categories, trendings, and news
- name: V1 - Assets
description: List all assets
- name: V1 - Search
description: Search for assets, tokens, and pairs
- name: V1 - DeFi
description: Bonding pool pulse data
- name: V1 - Blockchains
description: Blockchain listings, pairs, and stats
- name: V1 - Webhooks
description: Webhook management
- name: V1 - Feed
description: Custom feed creation
paths:
/2/token/ath:
get:
tags:
- V2 - Token
summary: Get Token ATH/ATL Values
description: >-
Retrieve All-Time High (ATH) and All-Time Low (ATL) values for a token,
along with the dates when these values were recorded.
parameters:
- schema:
type: string
description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
required: false
description: Blockchain chain ID (e.g., "evm:56", "solana:solana")
name: chainId
in: query
- schema:
type: string
description: Token contract address
required: false
description: Token contract address
name: address
in: query
- schema:
type: string
description: Comma-separated list of currencies for price conversion
required: false
description: Comma-separated list of currencies for price conversion
name: currencies
in: query
responses:
'200':
description: Token ATH/ATL response
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
address:
type: string
chainId:
type: string
symbol:
type: string
nullable: true
name:
type: string
nullable: true
athUSD:
type: number
nullable: true
atlUSD:
type: number
nullable: true
athDate:
type: string
nullable: true
atlDate:
type: string
nullable: true
priceUSD:
type: number
nullable: true
default: 0
required:
- address
- chainId
- symbol
- name
hostname:
type: string
required:
- data
````