# Breakdowns

[Breakdowns](https://usesignals.app/breakdowns?utm_source=uselayer_docs) is a research agent inside [Signals](https://uselayer.sh/docs/signals.md). Paste a wallet or name a trader, then ask in your own words. The agent shows its plan before it reads anything, then lays every trade out on a chart you can replay.

<p><a class="docs-cta" href="https://usesignals.app/breakdowns?utm_source=uselayer_docs">Watch a sample breakdown →</a></p>

The sample needs no account. Sign in to ask your own.

<video src="/videos/docs/signals-breakdowns.mp4" poster="/videos/docs/signals-breakdowns.jpg" autoplay muted loop playsinline controls preload="metadata" aria-label="Breakdowns in Signals: ask how a wallet makes money on BTC 15-minute markets, see the plan, then replay each window with the wallet's fills and read the findings, each with its numbers checked against the data."></video>

*A real breakdown from Nov 10, sped up: one wallet, six BTC 15-minute windows, about 3 minutes of research.*

## How it works

1. **Ask.** A wallet address or Polymarket name, and a question: "How does this wallet make money on BTC 15-minute markets?", "Replay its latest window", "Compare its winning and losing windows".
2. **See the plan.** The agent says what it will read and what that costs before it runs. Nothing starts until you press Start.
3. **Replay every window.** Each 15-minute window is a tile: the BTC price from its start, with the wallet's fills along the bottom (Up above, Down below). Open one to step through it, with the Up and Down prices, the price to beat and each fill.
4. **Read the findings.** Each one is marked **Observed** (what the data shows, with its numbers) or **Inferred** (a reading of why, said as a reading). Every number is checked against the data before it's shown; one that can't be checked is marked unverified, never hidden.

Your breakdowns are saved, and only you can see them. Ask a follow-up, or click anything in a breakdown to ask about it.

## Built on Layer

- **Order books and Chainlink come from Layer's recordings.** Layer records Polymarket's order books and the Chainlink BTC/USD price these markets settle on. Chainlink is recorded from Nov 10, 05:27 UTC; windows before that show only its start and result.
- **The wallet's trades come from the [Python SDK](https://uselayer.sh/docs/sdk.md).** `client.whales.trades_between` reads every trade a wallet made in a time range, and `client.whales.price_history` reads Polymarket's once-a-minute prices where no order book was recorded.

## Good to know

- **BTC 15-minute markets on Polymarket only**, for now.
- **Research, no trading.** Breakdowns says what a wallet did and, marked as a reading, why it might have. It gives no advice and places no orders.
- **Prices by their names.** Chainlink BTC/USD is what the market settles on. Binance BTCUSDT is BTC in Tether, about 0.1% from Chainlink, and is shown for moves only.
- **Gaps are said plainly.** When a window has no recorded order book, or Polymarket couldn't list every trade, the breakdown says so in one sentence.
