OPEN-SOURCE SCRIPT
Updated Big Trade % Heatmap

### Big Trade % Heatmap
**Quick overview**
This indicator highlights where “whale” activity is clustered by showing what fraction of the recent candles contained *large‑value trades*. A candle is considered “big” when its notional volume (`volume × close`) exceeds your chosen USD threshold. You instantly see:
* **Percent of big candles** in the last *N* bars, refreshed at the cadence you pick.
* **On‑chart labels & markers** every refresh, so the chart stays clean.
* **Optional heat‑map background** that turns orange (>20 %) or green (>50 %) when big‑trade concentration spikes.
* **Ready‑made alert** when big‑trade dominance crosses 50 %.
---
#### How it works
1. **Trade size per candle** – Calculates `close × volume` to estimate dollars traded.
2. **Threshold filter** – Flags candles whose value is above *Big Trade Threshold (\$)*.
3. **Look‑back window** – Counts what percentage of the last *Lookback Window (X Candles)* were “big.”
4. **Refresh interval** – Repeats the measurement only every *Refresh Interval (Every X Candles)* to avoid label spam.
5. **Visuals** –
* A small blue ▼ above the bar + a text label such as `35.00 % > $25 000`.
* Background shading (green/orange) for quick, at‑a‑glance sentiment.
---
#### Inputs
| Input | Purpose | Default |
| -------------------------------------- | ----------------------------------------------------- | ------- |
| **Lookback Window (X Candles)** | How many recent bars to sample for the % calculation. | 20 |
| **Refresh Interval (Every X Candles)** | How often to display a new label/marker. | 5 |
| **Big Trade Threshold (\$)** | Minimum USD value for a candle to count as “big.” | 10 000 |
Tune these to the symbol and timeframe you trade (e.g., raise the threshold for BTC‑USDT 1‑h, lower it for micro‑caps).
---
#### Alerts
Enable **“High Big Trade %”** to get notified the moment more than half of the last *N* candles qualify as big trades—handy for spotting sudden accumulation or distribution.
---
#### Typical use cases
* **Breakout confirmation** – A surge in big‑trade % just before price escapes a range can validate the move.
* **Whale spotting** – Detect hidden accumulation on pullbacks or aggressive selling into rallies.
* **Filter noise** – Combine with your favorite trend indicator; only act when both align.
---
> *Built with Pine Script v6. Always back‑test before trading live; this tool is for educational purposes and not financial advice.*
**Quick overview**
This indicator highlights where “whale” activity is clustered by showing what fraction of the recent candles contained *large‑value trades*. A candle is considered “big” when its notional volume (`volume × close`) exceeds your chosen USD threshold. You instantly see:
* **Percent of big candles** in the last *N* bars, refreshed at the cadence you pick.
* **On‑chart labels & markers** every refresh, so the chart stays clean.
* **Optional heat‑map background** that turns orange (>20 %) or green (>50 %) when big‑trade concentration spikes.
* **Ready‑made alert** when big‑trade dominance crosses 50 %.
---
#### How it works
1. **Trade size per candle** – Calculates `close × volume` to estimate dollars traded.
2. **Threshold filter** – Flags candles whose value is above *Big Trade Threshold (\$)*.
3. **Look‑back window** – Counts what percentage of the last *Lookback Window (X Candles)* were “big.”
4. **Refresh interval** – Repeats the measurement only every *Refresh Interval (Every X Candles)* to avoid label spam.
5. **Visuals** –
* A small blue ▼ above the bar + a text label such as `35.00 % > $25 000`.
* Background shading (green/orange) for quick, at‑a‑glance sentiment.
---
#### Inputs
| Input | Purpose | Default |
| -------------------------------------- | ----------------------------------------------------- | ------- |
| **Lookback Window (X Candles)** | How many recent bars to sample for the % calculation. | 20 |
| **Refresh Interval (Every X Candles)** | How often to display a new label/marker. | 5 |
| **Big Trade Threshold (\$)** | Minimum USD value for a candle to count as “big.” | 10 000 |
Tune these to the symbol and timeframe you trade (e.g., raise the threshold for BTC‑USDT 1‑h, lower it for micro‑caps).
---
#### Alerts
Enable **“High Big Trade %”** to get notified the moment more than half of the last *N* candles qualify as big trades—handy for spotting sudden accumulation or distribution.
---
#### Typical use cases
* **Breakout confirmation** – A surge in big‑trade % just before price escapes a range can validate the move.
* **Whale spotting** – Detect hidden accumulation on pullbacks or aggressive selling into rallies.
* **Filter noise** – Combine with your favorite trend indicator; only act when both align.
---
> *Built with Pine Script v6. Always back‑test before trading live; this tool is for educational purposes and not financial advice.*
Release Notes
Big Trade % Heatmap — Pine Script v6Purpose
Tracks “whale” activity by showing what fraction of recent candles contained large‑value trades.
How it works
• Each candle’s notional value = close × volume.
• A candle is “big” when that value exceeds your Big Trade Threshold ($).
• The script looks back X Candles and calculates the % that are big.
• It updates the reading every Refresh Interval candles, placing a blue ▼ and a label such as 32.5 % > $25 000 above the bar.
• Heat‑map background:
– Orange when >20 % of the look‑back window are big trades.
– Green when >50 %.
• Built‑in alert triggers the moment big‑trade share crosses 50 %.
Inputs
• Lookback Window (X Candles) — default 20
• Refresh Interval (Every X Candles) — default 5
• Big Trade Threshold ($) — default 10 000
Typical use cases
• Confirm breakouts/breakdowns backed by strong whale participation.
• Spot hidden accumulation or distribution when big‑trade % diverges from price.
• Combine with trend or volume tools for higher‑conviction entries.
Quick start
Set a threshold appropriate for your symbol/time‑frame.
Add the alert “High Big Trade %” if you want instant notifications >50 %.
Watch for background color shifts and label readings to gauge momentum.
For educational purposes only. Test thoroughly before live trading.
Open-source script
In true TradingView spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.
Open-source script
In true TradingView spirit, the creator of this script has made it open-source, so that traders can review and verify its functionality. Kudos to the author! While you can use it for free, remember that republishing the code is subject to our House Rules.
Disclaimer
The information and publications are not meant to be, and do not constitute, financial, investment, trading, or other types of advice or recommendations supplied or endorsed by TradingView. Read more in the Terms of Use.