🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί AgentCanary
πŸ¦€ ClawHub

AgentCanary

by @mrcerq

Cross-asset market intelligence API for AI agents. 130+ endpoints across macro regime detection, risk scoring, trading signals (IGNITION/ACCUMULATION/DISTRIB...

Versionv1.0.7
Downloads1,928
Stars⭐ 1
#crypto-defi#api#legal
TERMINAL
clawhub install agentcanary

πŸ“– About This Skill

slug: agentcanary name: AgentCanary description: Cross-asset market intelligence API for AI agents. 130+ endpoints across macro regime detection, risk scoring, trading signals (IGNITION/ACCUMULATION/DISTRIBUTION/CAPITULATION), whale alerts, funding arbitrage, orderbook analytics, DeFi yields/PE ratios, BTC options (max pain, skew), central bank balance sheets, narrative crowding scores, sector rotation, Hindenburg omen, CAPE ratio, scenario probabilities, BTC ETF flows, geopolitical risk, mean reversion signals, institutional positioning (13F, short interest, CFTC COT), Reddit/X sentiment, and 4Γ— daily AI market briefs. Wallet-based auth, USDC/USDT on any major EVM chain (Base, Ethereum, Arbitrum, Optimism, Polygon). Use when an agent needs macro regime context, risk assessment, position sizing guidance, market structure data, whale monitoring, news sentiment, DeFi intelligence, options flow, or institutional positioning. API-only β€” no local execution, no filesystem access, no secrets in prompt.

AgentCanary

Cross-asset market intelligence for AI agents. 130+ endpoints. Not raw data β€” intelligence.

Base URL: https://api.agentcanary.ai/api Auth: Wallet-based API keys. Create key β†’ deposit USDC/USDT on any supported EVM chain β†’ use key as query param. Briefs: 4Γ— daily auto-generated intelligence β€” Radar (04:15), Signal (10:15), Pulse (16:15), Wrap (22:15 UTC). Telegram: @AgentCanary β€” live briefs. App: app.agentcanary.ai β€” dashboard, billing, API key management. Docs: api.agentcanary.ai/api/docs β€” interactive Swagger UI. Website: agentcanary.ai

Security

  • API-only β€” HTTP GET/POST returning JSON. No local code, no binaries, no shell commands.
  • No secrets in prompt β€” wallet-based auth. No API keys pass through the LLM context window.
  • Read-only β€” fetches data. Cannot write, modify, or access your filesystem.
  • No filesystem access β€” no file reads, no file writes, no directory listing.
  • Security headers β€” Helmet.js (X-Powered-By removed, XSS protection, content-type sniffing prevention, strict transport security).
  • Rate limiting β€” per-tier rate limits enforced server-side. Key creation: 5 attempts per 15 min per IP.
  • Body size limit β€” 1MB max request body. Rejects oversized payloads.
  • Error isolation β€” global uncaughtException/unhandledRejection handlers. Express error middleware. No stack traces in responses.
  • Multi-chain deposits β€” USDC/USDT accepted on Base, Ethereum, Arbitrum, Optimism, Polygon. Same deposit address on all chains.
  • VirusTotal verified β€” 0/62 detections.

    • Getting Started

    1. POST /api/keys/create  { walletAddress: "0x..." }  β†’ returns apiKey
2. Send USDC/USDT to the receiving address shown at agentcanary.ai (Base, Ethereum, Arbitrum, Optimism, Polygon)
3. POST /api/billing/check  { apiKey: "..." }  β†’ auto-detects payment, credits account
4. Use endpoints:  GET /api/data/realtime-prices?apikey=YOUR_KEY

    Minimum deposit: $5. Credits never expire. No subscriptions. No KYC.

    Pricing

    | Tier | Cumulative Deposit | Per Call | Rate Limit | Access | |------|-------------------|----------|------------|--------| | Explorer | Free | $0.02 | 10/min, 50/day | Prices, news, whale alerts, Fear & Greed, regime | | Builder | $50+ | $0.02 | 60/min, 5K/day | + macro, signals, calendar, volumes, newsletters | | Signal | $150+ | $0.015 | 120/min, 20K/day | All 130+ endpoints. AI reports. Orderbook. DeFi. Options. | | Institutional | $500+ | $0.01 | 300/min, unlimited | White-label. SLA. Custom integrations. |

    Default Agent Pattern

    1. GET /api/macro/regime every 4–6 hours β†’ classify risk environment
2. If Risk-Off β†’ suppress trading, reduce exposure
3. If Risk-On β†’ allow strategy execution, check signals
4. GET /api/data/whale-alerts every 15–30 min β†’ event-driven interrupts
5. GET /api/signals/decision-engine before entries β†’ multi-factor confirmation

    AgentCanary is risk intelligence middleware. It tells your agent when conditions are favorable β€” your agent decides what to do.

    Endpoint Categories

    Full endpoint documentation with response examples: references/endpoints.md

    Proprietary AC Endpoints (/api/...)

    | Category | Key Endpoints | Tier | |----------|--------------|------| | Indicators (36) | /indicators, /indicators/summary, /indicators/:name, /indicators/:name/history β€” includes Bull Market Support Band, Pi Cycle, Wyckoff Structure, Stablecoin Composite, Composite Risk Score, and 31 more | Explorer–Signal | | Scenarios | /scenarios/current, /scenarios/history, /scenarios/signals | Signal | | Briefs | /briefs/latest, /briefs/feed, /briefs/archive, /briefs/:type | Explorer–Signal | | Macro | /macro/regime, /macro/snapshot, /macro/signals, /macro/global-liquidity, /macro/us-m2, /macro/central-banks, /macro/supply-chain | Explorer–Builder | | Regime | /regime, /regime/matrix, /regime/history | Signal | | Signals | /signals/correlations, /signals/sector-rotation, /signals/btc-etf-flows, /signals/fear-greed, /signals/whale-alerts, /signals/geopolitical-risk, /signals/decision-engine + 26 more | Signal | | Narratives | /narratives, /narratives/history, /narratives/:name | Signal | | Expectations | /expectations, /expectations/rotation, /expectations/crowded, /expectations/early | Signal | | DeFi | /defi/intelligence, /defi/pe-ratios, /defi/yields, /defi/perps, /defi/stablecoins, /defi/chains, /defi/unlocks, /defi/signals | Signal | | BTC Options | /btc-options, /btc-options/maxpain, /btc-options/skew | Signal | | Central Banks | /central-banks, /central-banks/balance-sheets, /central-banks/btc, /central-banks/stablecoins, /central-banks/gold, /central-banks/reserves, /central-banks/tic | Signal | | Premiums | /premiums, /premiums/coinbase, /premiums/kimchi | Signal | | Predictions | /predictions, /predictions/movers, /predictions/:slug | Signal | | Sentiment | /sentiment/reddit | Signal | | Mean Reversion | /mr/signals, /mr/trades, /mr/stats | Signal | | Hindenburg | /hindenburg, /hindenburg/history | Signal | | CAPE | /cape | Signal | | Kill Conditions | /kill-conditions | Signal | | Crypto Re-entry | /crypto-reentry, /crypto-reentry/history | Signal | | Institutional | /institutional/13f | Signal | | News | /news/trending, /news/stats, /news/market-analysis, /news/xtg-analysis | Signal |

    Data Endpoints (/api/data/...)

    Cached datasets refreshed on schedule. 26 datasets covering prices, macro, crypto, news, institutional, calendar.

    | Dataset | Tier | Description | |---------|------|-------------| | realtime-prices | Explorer | 100+ crypto tokens, 24h change | | yahoo-quotes | Builder | SPY, QQQ, VIX, TLT, DXY, Oil, 16 sector ETFs, stocks | | whale-alerts | Explorer | Large crypto transactions | | breaking-news | Explorer | Financial news with FinBERT sentiment | | fear-greed | Explorer | Crypto Fear & Greed Index | | macro-snapshot | Builder | 30+ FRED series, regime, risk gauge, z-scores | | funding-rates | Builder | Perpetual funding rates across exchanges | | financial-calendar | Builder | High-impact economic events | | newsletters | Builder | Curated newsletter intelligence | | narrative-scores | Signal | 21 narrative themes, crowding 1–5 | | btc-etf-flows | Signal | Bitcoin ETF daily flows | | reddit-sentiment | Signal | 14 subreddit sentiment analysis | | decision-engine | Signal | Multi-factor crypto re-entry scoring | | scenario-probs | Signal | 6 macro scenario probabilities |

    Plus 12 more datasets. Full list in references/endpoints.md.

    Signal Cadence Guide

    | Signal | Update Frequency | Recommended Cadence | |--------|-----------------|-------------------| | Macro regime | Every 6h | Every 4–6 hours | | Signal states (1d) | Daily close | Every 4–6 hours | | Whale alerts | Real-time | Every 15–30 min | | Funding rates | Every 8h | Every 4–8 hours | | Breaking news | Real-time | Every 15–30 min | | Briefs | 4Γ— daily | After each brief window | | DeFi yields | Every 4h | Every 4–6 hours | | BTC options | Daily | Every 4–6 hours |

    What It Does Not Do

  • Does not predict prices β€” classifies regimes and states
  • Does not place orders or replace execution logic
  • Does not provide financial advice
  • Does not guarantee returns

    • *AgentCanary provides market data and intelligence for informational purposes only. Nothing constitutes financial advice.*

    πŸ’‘ Examples

    1. POST /api/keys/create  { walletAddress: "0x..." }  β†’ returns apiKey
2. Send USDC/USDT to the receiving address shown at agentcanary.ai (Base, Ethereum, Arbitrum, Optimism, Polygon)
3. POST /api/billing/check  { apiKey: "..." }  β†’ auto-detects payment, credits account
4. Use endpoints:  GET /api/data/realtime-prices?apikey=YOUR_KEY

    Minimum deposit: $5. Credits never expire. No subscriptions. No KYC.