AgentCanary

# 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](https://t.me/AgentCanary) — live briefs. **App:** [app.agentcanary.ai](https://app.agentcanary.ai) — dashboard, billing, API key management. **Docs:** [api.agentcanary.ai/api/docs](https://api.agentcanary.ai/api/docs) — interactive Swagger UI. **Website:** [agentcanary.ai](https://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](https://www.virustotal.com/gui/file/4e0f571c854a308dd641e9b6e06299413735e10a32b54e9b3d23df77715ec314/detection). --- ## 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](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](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.*