AgentCanary

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

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.