# Data Methodology & Technical Reference

### Date Range Behaviour

All date range parameters across Nansen API endpoints use closed brackets on both sides \[from, to], meaning both the from\_date and to\_date are inclusive. For example, requesting from=2024-11-04, to=2024-11-05 will return data for both November 4th and November 5th.

### Historical Data Calculation Method (Smart Money Holdings)

The Smart Money Historical Holdings API returns pure historical snapshots using prices from the actual date requested, not recalculated values. This ensures there is no look-ahead bias, making the data suitable for backtesting and predictive models.

#### Field-Level Details

* value\_usd: Historical USD value using the median price from that day
* market\_cap\_usd: Historical market cap snapshot for that date
* balance\_24h\_percent\_change: Historical percentage calculated using that day's balance and the previous day's balance (with each day using its respective price)

### Snapshot Timing & Data Availability

#### Snapshot Time

Daily snapshots represent end-of-day UTC values.

#### Data Availability (Smart Money Historical Holdings)

Data processing begins at 05:00 AM UTC. Data is typically available by 07:00 AM UTC, though exact timing may vary. The current day's data is excluded from responses since it would be incomplete.

#### Historical Depth

The Smart Money Historical Holdings endpoint provides a 4-year rolling window of historical data. The earliest available date moves forward daily.


---

# 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.nansen.ai/guides/data-methodology-and-technical-reference.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.