Get Token ATH/ATL - Mobula API

Get Token ATH/ATL Values

curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/ath

{
  "data": {
    "address": "<string>",
    "chainId": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "athUSD": 123,
    "atlUSD": 123,
    "athDate": "<string>",
    "atlDate": "<string>",
    "priceUSD": 0
  },
  "hostname": "<string>"
}

GET

token

ath

Get Token ATH/ATL Values

curl --request GET \
  --url https://demo-api.mobula.io/api/2/token/ath

{
  "data": {
    "address": "<string>",
    "chainId": "<string>",
    "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

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.

Query Parameters

chainId

string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

address

string

Token contract address

currencies

string

Comma-separated list of currencies for price conversion

Response

200 - application/json

Token ATH/ATL response

data

object

required

Show child attributes

hostname

string

Get Token Details Get Token Price

⌘I

​Overview

​GET Method - Single Item Query

​Query Parameters

​Usage Examples

​Response Format

​POST Method - Batch Query

​Request Body

​Body Parameters

​Usage Examples

​Response Format

​Multi-Currency Support

​Example with currencies=EUR,USD

​Converted Fields

​Response Field Definitions

​Use Cases

​Comparison with Token Details

Query Parameters

Response

Overview

GET Method - Single Item Query

Query Parameters

Usage Examples

Response Format

POST Method - Batch Query

Request Body

Body Parameters

Usage Examples

Response Format

Multi-Currency Support

Example with `currencies=EUR,USD`

Converted Fields

Response Field Definitions

Use Cases

Comparison with Token Details