# Historical Market Data

Fetch historical daily metrics for any ERC-20 token, including USD price, trading volume, and market capitalisation. Ideal for backtesting, trend analysis, and building time-series visualisations in dashboards or trading agents.

### **Endpoint**

<mark style="color:yellow;">**GET**</mark>  <mark style="color:orange;">`https://api.dapplooker.com/v1/crypto-market-historical`</mark>

> #### 💡 Pro **Tips**&#x20;
>
> * This endpoint supports up to **1,000 items per page**—ideal for bulk analytics or plotting historical charts efficiently. Use the query param <mark style="color:orange;">`page`</mark> and pagination attributes to navigate through results.
> * To fetch data for a **token**, pass any of these query parameters: <mark style="color:orange;">`token_address`</mark>, <mark style="color:orange;">`token_id`</mark>, or <mark style="color:orange;">`token_ticker`</mark>.
> * Use <mark style="color:orange;">`start_date`</mark> and <mark style="color:orange;">`end_date`</mark> to **narrow down results to a custom date range**, helping reduce payload size and focus on relevant timeframes.
> * Combine this endpoint with others like [Token Details](/data-apis-for-ai/unified-token-intelligence-api.md), [Trending Tokens](/data-apis-for-ai/trending-tokens.md), or [Technical Indicators](/products/api-endpoints/trading-intelligence/multi-interval-technical-analysis.md) to create rich analytics, dashboards, or market sentiment tools.
> * This endpoint is **x402 payment–enabled**, opening access for all users — simply **pay and use** without needing an API key.

### **Authentication**

This endpoint supports **two authentication methods**:

<table data-header-hidden><thead><tr><th width="254.30078125"></th><th></th></tr></thead><tbody><tr><td><strong>Method</strong></td><td><strong>Description</strong></td></tr><tr><td><strong>API Key</strong></td><td>Provide your Loky API key using the <mark style="color:orange;"><code>api_key</code></mark> parameter for authenticated access.</td></tr><tr><td><strong>x402 Payment Protocol</strong></td><td>If <mark style="color:orange;"><code>api_key</code></mark> is not provided, the request automatically uses the <a href="https://x402.gitbook.io/x402">x402 protocol</a> for on-chain payment verification.</td></tr></tbody></table>

For seamless integration, user can follow the [**x402 Quickstart Guide for Buyers**](https://x402.gitbook.io/x402/getting-started/quickstart-for-buyers).

### **Query Parameters**

<table data-header-hidden><thead><tr><th width="162.51171875"></th><th width="122.33203125"></th><th width="176.484375"></th><th></th></tr></thead><tbody><tr><td><strong>Parameter name</strong></td><td><strong>Type</strong></td><td><strong>Mandatory</strong></td><td><strong>Description</strong></td></tr><tr><td><mark style="color:orange;"><code>api_key</code></mark></td><td>string</td><td>No</td><td>Your unique Loky API key used for authentication</td></tr><tr><td><mark style="color:orange;"><code>chain</code></mark></td><td>string</td><td>Yes</td><td>The network chain to query. Supported chains: <mark style="color:orange;">base, solana</mark></td></tr><tr><td><mark style="color:orange;"><code>token_id</code></mark></td><td>string</td><td>No</td><td>Unique token Id to fetch data</td></tr><tr><td><mark style="color:orange;"><code>token_ticker</code></mark></td><td>string</td><td>No</td><td>Token ticker (symbol) to fetch data</td></tr><tr><td><mark style="color:orange;"><code>token_address</code></mark></td><td>string</td><td>No</td><td>Token contract address to fetch data</td></tr><tr><td><mark style="color:orange;"><code>page</code></mark></td><td>integer</td><td>No, Default page 1</td><td>Page number, 1000 items per page</td></tr><tr><td><mark style="color:orange;"><code>start_date</code></mark></td><td>string</td><td>No</td><td>Date from where the data is need to fetch. Use format: <mark style="color:orange;">YYYY-MM-DD</mark></td></tr><tr><td><mark style="color:orange;"><code>end_date</code></mark></td><td>string</td><td>No</td><td>Date to where the data is need to fetch. Use format: <mark style="color:orange;">YYYY-MM-DD</mark></td></tr></tbody></table>

### **Sample Request**

{% code overflow="wrap" %}

```bash
# Pagination enabled (via page parameter)
curl --location 'https://api.dapplooker.com/v1/crypto-market-historical?api_key=<API_KEY>&chain=base&token_address=0xac1bd2486aaf3b5c0fc3fd868558b082a531b2b4&page=1'

# With custom date range (start_date & end_date)
curl --location 'https://api.dapplooker.com/v1/crypto-market-historical?&api_key=<API_KEY>&chain=base&token_ticker=VIRTUAL&start_date=2025-01-01&end_date=2025-06-06'
```

{% endcode %}

### **Sample Response**

```json
{
  "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
      }
      // Upto 1000 items
    ],
    "meta": {
      "pagination": {
        "page": 1,
        "pageSize": 1000,
        "totalPages": 1,
        "totalRecords": 3
      }
    }
  }
}
```

### **Response Fields Explanation**

* <mark style="color:orange;">`token_id`</mark> *(string)*: A unique assigned identifier for the token.
* <mark style="color:orange;">`token_symbol`</mark> *(string)*: The token’s ticker symbol, typically used in trading.
* <mark style="color:orange;">`token_address`</mark> *(string)*: The on-chain address (contract address) of the token.
* <mark style="color:orange;">`token_day_metrics`</mark> *(array)*: A list of daily market stats for the token. Each object includes:
  * <mark style="color:orange;">`date_time`</mark> *(string)*: The calendar date of the record in `YYYY-MM-DD` format.
  * <mark style="color:orange;">`usd_price`</mark> *(number)*: The token’s closing price in USD on that day.
  * <mark style="color:orange;">`total_volume`</mark> *(number)*: The total trading volume in USD on that day.
  * <mark style="color:orange;">`market_cap`</mark> *(number)*: The estimated market capitalization on that day (price × circulating supply), in USD.

#### Pagination Attributes:

* <mark style="color:orange;">`page`</mark> *(integer)*: The current given page number, also being returned in the response.
* <mark style="color:orange;">`pageSize`</mark> *(integer)*: The number of max items can be included per page.
* <mark style="color:orange;">`pageCount`</mark> *(integer)*: The total number of pages available.
* <mark style="color:orange;">`total`</mark> *(integer)*: The total number of items available across all pages.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dapplooker.com/data-apis-for-ai/historical-market-data.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.