dog-intelligence
On-chain intelligence hub for DOG•GO•TO•THE•MOON — the largest Bitcoin rune by holders (89K+). Pulls data directly from a Bitcoin Core + Ord full node via the DOG DATA API.
What it does
DOG intelligence provides 8 sub-commands that give agents real-time and historical analytics on the DOG rune:
| Action |
What it returns |
| pulse |
Full market snapshot: price aggregated across all exchanges, MVRV ratio, holder count, LTH vs STH ratio, Diamond Paws count, retention rate. One call, complete picture. |
| whales |
Multi-chain whale alerts with severity (CRITICAL/HIGH), USD value, classification, and top 25 holder positions. Covers Bitcoin L1, Stacks, and Solana. |
| diamond |
Forensic behavioral profiles — Diamond Paws, Dog Legends, Paper Hands breakdown. Proprietary Diamond Score ratings across 14 holder categories. |
| airdrop |
Origin story analytics: the Runestone→DOG airdrop (100B tokens, 75,490 recipients, zero pre-sale). Retention rate, behavior breakdown, current holder status. |
| lth-sth |
The trademark metric: Long-Term Holder vs Short-Term Holder supply ratio. HODL waves, UTXO age distribution, median age, and supply conviction analysis. |
| markets |
Full multi-exchange view: prices and volumes from 20+ exchanges (CEX + Solana DEX). Spread analysis, trust scores, and 24h high/low from Kraken. |
| multichain |
Cross-chain DOG intelligence: bridged supply on Stacks and Solana. Holder count, market cap, liquidity, and 24h metrics per chain. |
| bitcoin |
Bitcoin network context: latest block, hashrate, difficulty adjustment progress, mempool depth, and fee recommendations. |
Why agents need it
DOG is the #1 rune by holder count (89,020+) and the most liquid rune across CEX + DEX markets. Agents operating in Bitcoin DeFi need:
- Holder concentration (Gini coefficient, top 10/100/1000 %) to assess LP impermanent loss risk
- MVRV ratio for timing entry/exit — currently 0.27, meaning DOG trades at 27% of its realized value (historically undervalued)
- Multi-chain whale alerts for frontrunning protection — severity ratings (CRITICAL/HIGH), USD value, and classification across Bitcoin L1, Stacks, and Solana. Threshold: >1M DOG per transaction.
- Forensic profiles for narrative-grade intelligence — no other data source classifies 75K+ wallets into Diamond Paws, Paper Hands, Dog Legends, etc.
- LTH vs STH ratio — the single most predictive metric for supply-side conviction. 79%+ of DOG supply is in long-term hands.
- Multi-exchange markets — 20+ exchanges including Solana DEX (Orca, Raydium, Meteora, Jupiter) and 6 CEX. Full spread and volume analysis.
- Cross-chain data — DOG bridged to Stacks (via Bitflow) and Solana. Track bridged supply, liquidity, and holder count per chain.
- Bitcoin network context — fee conditions and mempool state matter when planning large DOG transactions.
No other API offers Diamond Score, forensic categorization, or LTH/STH breakdown for any rune. This is Glassnode-grade analytics for Bitcoin's fungible token layer.
Safety notes
- Read-only skill. Does not write to chain, does not move funds, does not sign transactions.
- No sensitive data processed. No private keys, no mnemonics, no wallet access required.
- All data sourced from DOG DATA's public API (dogdata.xyz) — GET requests only.
- Safe for mainnet and testnet. No network-specific risk.
- Rate limited: 20 req/hr without API key, 100 req/hr with free key, 5,000 req/hr with pro key.
- If rate limited (HTTP 429), the skill returns
status: "blocked" with retry information — never retries silently.
Data source
DOG DATA — the world's most comprehensive DOG rune data platform. Runs its own Bitcoin Core + Ord full node. No third-party API dependency. 40 REST endpoints, MCP server, SSE real-time events.
Commands
Pre-flight check
bun run dog-intelligence/dog-intelligence.ts doctor
Checks API health, connectivity, API key status, and smoke-tests all new endpoints. Always run before other commands.
Market pulse snapshot
bun run dog-intelligence/dog-intelligence.ts run --action pulse
Whale tracking (multi-chain, >1M DOG threshold)
bun run dog-intelligence/dog-intelligence.ts run --action whales
Diamond Score forensics
bun run dog-intelligence/dog-intelligence.ts run --action diamond
Airdrop origin story
bun run dog-intelligence/dog-intelligence.ts run --action airdrop
LTH vs STH conviction analysis
bun run dog-intelligence/dog-intelligence.ts run --action lth-sth
Multi-exchange market data
bun run dog-intelligence/dog-intelligence.ts run --action markets
Cross-chain data (Stacks + Solana)
bun run dog-intelligence/dog-intelligence.ts run --action multichain
Bitcoin network status
bun run dog-intelligence/dog-intelligence.ts run --action bitcoin
Install optional SDK
bun run dog-intelligence/dog-intelligence.ts install-packs
Output contract
All outputs are JSON to stdout using a consistent envelope:
Success:
{
"status": "success",
"action": "descriptive message",
"data": {},
"error": null,
"source": "dogdata.xyz",
"timestamp": "ISO-8601"
}
Error:
{
"status": "error",
"action": "context of what failed",
"data": null,
"error": "descriptive error message",
"source": "dogdata.xyz",
"timestamp": "ISO-8601"
}
Rate limited:
{
"status": "blocked",
"action": "rate_limited",
"data": null,
"error": "Rate limited on /endpoint. Retry after 60s.",
"source": "dogdata.xyz",
"timestamp": "ISO-8601"
}
Origin
Winner of AIBTC x Bitflow Skills Pay the Bills competition.
Original author: @LimaDevBTC
Competition PR: https://github.com/BitflowFinance/bff-skills/pull/14
1---2name: dog-intelligence3description: On-chain intelligence for DOG•GO•TO•THE•MOON rune — forensic analysis, LTH vs STH metrics, multi-chain whale tracking, multi-exchange markets, cross-chain data, and airdrop analytics powered by DOG DATA's Bitcoin full node.4---56# dog-intelligence78On-chain intelligence hub for **DOG•GO•TO•THE•MOON** — the largest Bitcoin rune by holders (89K+). Pulls data directly from a Bitcoin Core + Ord full node via the [DOG DATA](https://dogdata.xyz) API.910## What it does1112DOG intelligence provides 8 sub-commands that give agents real-time and historical analytics on the DOG rune:1314| Action | What it returns |15|--------|----------------|16| **pulse** | Full market snapshot: price aggregated across all exchanges, MVRV ratio, holder count, LTH vs STH ratio, Diamond Paws count, retention rate. One call, complete picture. |17| **whales** | Multi-chain whale alerts with severity (CRITICAL/HIGH), USD value, classification, and top 25 holder positions. Covers Bitcoin L1, Stacks, and Solana. |18| **diamond** | Forensic behavioral profiles — Diamond Paws, Dog Legends, Paper Hands breakdown. Proprietary Diamond Score ratings across 14 holder categories. |19| **airdrop** | Origin story analytics: the Runestone→DOG airdrop (100B tokens, 75,490 recipients, zero pre-sale). Retention rate, behavior breakdown, current holder status. |20| **lth-sth** | The trademark metric: Long-Term Holder vs Short-Term Holder supply ratio. HODL waves, UTXO age distribution, median age, and supply conviction analysis. |21| **markets** | Full multi-exchange view: prices and volumes from 20+ exchanges (CEX + Solana DEX). Spread analysis, trust scores, and 24h high/low from Kraken. |22| **multichain** | Cross-chain DOG intelligence: bridged supply on Stacks and Solana. Holder count, market cap, liquidity, and 24h metrics per chain. |23| **bitcoin** | Bitcoin network context: latest block, hashrate, difficulty adjustment progress, mempool depth, and fee recommendations. |2425## Why agents need it2627DOG is the #1 rune by holder count (89,020+) and the most liquid rune across CEX + DEX markets. Agents operating in Bitcoin DeFi need:2829- **Holder concentration** (Gini coefficient, top 10/100/1000 %) to assess LP impermanent loss risk30- **MVRV ratio** for timing entry/exit — currently 0.27, meaning DOG trades at 27% of its realized value (historically undervalued)31- **Multi-chain whale alerts** for frontrunning protection — severity ratings (CRITICAL/HIGH), USD value, and classification across Bitcoin L1, Stacks, and Solana. Threshold: >1M DOG per transaction.32- **Forensic profiles** for narrative-grade intelligence — no other data source classifies 75K+ wallets into Diamond Paws, Paper Hands, Dog Legends, etc.33- **LTH vs STH ratio** — the single most predictive metric for supply-side conviction. 79%+ of DOG supply is in long-term hands.34- **Multi-exchange markets** — 20+ exchanges including Solana DEX (Orca, Raydium, Meteora, Jupiter) and 6 CEX. Full spread and volume analysis.35- **Cross-chain data** — DOG bridged to Stacks (via Bitflow) and Solana. Track bridged supply, liquidity, and holder count per chain.36- **Bitcoin network context** — fee conditions and mempool state matter when planning large DOG transactions.3738No other API offers Diamond Score, forensic categorization, or LTH/STH breakdown for any rune. This is Glassnode-grade analytics for Bitcoin's fungible token layer.3940## Safety notes4142- **Read-only skill.** Does not write to chain, does not move funds, does not sign transactions.43- No sensitive data processed. No private keys, no mnemonics, no wallet access required.44- All data sourced from DOG DATA's public API (dogdata.xyz) — GET requests only.45- Safe for mainnet and testnet. No network-specific risk.46- Rate limited: 20 req/hr without API key, 100 req/hr with free key, 5,000 req/hr with pro key.47- If rate limited (HTTP 429), the skill returns `status: "blocked"` with retry information — never retries silently.4849## Data source5051[DOG DATA](https://dogdata.xyz) — the world's most comprehensive DOG rune data platform. Runs its own Bitcoin Core + Ord full node. No third-party API dependency. 40 REST endpoints, MCP server, SSE real-time events.5253- API Discovery: https://www.dogdata.xyz/api54- Agent Capabilities: https://www.dogdata.xyz/api/agent/capabilities55- OpenAPI Spec: https://www.dogdata.xyz/api/openapi.json56- LLM Context: https://www.dogdata.xyz/llms.txt5758## Commands5960### Pre-flight check6162```bash63bun run dog-intelligence/dog-intelligence.ts doctor64```6566Checks API health, connectivity, API key status, and smoke-tests all new endpoints. **Always run before other commands.**6768### Market pulse snapshot6970```bash71bun run dog-intelligence/dog-intelligence.ts run --action pulse72```7374### Whale tracking (multi-chain, >1M DOG threshold)7576```bash77bun run dog-intelligence/dog-intelligence.ts run --action whales78```7980### Diamond Score forensics8182```bash83bun run dog-intelligence/dog-intelligence.ts run --action diamond84```8586### Airdrop origin story8788```bash89bun run dog-intelligence/dog-intelligence.ts run --action airdrop90```9192### LTH vs STH conviction analysis9394```bash95bun run dog-intelligence/dog-intelligence.ts run --action lth-sth96```9798### Multi-exchange market data99100```bash101bun run dog-intelligence/dog-intelligence.ts run --action markets102```103104### Cross-chain data (Stacks + Solana)105106```bash107bun run dog-intelligence/dog-intelligence.ts run --action multichain108```109110### Bitcoin network status111112```bash113bun run dog-intelligence/dog-intelligence.ts run --action bitcoin114```115116### Install optional SDK117118```bash119bun run dog-intelligence/dog-intelligence.ts install-packs120```121122## Output contract123124All outputs are JSON to stdout using a consistent envelope:125126**Success:**127```json128{129 "status": "success",130 "action": "descriptive message",131 "data": {},132 "error": null,133 "source": "dogdata.xyz",134 "timestamp": "ISO-8601"135}136```137138**Error:**139```json140{141 "status": "error",142 "action": "context of what failed",143 "data": null,144 "error": "descriptive error message",145 "source": "dogdata.xyz",146 "timestamp": "ISO-8601"147}148```149150**Rate limited:**151```json152{153 "status": "blocked",154 "action": "rate_limited",155 "data": null,156 "error": "Rate limited on /endpoint. Retry after 60s.",157 "source": "dogdata.xyz",158 "timestamp": "ISO-8601"159}160```161162## Origin163164Winner of AIBTC x Bitflow Skills Pay the Bills competition.165Original author: @LimaDevBTC166Competition PR: https://github.com/BitflowFinance/bff-skills/pull/14
aibtcdev