> For the complete documentation index, see [llms.txt](https://docs.tachyo.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tachyo.ai/concepts/freshness.md).

# Snapshots and freshness

Tachyo never shows you a number without being willing to say how old it is. That means several timestamps, and reading them right saves you from acting on a picture that has moved.

## The three clocks

**Live market data.** Price, market cap and liquidity update continuously. If the chart is moving, this is moving.

**The holder snapshot.** The holder census and the smart-money tiers are recomputed on a schedule, not on every page view. The "snapshot" label tells you when that last happened. Between recomputes, the holder list is a photograph: accurate as of then, not as of now.

**The signal clock.** The [Tachyo Signal](/concepts/tachyo-signal.md) is computed on its own hourly scan and carries its own timestamp. It is deliberately separate from the snapshot clock, and the two will often disagree by minutes or hours.

{% hint style="info" %}
When a fast-moving token looks contradictory (a green chart under a stale-looking holder base), check the clocks before you conclude the data is wrong. Usually one of them simply has not caught up yet, and the product is telling you which.
{% endhint %}

## Refreshing a token

You can force a re-scan of a token's holders, tiers and signal from its page.

* **The result is shared.** A refresh recomputes the token for everyone on Tachyo, not just your view. You are not buying a private copy. You are moving the shared clock forward.
* **You have a monthly allowance** of on-demand refreshes, shown in your [profile](/account/profile.md). It resets on the 1st of each month.
* **Refresh when it matters**: before sizing into something that has moved hard, or when the snapshot is visibly older than the story you are looking at. Refreshing a quiet token you are merely curious about spends the allowance for nothing.

## Freshness on the feed

The [Live Feed](/platform/feed.md) marks itself live when the newest event is under five minutes old. Elsewhere, smart-money recency is colour-coded: green under an hour, amber under six, red beyond that. Red does not mean wrong. It means older, interpret with caution.

## "Unknown" is not "no"

Throughout the product, a failed measurement renders differently from a zero:

* **A zero** is a real measurement: nothing happened in this window.
* **A dash or "unknown"** means we could not measure it: a source did not answer, or the history is not there.

This distinction is not cosmetic. "This wallet has no PnL on record" and "this wallet made nothing" are opposite claims, and the product will not silently turn the first into the second.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.tachyo.ai/concepts/freshness.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.