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.
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
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.
| 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. |
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.
Full endpoint documentation with response examples: references/endpoints.md
/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 |
/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 | 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 |
AgentCanary provides market data and intelligence for informational purposes only. Nothing constitutes financial advice.