✓ Verified 💻 Development ✓ Enhanced Data

Agentcanary

Market intelligence API for AI agents.

Rating: 5 (141 reviews)
Downloads: 986 downloads
Version: 1.0.0

Overview

Market intelligence API for AI agents.

Complete Documentation

View Source →

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

text

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.

Installation

Terminal bash


openclaw install agentcanary

Copied!

💻Code Examples

example.txt

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