---
title: "Btc Anomaly Detector"
description: "Compares today's BTC volume and price action against its 30-day baseline once a day, runs 4 anomaly checks (volume spike, oversized price move, price deviation from average, sustained volume trend), and when something is abnormal, interprets the combination in plain language — e.g. a volume spike with rising price reads as conviction buying, a volume spike with a flat price reads as accumulation before a move. Alerts on Telegram only when at least one check triggers."
canonical: "https://hub.ironclaw.com/marketplace/btc-anomaly-detector"
markdown: "https://hub.ironclaw.com/marketplace/btc-anomaly-detector.md"
type: "skill"
version: "1.0.0"
author: "IronHub"
category: "Web3"
tags: ["Skill","crypto","bitcoin","monitoring","automation"]
---

# Btc Anomaly Detector

> Compares today's BTC volume and price action against its 30-day baseline once a day, runs 4 anomaly checks (volume spike, oversized price move, price deviation from average, sustained volume trend), and when something is abnormal, interprets the combination in plain language — e.g. a volume spike with rising price reads as conviction buying, a volume spike with a flat price reads as accumulation before a move. Alerts on Telegram only when at least one check triggers.

## Details

- **Type:** Skill
- **Version:** 1.0.0
- **Author:** IronHub
- **Category:** Web3
- **Status:** live
- **Tags:** Skill, crypto, bitcoin, monitoring, automation


## Documentation

You compare today's BTC market behavior against its own 30-day normal and alert the user when something is genuinely abnormal — with an interpretation, not just numbers.

## Hard rules
- Judge all four checks by reasoning over the fetched data in plain language. Never write or run code to calculate averages or deviations.
- In the daily routine, send an alert only if at least one of the four checks triggers. If none trigger, reply `HEARTBEAT_OK` and stop — send no message.
- Use the thresholds exactly as defined below. Do not invent your own cutoffs.
- Only interpret combinations from the table given. Never claim a signal the data doesn't support, and never tell the user to buy or sell — frame it as an observation, not advice.
- Installing this skill does not create the routine by itself. After install, you must explicitly call the routine/mission creation tool yourself to register it — never assume the routine exists just because this file describes one. Confirm it was created (e.g. list active routines) before telling the user it's running.

## The four checks
Fetch 30 days of BTC data with the `http` tool: `https://api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=30`. Extract daily prices and daily volumes.

1. **Volume spike** — today's volume is more than 2.5x the 30-day average daily volume.
2. **Price move size** — today's % price move is more than 3x the typical (average absolute) daily move over 30 days.
3. **Price vs 30-day average** — the current price deviates more than 20% from the 30-day average price.
4. **Volume trend** — the average volume of the last 3 days is more than 2x the 30-day average.

## Interpreting a trigger
When any check triggers, read the combination:
- Volume spike + price up → "💚 Strong buy pressure — conviction move"
- Volume spike + price down → "🔴 Strong sell pressure — watch for continuation"
- Volume spike + price flat → "👀 Accumulation/distribution — a bigger move is often not far behind"
- Volume trend (check 4) + price up → "📈 Sustained interest — not a one-day pump"
- Price deviation up (check 3) with no volume anomaly → "⚠️ Weak pump — often retraces"
- Price deviation down (check 3) with a volume anomaly → "🏳️ Capitulation signal — potential local bottom"
If none of these combinations fit cleanly, describe what triggered in plain terms instead of forcing a label.

## Daily check (routine)
Create a routine that runs every day at 6:00 PM UTC. The routine goal must contain these full steps as a self-contained prompt, because a routine does not keep any context from this conversation when it runs:
1. Fetch 30-day BTC price and volume history with the `http` tool.
2. Run the four checks above against today's values.
3. If any check triggers, interpret the combination and send the alert (format below).
4. If nothing triggers, reply `HEARTBEAT_OK` and stop.

Alert format:
```
🔍 BTC Anomaly Detected
[for each triggered check:]
⚡ [check name]: today's [X] vs 30-day normal [X] (~[X]x)
💰 Current price: $[X] ([24h change]%)
🧠 Read: [interpretation]
```

## Commands
- `show btc anomaly check` — run all four checks right now and show the result even if nothing triggered

## Links

- [HTML page](https://hub.ironclaw.com/marketplace/btc-anomaly-detector)
- [Source](https://github.com/nearai/ironhub/blob/main/skills/btc-anomaly-detector/SKILL.md)
- [Documentation](https://github.com/nearai/ironhub/blob/main/skills/btc-anomaly-detector/SKILL.md)