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---5
6# AgentCanary
7
8Market intelligence for AI agents. 33 API endpoints. Not raw data — intelligence.
9
10**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.
14
15> This API powers Proximity, a crypto intelligence iOS app with 6 months of daily usage across 20+ countries.
16
17---
18
19## Security
20
21- **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.
24
25824 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.
26
27---
28
29## Default Agent Pattern
30
31```
321. Call /macro-snapshot/regime every 4–6 hours
332. If Risk-Off → suppress trading, reduce exposure
343. If Risk-On → allow strategy execution
354. Use severity alerts as interrupts, not drivers
365. Call /signal-state before entering positions for confirmation
37```
38
39AgentCanary is risk intelligence middleware. It tells your agent **when conditions are favorable** — your agent decides what to do.
40
41---
42
43## What It Does Not Do
44
45- Does not predict prices — classifies regimes and states
46- Does not guarantee returns
47- Does not place orders or replace execution logic
48- Does not provide financial advice
49
50---
51
52## Capabilities (33 Endpoints)
53
54For full endpoint documentation with real response examples, read [references/endpoints.md](references/endpoints.md).
55
56### Macro & Regime
57| 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 |
62
63### Signals & Technicals
64| 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 |
71
72### Market Structure & Orderbook
73| 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 |
79
80### Whales & Funding
81| 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 |
87
88### News & Social
89| 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 |
94
95### Prices & Data
96| 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 |
104
105### Calendar, Treasury & Prediction
106| 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 |
111
112---
113
114## Signal Cadence Guide
115
116| 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 |
125
126---
127
128## Pricing (Coming Soon)
129
130| 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. |
136
137Deposit USDC, EURC, USDT, or SOL on Base, Solana, or Ethereum. Credits never expire. No subscriptions. No KYC.
138
139---
140
141## Links
142
143- **Telegram:** [t.me/AgentCanary](https://t.me/AgentCanary) — live market intelligence 3x/day
144- **Website:** [agentcanary.ai](https://agentcanary.ai)
145
146---
147
148*AgentCanary provides market data and intelligence for informational purposes only. Nothing constitutes financial advice.*
modbender