AgentCanary
Market intelligence for AI agents. 33 API endpoints. Not raw data — intelligence.
Status: Preview. API access opening soon. Free tier: real-time prices (50 calls/day).
Live proof: @AgentCanary on Telegram — 3x/day auto-generated market intelligence from the same API.
Website: agentcanary.ai
Waitlist: Sign up at agentcanary.ai to get notified when API access opens.
This API powers Proximity, a crypto intelligence iOS app with 6 months of daily usage across 20+ countries.
Security
- API-only — HTTP GET calls returning JSON. No local code, no binaries, no shell commands.
- No secrets in the prompt — wallet-based auth when billing is live.
- Read-only — fetches data. Cannot write, modify, or access your filesystem.
824 malicious skills were found on ClawHub. Crypto and finance is the #1 target category. AgentCanary is the finance skill that can't steal from you.
Default Agent Pattern
1. Call /macro-snapshot/regime every 4–6 hours
2. If Risk-Off → suppress trading, reduce exposure
3. If Risk-On → allow strategy execution
4. Use severity alerts as interrupts, not drivers
5. Call /signal-state before entering positions for confirmation
AgentCanary is risk intelligence middleware. It tells your agent when conditions are favorable — your agent decides what to do.
What It Does Not Do
- Does not predict prices — classifies regimes and states
- Does not guarantee returns
- Does not place orders or replace execution logic
- Does not provide financial advice
Capabilities (33 Endpoints)
For full endpoint documentation with real response examples, read references/endpoints.md.
Macro & Regime
| Endpoint |
What it returns |
/macro-snapshot |
Regime, business cycle, risk gauge, z-scores on 26 FRED indicators |
/macro-snapshot/regime |
Regime label, flags, composite scores, explanation |
/market-analysis/latest |
AI-generated daily report: sentiment, fear & greed, narratives, alerts |
Signals & Technicals
| Endpoint |
What it returns |
/signal-state |
100 coins, IGNITION/ACCUMULATION/DISTRIBUTION/CAPITULATION on 1d + 4h |
/cointa?id={coinId} |
29 technical indicators, composite buy/sell signal, 365 data points |
/coin-rsi/statistics |
606 coins RSI screening, overbought/oversold ranked lists |
/coin-rsi/multi?coinids={id} |
6-timeframe RSI (5m to 1w) per coin |
/roc/{coinId} |
90-day rate of change, acceleration, volatility, percentile bands |
Market Structure & Orderbook
| Endpoint |
What it returns |
/market-structure |
BTC funding, liquidations, OI, crowding scores, signal |
/orderbook/depth |
8 liquidity bands, top bid/ask walls, notional USD |
/orderbook/wall-persistence |
Wall persistence tracking over time |
/orderbook/liquidity-change |
Liquidity shift detection |
Whales & Funding
| Endpoint |
What it returns |
/whale-alerts |
On-chain whale transactions with symbol, amount, USD value |
/hyperliquid-whale-alerts |
HL whale position changes with entry/liq prices |
/hyperliquid-whale-positions |
Current whale positions: leverage, margin, unrealized PnL |
/fundingrate/arbitrage/top |
Top 10 cross-exchange arb opportunities by APR |
News & Social
| Endpoint |
What it returns |
/news/breaking |
Real-time news, FinBERT sentiment + confidence, auto-extracted tickers |
/newsletters |
50+ newsletters daily, full-text parsed, tickers, categories |
/xtg-messages |
300+ messages/day from 200+ X & Telegram channels, FinBERT scored |
Prices & Data
| Endpoint |
What it returns |
/realtime-prices |
1,181 assets (941 crypto, 195 stocks, 34 FX, 10 commodities) |
/chartdata |
OHLCV candles, configurable resolution (1m to 1d), date range |
/usdt-dominance |
USDT dominance as risk-on/risk-off signal |
/usdc-dominance |
USDC dominance |
/exchange-volumes |
Aggregated exchange trading volumes |
/exchange-assets |
39+ exchange wallets, balance + USD value per exchange |
Calendar, Treasury & Prediction
| Endpoint |
What it returns |
/financial-calendar/high-impact |
Global macro events, impact scoring, forecast/previous values |
/treasury/stats |
209 entities, 35 countries, $137B+ tracked crypto treasuries |
/polymarket/events/current |
FOMC decision odds from Polymarket |
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 |
| Signal states (4h) |
Every 4h |
Every 1–2 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 |
| Prices |
Near real-time |
As needed |
Pricing (Coming Soon)
| Tier |
Deposit |
Per Call |
Access |
| Explorer |
Free |
— |
Real-time prices only. 50 calls/day. |
| Builder |
$50 USDC |
$0.005 |
Prices + macro + regime + signals + news |
| Signal |
$150 USDC |
$0.003 |
All 33 endpoints. AI reports. Orderbook. |
| Institutional |
$500 USDC |
$0.002 |
Unlimited. White-label. SLA. |
Deposit USDC, EURC, USDT, or SOL on Base, Solana, or Ethereum. Credits never expire. No subscriptions. No KYC.
Links
AgentCanary provides market data and intelligence for informational purposes only. Nothing constitutes financial advice.
1---2name: agentcanary3description: Market intelligence API for AI agents. Macro regime detection, risk scoring, trading signals (IGNITION/ACCUMULATION/DISTRIBUTION/CAPITULATION), whale alerts, funding arbitrage, orderbook analytics, 29 technical indicators, RSI screening (606 coins), breaking news with FinBERT sentiment, economic calendar, treasury tracking, and Polymarket odds. 33 endpoints, 1181 assets, 250+ sources. Use when an agent needs macro regime context, risk assessment, position sizing guidance, market structure data, whale activity monitoring, or news sentiment. API-only — no local execution, no filesystem access, no secrets in prompt.4---56# AgentCanary78Market intelligence for AI agents. 33 API endpoints. Not raw data — intelligence.910**Status:** Preview. API access opening soon. Free tier: real-time prices (50 calls/day).11**Live proof:** [@AgentCanary on Telegram](https://t.me/AgentCanary) — 3x/day auto-generated market intelligence from the same API.12**Website:** [agentcanary.ai](https://agentcanary.ai)13**Waitlist:** Sign up at [agentcanary.ai](https://agentcanary.ai) to get notified when API access opens.1415> This API powers Proximity, a crypto intelligence iOS app with 6 months of daily usage across 20+ countries.1617---1819## Security2021- **API-only** — HTTP GET calls returning JSON. No local code, no binaries, no shell commands.22- **No secrets in the prompt** — wallet-based auth when billing is live.23- **Read-only** — fetches data. Cannot write, modify, or access your filesystem.2425824 malicious skills were found on ClawHub. Crypto and finance is the #1 target category. AgentCanary is the finance skill that can't steal from you.2627---2829## Default Agent Pattern3031```321. Call /macro-snapshot/regime every 4–6 hours332. If Risk-Off → suppress trading, reduce exposure343. If Risk-On → allow strategy execution354. Use severity alerts as interrupts, not drivers365. Call /signal-state before entering positions for confirmation37```3839AgentCanary is risk intelligence middleware. It tells your agent **when conditions are favorable** — your agent decides what to do.4041---4243## What It Does Not Do4445- Does not predict prices — classifies regimes and states46- Does not guarantee returns47- Does not place orders or replace execution logic48- Does not provide financial advice4950---5152## Capabilities (33 Endpoints)5354For full endpoint documentation with real response examples, read [references/endpoints.md](references/endpoints.md).5556### Macro & Regime57| Endpoint | What it returns |58|----------|----------------|59| `/macro-snapshot` | Regime, business cycle, risk gauge, z-scores on 26 FRED indicators |60| `/macro-snapshot/regime` | Regime label, flags, composite scores, explanation |61| `/market-analysis/latest` | AI-generated daily report: sentiment, fear & greed, narratives, alerts |6263### Signals & Technicals64| Endpoint | What it returns |65|----------|----------------|66| `/signal-state` | 100 coins, IGNITION/ACCUMULATION/DISTRIBUTION/CAPITULATION on 1d + 4h |67| `/cointa?id={coinId}` | 29 technical indicators, composite buy/sell signal, 365 data points |68| `/coin-rsi/statistics` | 606 coins RSI screening, overbought/oversold ranked lists |69| `/coin-rsi/multi?coinids={id}` | 6-timeframe RSI (5m to 1w) per coin |70| `/roc/{coinId}` | 90-day rate of change, acceleration, volatility, percentile bands |7172### Market Structure & Orderbook73| Endpoint | What it returns |74|----------|----------------|75| `/market-structure` | BTC funding, liquidations, OI, crowding scores, signal |76| `/orderbook/depth` | 8 liquidity bands, top bid/ask walls, notional USD |77| `/orderbook/wall-persistence` | Wall persistence tracking over time |78| `/orderbook/liquidity-change` | Liquidity shift detection |7980### Whales & Funding81| Endpoint | What it returns |82|----------|----------------|83| `/whale-alerts` | On-chain whale transactions with symbol, amount, USD value |84| `/hyperliquid-whale-alerts` | HL whale position changes with entry/liq prices |85| `/hyperliquid-whale-positions` | Current whale positions: leverage, margin, unrealized PnL |86| `/fundingrate/arbitrage/top` | Top 10 cross-exchange arb opportunities by APR |8788### News & Social89| Endpoint | What it returns |90|----------|----------------|91| `/news/breaking` | Real-time news, FinBERT sentiment + confidence, auto-extracted tickers |92| `/newsletters` | 50+ newsletters daily, full-text parsed, tickers, categories |93| `/xtg-messages` | 300+ messages/day from 200+ X & Telegram channels, FinBERT scored |9495### Prices & Data96| Endpoint | What it returns |97|----------|----------------|98| `/realtime-prices` | 1,181 assets (941 crypto, 195 stocks, 34 FX, 10 commodities) |99| `/chartdata` | OHLCV candles, configurable resolution (1m to 1d), date range |100| `/usdt-dominance` | USDT dominance as risk-on/risk-off signal |101| `/usdc-dominance` | USDC dominance |102| `/exchange-volumes` | Aggregated exchange trading volumes |103| `/exchange-assets` | 39+ exchange wallets, balance + USD value per exchange |104105### Calendar, Treasury & Prediction106| Endpoint | What it returns |107|----------|----------------|108| `/financial-calendar/high-impact` | Global macro events, impact scoring, forecast/previous values |109| `/treasury/stats` | 209 entities, 35 countries, $137B+ tracked crypto treasuries |110| `/polymarket/events/current` | FOMC decision odds from Polymarket |111112---113114## Signal Cadence Guide115116| Signal | Update Frequency | Recommended Cadence |117|--------|-----------------|-------------------|118| Macro regime | Every 6h | Every 4–6 hours |119| Signal states (1d) | Daily close | Every 4–6 hours |120| Signal states (4h) | Every 4h | Every 1–2 hours |121| Whale alerts | Real-time | Every 15–30 min |122| Funding rates | Every 8h | Every 4–8 hours |123| Breaking news | Real-time | Every 15–30 min |124| Prices | Near real-time | As needed |125126---127128## Pricing (Coming Soon)129130| Tier | Deposit | Per Call | Access |131|------|---------|---------|--------|132| Explorer | Free | — | Real-time prices only. 50 calls/day. |133| Builder | $50 USDC | $0.005 | Prices + macro + regime + signals + news |134| Signal | $150 USDC | $0.003 | All 33 endpoints. AI reports. Orderbook. |135| Institutional | $500 USDC | $0.002 | Unlimited. White-label. SLA. |136137Deposit USDC, EURC, USDT, or SOL on Base, Solana, or Ethereum. Credits never expire. No subscriptions. No KYC.138139---140141## Links142143- **Telegram:** [t.me/AgentCanary](https://t.me/AgentCanary) — live market intelligence 3x/day144- **Website:** [agentcanary.ai](https://agentcanary.ai)145146---147148*AgentCanary provides market data and intelligence for informational purposes only. Nothing constitutes financial advice.*
dvcrn