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 | /indicators, /indicators/summary, /indicators/:name | Explorer–Builder |
| 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/decision-engine + 27 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.