Historical Market Data

Endpoint

GET https://api.dapplooker.com/v1/historical-market-data

---

Query Parameters

Parameter	Type	Required	Description
chain	string	Yes	Network to query (base, solana, etc.)
token_address	string	No	Token contract address
token_id	string	No	Internal token identifier
token_ticker	string	No	Token ticker
start_date	string	No	Start date (YYYY-MM-DD)
end_date	string	No	End date (YYYY-MM-DD)
page	number	No	Pagination page
api_key	string	No	API key if not using x402

Use one token identifier: token_address, token_id, or token_ticker.

---

Example Requests

# Query by token address with pagination
curl --location 'https://api.dapplooker.com/v1/historical-market-data?api_key=<API_KEY>&chain=base&token_address=0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4&page=1'

# Query by ticker with custom date range
curl --location 'https://api.dapplooker.com/v1/historical-market-data?api_key=<API_KEY>&chain=base&token_ticker=VIRTUAL&start_date=2025-01-01&end_date=2025-06-06'

---

Example Response

{
  "success": true,
  "data": {
    "token_id": "toshi",
    "token_symbol": "TOSHI",
    "token_address": "0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4",

    "token_day_metrics": [
      {
        "date_time": "2025-06-03",
        "usd_price": 0.00058,
        "total_volume": 21583357,
        "market_cap": 243545744
      },
      {
        "date_time": "2025-06-02",
        "usd_price": 0.00054,
        "total_volume": 13218936,
        "market_cap": 228146173
      },
      {
        "date_time": "2025-06-01",
        "usd_price": 0.00056,
        "total_volume": 14565988,
        "market_cap": 238189967
      }
    ],

    "meta": {
      "pagination": {
        "page": 1,
        "pageSize": 1000,
        "totalPages": 1,
        "totalRecords": 3
      }
    }
  }
}

---

Response Schema

Token Identity

Field	Type	Description
token_id	string	Internal token identifier
token_symbol	string	Token ticker
token_address	string	Contract address

---

Daily Market Metrics

Each item in token_day_metrics contains:

Field	Type	Description
date_time	string	Record date (YYYY-MM-DD)
usd_price	number	Daily token price in USD
total_volume	number	Daily trading volume in USD
market_cap	number	Estimated market capitalization

---

Pagination

Field	Type	Description
page	number	Current page
pageSize	number	Items per page
totalPages	number	Total pages
totalRecords	number	Total records available

---