# AgentCanary — Market Intelligence for Agents & Humans
# https://agentcanary.ai

## What This Is
AgentCanary is a macro market intelligence platform. We publish
4 daily briefs tracking regime states, whale alerts, narrative
momentum, scenario analysis, and macro signals across crypto,
equities, commodities, and forex. Every prediction is scored
against actual prices 72 hours later.

## How Agents Can Use This
- **MCP Server**: `npx agentcanary-mcp` — 8 tools for Claude, Cursor, Windsurf, any MCP client
- **REST API**: api.agentcanary.ai — JSON endpoints with API key auth
- **JSON Feed**: agentcanary.ai/record/feed.json (JSON Feed 1.1)
- **RSS Feed**: agentcanary.ai/record/rss.xml (RSS 2.0)
- **Structured Data**: JSON-LD on every page

## Getting an API Key
POST https://api.agentcanary.ai/api/keys/create
Body: {"walletAddress": "0xYOUR_WALLET", "chain": "base"}
Returns: API key + deposit address. Free Explorer tier immediately.
Upgrade by depositing USDC/USDT on Base, Arbitrum, Optimism, Polygon, or Ethereum.

## Tiers & Pricing
- Explorer (free): Briefs + scores. 50 calls/day.
- Builder ($50 USDC deposit): + indicators, regime, narratives, news, predictions. 500 calls/day.
- Signal ($150 USDC): + scenario analysis, positioning, full content. 2000 calls/day.
- Institutional ($500 USDC): Unlimited. White-label. SLA.
Per-call cost: $0.01-0.02 deducted from deposit balance.

## API Endpoints (authenticated)
Base URL: https://api.agentcanary.ai/api
- GET /briefs/archive?limit=50 — Daily intelligence briefs (public)
- GET /indicators — 36 proprietary indicators (Bull Market Support Band, Pi Cycle, Wyckoff, Stablecoin Composite, Composite Risk Score + 31 more)
- GET /regime — Macro regime classification + transition probabilities
- GET /predictions — Prediction market data (Polymarket, Kalshi)
- GET /narratives — Narrative momentum scores (AI, energy, defense, crypto...)
- GET /news?limit=20 — Aggregated market news
- GET /scenarios — Forward scenario analysis
- GET /sentiment — Market sentiment composite
Auth: x-api-key header

## MCP Server Setup
```json
{
  "mcpServers": {
    "agentcanary": {
      "command": "npx",
      "args": ["agentcanary-mcp"],
      "env": { "AC_API_KEY": "ac_your_key" }
    }
  }
}
```

## Data Available
- Daily briefs: 4x per day (04:15, 10:15, 16:15, 22:15 UTC)
- Regime tracking: expansion, stagflation, late-cycle, recession, displacement, neutral
- Risk gauge: 0-100 continuous score
- Whale alerts: on-chain large transactions
- Narrative scores: 18 themes, lifecycle tracking (birth → peak → fade)
- Scenario targets: 2-3 forward scenarios with specific price ranges per day
- Prediction scoring: hit/miss/partial evaluation after 72 hours
- 36 indicators: Bull Market Support Band, Pi Cycle, Wyckoff Structure, Stablecoin Composite, Composite Risk Score, sector rotation, CAPE ratio, Hindenburg omen, geopolitical risk + 27 more

## Prediction Scoring
Every Signal Scan brief contains forward scenarios with price targets.
After 72 hours, we score each target against actual prices:
- Hit: price entered predicted range
- Partial: correct direction, didn't reach range
- Miss: wrong direction
Scoring data: https://agentcanary.ai/record/data/predictions.json

## URL Patterns
- Daily pages: /record/YYYY/MM/DD/ (e.g., /record/2026/03/17/)
- Archive: /record/
- Predictions data: /record/data/predictions.json
- Price cache: /record/data/price-cache.json
- Sitemap: /sitemap.xml

## Historical Coverage
- Archive begins: March 9, 2026
- Growing daily — continuous coverage, 7 days/week

## Contact
- Telegram: t.me/agentcanary / @agentcanary
- Site: https://agentcanary.ai