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
CODEBLOCK0
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
CODEBLOCK1
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) | INLINECODE2 , /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 |
|---|
| INLINECODE77 | Explorer | 100+ crypto tokens, 24h change |
| INLINECODE78 |
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.AgentCanary
面向AI代理的跨资产市场情报。130+个端点。不是原始数据——是情报。
基础URL： https://api.agentcanary.ai/api
认证： 基于钱包的API密钥。创建密钥→在任何支持的EVM链上存入USDC/USDT→将密钥作为查询参数使用。
简报： 每日4次自动生成的情报——雷达（04:15）、信号（10:15）、脉搏（16:15）、总结（22:15 UTC）。
Telegram： @AgentCanary——实时简报。
应用： app.agentcanary.ai——仪表盘、计费、API密钥管理。
文档： api.agentcanary.ai/api/docs——交互式Swagger UI。
网站： agentcanary.ai
安全性
- - 仅API——HTTP GET/POST返回JSON。无本地代码、无二进制文件、无shell命令。
- 提示中无密钥——基于钱包的认证。API密钥不经过LLM上下文窗口。
- 只读——获取数据。无法写入、修改或访问您的文件系统。
- 无文件系统访问——不读取文件、不写入文件、不列出目录。
- 安全标头——Helmet.js（移除X-Powered-By、XSS保护、内容类型嗅探防护、严格传输安全）。
- 速率限制——按层级在服务端强制执行速率限制。密钥创建：每15分钟每个IP 5次尝试。
- 请求体大小限制——最大请求体1MB。拒绝超载负载。
- 错误隔离——全局未捕获异常/未处理拒绝处理器。Express错误中间件。响应中不包含堆栈跟踪。
- 多链存款——在Base、以太坊、Arbitrum、Optimism、Polygon上接受USDC/USDT。所有链上存款地址相同。
- VirusTotal已验证——0/62检测。
快速开始
- 1. POST /api/keys/create { walletAddress: 0x... } → 返回 apiKey
- 将USDC/USDT发送至agentcanary.ai显示的收款地址（Base、以太坊、Arbitrum、Optimism、Polygon）
- POST /api/billing/check { apiKey: ... } → 自动检测付款，为账户充值
- 使用端点： GET /api/data/realtime-prices?apikey=YOUR_KEY
最低存款：$5。积分永不过期。无订阅。无需KYC。
定价
| 层级 | 累计存款 | 每次调用 | 速率限制 | 访问权限 |
|---|
| 探索者 | 免费 | $0.02 | 10次/分钟，50次/天 | 价格、新闻、鲸鱼警报、恐惧与贪婪、市场状态 |
| 建设者 |
$50+ | $0.02 | 60次/分钟，5000次/天 | +宏观、信号、日历、成交量、新闻简报 |
| 信号 | $150+ | $0.015 | 120次/分钟，20000次/天 | 全部130+个端点。AI报告。订单簿。DeFi。期权。 |
| 机构 | $500+ | $0.01 | 300次/分钟，无限制 | 白标。SLA。自定义集成。 |
默认代理模式
- 1. 每4-6小时 GET /api/macro/regime → 分类风险环境
- 如果风险规避 → 抑制交易，降低敞口
- 如果风险偏好 → 允许策略执行，检查信号
- 每15-30分钟 GET /api/data/whale-alerts → 事件驱动中断
- 入场前 GET /api/signals/decision-engine → 多因素确认
AgentCanary是风险情报中间件。它告诉您的代理何时条件有利——您的代理决定做什么。
端点分类
包含响应示例的完整端点文档：references/endpoints.md
专有AC端点（/api/...）
| 类别 | 关键端点 | 层级 |
|---|
| 指标（36个） | /indicators、/indicators/summary、/indicators/:name、/indicators/:name/history——包括牛市支撑带、Pi周期、Wyckoff结构、稳定币综合指数、综合风险评分等31个 | 探索者–信号 |
| 情景 |
/scenarios/current、/scenarios/history、/scenarios/signals | 信号 |
|
简报 | /briefs/latest、/briefs/feed、/briefs/archive、/briefs/:type | 探索者–信号 |
|
宏观 | /macro/regime、/macro/snapshot、/macro/signals、/macro/global-liquidity、/macro/us-m2、/macro/central-banks、/macro/supply-chain | 探索者–建设者 |
|
市场状态 | /regime、/regime/matrix、/regime/history | 信号 |
|
信号 | /signals/correlations、/signals/sector-rotation、/signals/btc-etf-flows、/signals/fear-greed、/signals/whale-alerts、/signals/geopolitical-risk、/signals/decision-engine + 26个 | 信号 |
|
叙事 | /narratives、/narratives/history、/narratives/:name | 信号 |
|
预期 | /expectations、/expectations/rotation、/expectations/crowded、/expectations/early | 信号 |
|
DeFi | /defi/intelligence、/defi/pe-ratios、/defi/yields、/defi/perps、/defi/stablecoins、/defi/chains、/defi/unlocks、/defi/signals | 信号 |
|
BTC期权 | /btc-options、/btc-options/maxpain、/btc-options/skew | 信号 |
|
央行 | /central-banks、/central-banks/balance-sheets、/central-banks/btc、/central-banks/stablecoins、/central-banks/gold、/central-banks/reserves、/central-banks/tic | 信号 |
|
溢价 | /premiums、/premiums/coinbase、/premiums/kimchi | 信号 |
|
预测 | /predictions、/predictions/movers、/predictions/:slug | 信号 |
|
情绪 | /sentiment/reddit | 信号 |
|
均值回归 | /mr/signals、/mr/trades、/mr/stats | 信号 |
|
兴登堡 | /hindenburg、/hindenburg/history | 信号 |
|
CAPE | /cape | 信号 |
|
终止条件 | /kill-conditions | 信号 |
|
加密市场再入场 | /crypto-reentry、/crypto-reentry/history | 信号 |
|
机构 | /institutional/13f | 信号 |
|
新闻 | /news/trending、/news/stats、/news/market-analysis、/news/xtg-analysis | 信号 |
数据端点（/api/data/...）
按计划刷新的缓存数据集。26个数据集涵盖价格、宏观、加密、新闻、机构、日历。
| 数据集 | 层级 | 描述 |
|---|
| realtime-prices | 探索者 | 100+加密代币，24小时变化 |
| yahoo-quotes |
建设者 | SPY、QQQ、VIX、TLT、DXY、石油、16个行业ETF、股票 |
| whale-alerts | 探索者 | 大型加密交易 |
| breaking-news | 探索
