Public reference · agent gating logic

Source contracts.

28 datasets, each with a published freshness SLA. Fresh = age < SLA. Degraded = SLA ≤ age < 2×SLA. Stale = age ≥ 2×SLA.

Every /api/data/:name response includes a provenance field with observed_at, age_seconds, and freshness_status. Agents should gate on status before consuming.

Prices

Dataset	What it covers	Freshness SLA	Origin
`realtime-prices`	Real-time prices for 100+ crypto tokens including BTC, ETH, SOL, with 24h change and volume. Updated every 5 minutes from CoinGecko + exchange feeds.	5min	CoinGecko + exchange APIs
`market-quotes`	Stock and ETF quotes — SPY, QQQ, VIX, TLT, DXY plus 16 sector ETFs and major individual equities. Sourced from Yahoo Finance, 15-minute cadence during market hours.	15min	Yahoo Finance
`exchange-volumes`	Trading volumes aggregated across major centralized crypto exchanges (Binance, Coinbase, Kraken, Bybit, OKX). Reveals where liquidity concentrates by asset.	30min	CoinGecko aggregated

Macro

Dataset	What it covers	Freshness SLA	Origin
`macro-snapshot`	Composite macro snapshot — 30+ FRED economic series (rates, inflation, employment), AC regime classification, risk gauge composite, and z-scores per series.	6h	FRED (St. Louis Fed)
`vix-term-structure`	VIX futures term structure showing contango or backwardation across upcoming expirations. Tells you whether near-term volatility is priced richer than longer-dated.	15min	CBOE via Yahoo
`cftc-cot`	CFTC Commitment of Traders weekly report — net positioning of commercial hedgers, large speculators, and small traders across futures and options markets.	7d	CFTC weekly Friday
`treasury-stats`	US Treasury daily statistics — debt outstanding, cash balance, issuance schedule. Drawn from Treasury.gov daily statement releases.	1d	US Treasury Direct

Crypto

Dataset	What it covers	Freshness SLA	Origin
`whale-alerts`	Large on-chain crypto transactions filtered for $10M+ moves. Tracks wallet-to-wallet, exchange inflows, and exchange outflows across major chains.	30min	Whale Alert + Hyperliquid
`funding-rates`	Perpetual futures funding rates aggregated across major crypto exchanges. Positive = longs paying shorts; persistent extremes signal positioning crowding.	1h	Coinglass + exchange APIs
`btc-etf-flows`	Daily net flows for the major Bitcoin spot ETFs (IBIT, FBTC, ARKB, BITB, GBTC, and others). Tracks institutional accumulation or distribution.	1d	ETF issuer disclosures
`fear-greed`	Crypto Fear & Greed Index — composite sentiment score (0-100) blending volatility, momentum, social signals, and dominance. Updated daily.	1d	Alternative.me
`coingecko-global`	Global crypto market metrics — total market cap, 24h volume, BTC dominance, ETH dominance, stablecoin marketcap. Sourced from CoinGecko global endpoint.	1h	CoinGecko global
`btc-options`	Bitcoin options market data including open interest by strike, put/call ratios, max-pain levels, and 25-delta skew across Deribit + other major venues.	1h	Deribit + Coinglass
`coinglass-v2`	Aggregate open interest and liquidation data across 21 exchanges for 43 tracked crypto perps. Surfaces leverage buildup and forced-deleveraging events.	6h	Coinglass v2 API

News & Sentiment

Dataset	What it covers	Freshness SLA	Origin
`breaking-news`	Breaking financial news aggregated from multiple wire services with FinBERT-based sentiment scoring (POSITIVE / NEGATIVE / NEUTRAL) and entity extraction.	30min	Multiple wire aggregators
`newsletters`	Curated intelligence digest from selected market newsletters and research desks. Distilled into structured items with source attribution and topic tags.	12h	AC-curated sources
`reddit-sentiment`	Cross-subreddit sentiment scoring across 14 finance and crypto subs (r/wallstreetbets, r/cryptocurrency, r/stocks, r/algotrading and others). Updated every 6h.	6h	Reddit API
`narrative-scores`	Narrative crowding scores across 21 themes (AI, energy, defense, crypto, healthcare, biotech, etc.) — measures how concentrated attention is on each theme.	1d	AC proprietary scoring

Institutional

Dataset	What it covers	Freshness SLA	Origin
`sec-13f`	SEC 13F institutional holdings — quarterly filings showing top positions of asset managers above $100M AUM. Covers Berkshire, Bridgewater, Citadel and others.	7d	SEC EDGAR
`wikipedia-pageviews`	Wikipedia pageview trends for asset tickers and company names. Cross-reference between retail attention and price action.	1d	Wikipedia REST API
`short-interest`	Short interest data for 39 tracked stocks — shares short, days to cover, short interest ratio. FINRA bi-monthly release.	14d	FINRA bi-monthly
`etf-fund-flows`	Estimated daily net flows for 44 tracked ETFs spanning equity sectors, fixed income, commodities, and thematic categories. Reveals institutional allocation shifts.	1d	Issuer + exchange disclosures
`etf-options-pcr`	Options put/call ratios for 42 major ETFs. High P/C = bearish hedging or speculation; persistent shifts reveal sentiment regime changes.	1d	CBOE + exchange options data

Calendar & Proprietary

Dataset	What it covers	Freshness SLA	Origin
`financial-calendar`	High-impact economic events calendar — CPI, NFP, FOMC, GDP, retail sales, central bank meetings — with previous, forecast, and actual values when released.	6h	AC-curated + Investing.com
`polymarket`	Polymarket prediction market events — implied probabilities for elections, geopolitics, economic outcomes, and macro events. Higher liquidity = more reliable signal.	1h	Polymarket public API
`decision-engine`	AgentCanary proprietary multi-factor crypto re-entry scoring system combining technical, on-chain, sentiment, and macro signals into a 0-100 directional score.	6h	AC proprietary
`risk-summary`	Daily AgentCanary composite risk assessment integrating macro regime state, volatility regime, credit spreads, and cross-asset correlations into a single risk gauge.	6h	AC proprietary
`scenario-probs`	AgentCanary forward-looking macro scenario probabilities across 6 canonical states (overheating, expansion, stagflation, contraction, recession, displacement).	6h	AC proprietary

Reading provenance from /api/data

Each dataset response includes:

{
  "dataset": "market-quotes",
  "date": "2026-05-19",
  "data": { ... },
  "provenance": {
    "source": "market-quotes",
    "observed_at": "2026-05-19T06:00:00.000Z",
    "age_seconds": 420,
    "sla_seconds": 900,
    "freshness_status": "fresh"
  }
}

Defensive agent pattern: skip the dataset if freshness_status === "stale"; degrade gracefully (warn, use fallback, or proceed with annotation) if "degraded"; consume freely if "fresh".

If you spot drift between published SLA and observed behavior, that is a bug — file at github.com/MrCerq/agentcanary-backend/issues.