> For the complete documentation index, see [llms.txt](https://graphdex-1.gitbook.io/graphdex-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://graphdex-1.gitbook.io/graphdex-docs/research-predictions/bubble.md).

# Bubble

**A bubble-map of every active prediction market — bigger bubble means bigger volume, colour shows the leading side.**

The **Bubble** tab in Research swaps the table for a single canvas of circles. Each circle is one market. Bigger circles carry more volume; colour shows which side is leading (green for the Up/Yes side, red for Down/No). Hover a bubble to see the question and current odds; click to open the market page.

This is the view for fast pattern-finding: spot the heavyweights, see where flow is clustering, and zoom in on the slices you care about.

## Reading the canvas

* **Size = volume.** A bubble twice as wide as another carries roughly four times the volume.
* **Colour = leading side.** Green-leaning bubbles are biased toward Up/Yes; red-leaning bubbles toward Down/No. Tightly balanced markets sit near neutral.
* **Position = clustered by category.** Markets in the same category cluster together so you can scan a slice at a glance.

## Filters on Bubble

The toolbar above the canvas lets you narrow what is drawn:

* **Bubble count** — cap the number of circles (e.g. top 100). Lower it on a slow connection.
* **Volume / Liquidity** — minimum-volume and minimum-liquidity sliders hide the long tail.
* **Time-to-close** — show only short-window or only long-window markets.
* **Region / category** — same 11 categories as the New and Trends views, plus a region flag set for Politics/Elections markets.

## When Bubble is the right view

* You want to scan the whole universe in one glance and pick the visually loudest market.
* You are comparing categories — Politics vs Crypto vs Sports — without scrolling a long table.
* You want to spot one-sided markets quickly (deep green or deep red bubbles).

## When Bubble is the wrong view

* You need to compare exact volumes side-by-side — use [Trends](/graphdex-docs/research-predictions/trends.md), where they are sortable in a column.
* You need to act on the very newest market — use [New](/graphdex-docs/research-predictions/new-markets.md); Bubble updates with the canvas but New surfaces fresh rows at the top instantly.

{% hint style="warning" %}
A big green bubble is not a "buy signal". Size and colour reflect what is in the book right now — not what is going to happen. Treat Bubble as a discovery tool, not a recommendation.
{% endhint %}

## FAQs

<details>

<summary>Does the canvas refresh in real time?</summary>

Yes. Bubble sizes and colours update as the order book moves. The number of circles re-flows when you change a filter.

</details>

<details>

<summary>Can I trade directly from the bubble?</summary>

Click a bubble to open the full market page with Quick Buy controls. There is no in-canvas Up/Down button — it would be too easy to click the wrong market.

</details>

<details>

<summary>What do the flag icons in the toolbar do?</summary>

They filter to markets tied to that region — most useful on Politics and Elections markets ("US elections", "EU elections"). Leave them all on to see the full set.

</details>


---

# 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://graphdex-1.gitbook.io/graphdex-docs/research-predictions/bubble.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.