---
title: "BTC Dominance Alert — Auto-notify when BTC dom crosses key thresholds"
description: "Create a routine that runs every 5 hours and checks BTC dominance.\n\nThe routine should do the following:\n\n1. Fetch global crypto market data from this URL:\n   https://api.coingecko.com/api/v3/global\n\n2. Extract the field: data.market_cap_percentage.btc\n   That is the current BTC dominance percentage.\n\n3. Apply this logic:\n   - If BTC dominance is BELOW 60%: send me a Telegram message saying:\n     \"🔴 BTC Dominance Alert: BTC dom dropped to [X]% — below 60%. Altcoin season signal.\"\n   - If BTC dominance is ABOVE 65%: send me a Telegram message saying:\n     \"🟡 BTC Dominance Alert: BTC dom rose to [X]% — above 65%. BTC dominance expanding.\"\n   - If BTC dominance is between 60% and 65%: do NOT send anything. Silent run.\n\n4. Always write the result to memory at btc-dominance/last-check.md with:\n   - timestamp of the check\n   - current BTC dominance value\n   - whether an alert was sent or not\n\nDo not send a message on every run — only when a threshold is crossed.\nIf nothing triggered, reply HEARTBEAT_OK and stop."
canonical: "https://hub.ironclaw.com/usecases/btc-dominance-alert-auto-notify-when-btc-dom-crosses-key-thresholds"
markdown: "https://hub.ironclaw.com/usecases/btc-dominance-alert-auto-notify-when-btc-dom-crosses-key-thresholds.md"
type: "use-case"
categories: ["Personal assistant","Web 3 / Crypto","Automation"]
author: "Evgeny"
---

# BTC Dominance Alert — Auto-notify when BTC dom crosses key thresholds

## Example Prompt

> Create a routine that runs every 5 hours and checks BTC dominance.
> 
> The routine should do the following:
> 
> 1. Fetch global crypto market data from this URL:
>    https://api.coingecko.com/api/v3/global
> 
> 2. Extract the field: data.market_cap_percentage.btc
>    That is the current BTC dominance percentage.
> 
> 3. Apply this logic:
>    - If BTC dominance is BELOW 60%: send me a Telegram message saying:
>      "🔴 BTC Dominance Alert: BTC dom dropped to [X]% — below 60%. Altcoin season signal."
>    - If BTC dominance is ABOVE 65%: send me a Telegram message saying:
>      "🟡 BTC Dominance Alert: BTC dom rose to [X]% — above 65%. BTC dominance expanding."
>    - If BTC dominance is between 60% and 65%: do NOT send anything. Silent run.
> 
> 4. Always write the result to memory at btc-dominance/last-check.md with:
>    - timestamp of the check
>    - current BTC dominance value
>    - whether an alert was sent or not
> 
> Do not send a message on every run — only when a threshold is crossed.
> If nothing triggered, reply HEARTBEAT_OK and stop.

## What the Agent Does

Every 5 hours the agent fetches live global market data from CoinGecko and extracts the current BTC dominance percentage. If dominance drops below 60%, it sends a Telegram alert flagging a potential altcoin season signal. If it rises above 65%, it sends a different alert noting BTC dominance expansion. If the value stays between 60–65%, the run is silent — no message sent. After each check it writes a timestamped log to memory (timestamp, value, alert status). You only hear from it when something actually matters.

![Image](https://github.com/user-attachments/assets/12b17f6a-051a-4f81-97fc-d43781cd0221)

## Skills and Tools

- http
- routine/cron
- message
- memory_write

## Categories

- Personal assistant
- Web 3 / Crypto
- Automation

## Links

- [HTML page](https://hub.ironclaw.com/usecases/btc-dominance-alert-auto-notify-when-btc-dom-crosses-key-thresholds)