> For the complete documentation index, see [llms.txt](https://runtimedesigns.gitbook.io/token-buzz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://runtimedesigns.gitbook.io/token-buzz/product-guide/charts.md).

# Charts

TokenBuzz renders professional candlestick price charts with social-event overlays. The unique value is seeing exactly where social signals — mention spikes, KOL posts, sentiment shifts — land on the price candles.

## Where charts appear

Charts are embedded in two places:

* **Watchlist token detail pane** — click any token in your [Watchlist](/token-buzz/product-guide/watchlists-and-dashboards.md) to open its detail pane, which includes a candlestick chart.
* **Dashboard grid** — add a candlestick card to any [Dashboard](/token-buzz/product-guide/watchlists-and-dashboards.md). The card shows the chart for the dashboard's scoped ticker.

## Timeframes

A pill group in the chart header lets you switch between:

* **5m** — 5-minute candles
* **1h** — 1-hour candles (default)
* **4h** — 4-hour candles
* **1d** — daily candles

Switching timeframe reloads the OHLCV data and repositions the social markers.

## Price data

Price data is sourced from GeckoTerminal (on-chain DEX data for Solana tokens) and cached in TokenBuzz to minimize latency. The chart polls for new data automatically to keep the forming candle fresh. A **live** label next to the current price confirms the ticker is updating in real time.

A live price tick in the chart header is updated every 15 seconds from the Jupiter Price API.

If the price provider is temporarily rate-limited, the chart shows a "live data paused — retrying in Xs" notice and resumes automatically.

## Crosshair tooltip

Hover over any candle to see the OHLCV values in a floating tooltip:

* **O** — Open
* **H** — High
* **L** — Low
* **C** — Close (coloured green or red to indicate up/down)
* **Vol** — Volume

## Overlay indicators

Use the chip row below the timeframe selector to toggle optional overlays:

| Chip       | What it shows                                                            |
| ---------- | ------------------------------------------------------------------------ |
| **Volume** | A histogram of trading volume behind the candles. On by default.         |
| **SMA 20** | 20-period simple moving average line.                                    |
| **EMA 50** | 50-period exponential moving average line.                               |
| **Social** | Social event markers overlaid on the candles (see below). On by default. |

## Social event markers

When **Social** is enabled, small coloured markers appear above or below candles at timestamps where a notable social event occurred. Event types include mention spikes and sentiment-scored activity bursts.

Click a marker to open a pop-up card that shows:

* The event title and type.
* A magnitude indicator (e.g. "3σ spike" for a statistical outlier in mention volume).
* Sample posts from that moment, with author handle and an excerpt.
* A **View in live feed →** link that opens the [Live Feed](/token-buzz/product-guide/live-feed.md) filtered to that token.

Click anywhere else on the chart or the × button on the card to dismiss it.

## Dragging chart context to Hum

The chart supports drag-to-context for [Hum AI](/token-buzz/product-guide/hum-ai.md). Drag the chart area into the Hum panel to attach price and social data as context for a question (e.g. "Why did this spike at 14:00?").


---

# 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://runtimedesigns.gitbook.io/token-buzz/product-guide/charts.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.