> For the complete documentation index, see [llms.txt](https://docs.novamp.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.novamp.io/portfolio-and-analytics/charts-and-data.md).

# Charts & Market Data

How Novamp charts a coin and where its numbers come from — multiple chart backends, live stats, and honest data gaps.

{% hint style="info" %}
Novamp uses several chart backends and falls back automatically, so even a brand-new pool renders a chart. When a metric can't be sourced, it shows **Unavailable** rather than a made-up number.
{% endhint %}

## Overview

Every [token detail page](/traders/token-detail.md) has a chart and a stats block. Because coins launch on real pools across six chains — some too new or too small for any single data provider — Novamp layers multiple chart backends and a live price overlay to keep the view populated.

## Chart backends

Novamp picks the best available chart for the pool and falls back in order:

| Backend                | Used for                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **DexScreener embed**  | Pools DexScreener has indexed (keyed to the real pair address) — the only embed used for `🟣 HyperEVM`             |
| **GMGN embed**         | Small pools DexScreener skips (incl. Robinhood Chain); GMGN has **no** HyperEVM kline feed, so it's not used there |
| **Native candlestick** | Novamp's own indexer candles when embeds aren't ready                                                              |
| **Curve view**         | Legacy bonding-curve markets (price vs. native raised), incl. pre-Path B HyperEVM SherSwap markets                 |

You can switch the primary chart between **Candles** and other modes on the token page, and choose the candle interval.

{% hint style="info" %}
Because charts can come from third-party embeds (DexScreener / GMGN), their look and available tools vary by provider. The underlying market is the same real pool in every case.
{% endhint %}

## How it works

```mermaid
flowchart LR
  A[Open token page] --> B{DexScreener indexed?}
  B -->|Yes| C[DexScreener embed]
  B -->|No| D{GMGN available?}
  D -->|Yes| E[GMGN embed]
  D -->|No| F[Native candlestick]
  C --> G[Live price overlay + stats]
  E --> G
  F --> G
```

## Market data & stats

The stats block and feeds show:

* **Price / market cap / FDV** — priced in USD when an oracle is available, otherwise in the native asset.
* **Liquidity** and **volume**.
* **Holders** — distinct positive-balance wallets, ranked in the Holders tab (amount, % of supply, entry market cap, PnL).
* **Trades** — a live tape (time, account, buy/sell, USD, native amount, token delta, per-trade market cap).

All of this is available programmatically through the [Public Data API](/developers/public-api.md) (`/api/tokens`, `/api/discovery`, `/api/search`), the same data behind the in-app views.

## Important details

| Field                     | Meaning                                            |
| ------------------------- | -------------------------------------------------- |
| Price (USD/native)        | USD when an oracle exists, else native ETH/BNB/SOL |
| MCap / FDV                | Valuation from price × supply                      |
| Liquidity                 | Pool depth backing the market                      |
| Volume                    | Recent traded volume                               |
| Holders                   | Distinct wallets holding the token                 |
| **Unavailable / Partial** | Honest gap when a provider has no data             |

{% hint style="warning" %}
Charts and stats are informational, sourced from third parties and on-chain indexers. They can lag, differ between providers, or be sparse for brand-new pools — verify anything critical on the block explorer before trading.
{% endhint %}

## What happens next?

* After your trade confirms, the chart, trades tape, holders, and stats on the token page **refresh on their own**.
* New pools that aren't yet indexed by an embed provider fall back to Novamp's native candles until the provider crawls them.

## Troubleshooting

| Symptom                         | Likely cause                        | What to do                                   |
| ------------------------------- | ----------------------------------- | -------------------------------------------- |
| Chart is blank                  | Pool too new for any embed          | Wait; native candles usually fill in shortly |
| Stat reads **Unavailable**      | No provider/oracle data             | Normal for thin or brand-new markets         |
| Price differs from another site | Different provider / update cadence | Cross-check on the explorer or DexScreener   |
| USD values missing              | No price oracle for that asset      | Values show in the native asset instead      |

## Continue exploring

* [📊 Token Detail Pages](/traders/token-detail.md)
* [📈 PnL Tracker](/portfolio-and-analytics/pnl.md)
* [📡 Public Data API](/developers/public-api.md)
* [💼 Portfolio](/portfolio-and-analytics/portfolio.md)


---

# 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.novamp.io/portfolio-and-analytics/charts-and-data.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.