> For the complete documentation index, see [llms.txt](https://docs.kumbaya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumbaya.xyz/trading/price-charts.md).

# Reading a price chart

Every token's detail page on Kumbaya has a chart at the top. It's not just a price chart — it's three different views you can switch between, plus chart-type toggles and creator-trade markers. This page covers what each one shows.

## The three views

A row of buttons above the chart switches between:

* **Price** — the token's USD price over time, with a volume histogram below.
* **Buyers** — cumulative number of unique buyers over time (a step-area chart).
* **Flow** — net USD buy/sell flow per period (a histogram, green for net buying, red for net selling).

## Timeframes

The same row offers three timeframes: **1m**, **1h**, **1d**. There's no 5m, 15m, or 4h — Kumbaya keeps it to three.

* **1m** rolls a window of the last \~1,440 minutes (24 hours).
* **1h** rolls \~720 hours (30 days).
* **1d** rolls \~120 days (4 months).

## Price view

The default. You'll spend most of your time here.

### Candlestick or Area

A toggle on the chart switches between:

* **Candlestick** — open/high/low/close per period, with green candles for periods that closed up and red for periods that closed down. The close of the most recent (still-in-progress) period snaps to the live price.
* **Area** — a smoothed area chart of close prices, easier to read at a glance.

Your choice is remembered between visits.

### Volume below the candles

Underneath the price, a volume histogram shows how much USD changed hands in each period.

### Creator trade markers

When the token's creator buys or sells, the chart marks it on the price line:

* **Green up-arrow with "B"** below the bar — creator buy.
* **Red down-arrow with "S"** above the bar — creator sell.

Markers snap to the nearest real candle (within \~2 hours). They're a useful signal: if a creator is buying or selling their own token, that's worth knowing.

### Hover for OHLC

Hovering anywhere on the chart shows:

* **O / H / L / C** — Open, High, Low, Close for that period.
* **Volume** — total USD volume during that period.
* **Change** — % change from open to close (green if up, red if down).
* **Time** — period start, in your local time on the 1m and 1h views, in UTC on the daily view.

## Buyers view

A cumulative count of unique buyers over the chosen timeframe. The line only goes up — it doesn't subtract sellers. Useful for spotting:

* **Steady accumulation** — a smooth curve climbing means new buyers are arriving consistently.
* **Sharp jump** — a spike usually pairs with a price candle pushing higher; check the Price view to confirm.
* **Flat** — no new wallets have bought; existing holders are trading among themselves (or volume has dried up).

## Flow view

A histogram of **net buy minus sell volume** per period.

* **Green bars** — more USD bought than sold; net buying pressure.
* **Red bars** — more USD sold than bought; net selling pressure.

Flow is the cleanest way to spot turning points: a string of green bars suddenly going red often precedes a price move down.

## Gap-fill behaviour

If no trades happen in a given period, the chart carries the previous close price forward as a flat candle (open = high = low = close = previous close). That's why you'll often see flat horizontal segments on low-activity tokens — those reflect on-chain reality, not chart bugs.

Creator-trade markers only snap to *real* candles (periods where actual trades occurred), not gap-fill candles.

## Pre-graduation vs. post-graduation

For a launchpad token still in the bonding phase, the chart reflects whatever swaps happened on the V3 pool — there's nothing visually different about it from a graduated token's chart. Price moves in both directions as buyers and sellers act on the curve, not "only up". After graduation, the chart continues uninterrupted on the same pool, so you won't see a visible break.

## What to look for

Take all of this with a grain of salt — DYOR — but useful signals:

* **Volume + price both rising** — interest is real.
* **Price up, volume thin** — be skeptical; one buyer can move a low-liquidity pool.
* **A green Flow histogram while price is flat** — buyers absorbing supply at this level; could break up.
* **A red Flow histogram while price is rising** — distribution into the rally; rallies on net selling rarely hold.
* **Creator-sell markers on the way up** — exactly what it looks like.

The **Buyers tab** on the token page (separate from the Buyers chart view) shows the actual holder leaderboard — useful when you want to know *who* is holding rather than *how many*.

## Where to next

* [**Discovering tokens →**](/launchpad/discover.md) for the wider feed view
* [**Swapping tokens →**](/trading/swap.md) when you're ready to trade


---

# 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.kumbaya.xyz/trading/price-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.
