# FeedOracle - Full API Reference
> Evidence-grade data infrastructure for regulated Web3 workflows
> Architecture: CORE (RWA Risk Oracle) + Module 1 (MiCA) + Module 2 (Carbon/ESG) + Module 3 (DORA) + Module 4 (CSRD/ESRS) + MCP Agent Layer
> 190+ endpoints across 15 categories | 61+ protocols | 86 FRED + 20 ECB series
> Version: 5.0.0 (February 2026)
> Base URL: https://api.feedoracle.io
> Auth: X-API-Key header (many endpoints public)
> OpenAPI: https://feedoracle.io/.well-known/openapi.json
> Summary: https://feedoracle.io/llms.txt

## Agents (4 endpoints)
- GET /api/v1/feeds/agents/health - Agents feed health
- GET /api/v1/feeds/agents/ranking - AI agent token ranking
- GET /api/v1/feeds/agents/trends - AI agent trends
- GET /api/v1/feeds/agents/{symbol} - Single AI agent data

## Attestation (4 endpoints)
- GET /api/v2/attestation/activity - Recent anchor activity
- GET /api/v2/attestation/chains - Multi-chain anchor status
- GET /api/v2/attestation/status - DAP system status
- GET /api/v2/attestation/verify/{aid} - Verify attestation by ID

## Attestations (2 endpoints)
- GET /api/v3/attestations/verify/{attestation_id} - Verify attestation on-chain
- GET /api/v3/attestations/{attestation_id} - Get attestation by ID

## Business (3 endpoints)
- GET /api/v1/macro/business - Business overview
- GET /api/v1/macro/business/credit - Business credit
- GET /api/v1/macro/business/production - Industrial production

## Carbon (5 endpoints)
- GET /api/v1/carbon/chains - Carbon data for 50+ blockchains (public)
- GET /api/v1/carbon/mica/{symbol} - MiCA-formatted carbon data
- GET /api/v1/carbon/summary - Carbon summary (alternate path)
- GET /api/v1/feeds/carbon/chains - Carbon data for all 49 blockchain networks
- GET /api/v1/feeds/carbon/summary - Carbon summary statistics

## Commodities (3 endpoints)
- GET /api/v1/macro/commodities - All commodities
- GET /api/v1/macro/commodities/energy - Energy prices
- GET /api/v1/macro/commodities/metals - Precious metals

## Credit (4 endpoints)
- GET /api/v1/macro/credit - Credit spreads
- GET /api/v1/macro/fed-rates - Fed overnight rates
- GET /api/v1/macro/lending - Bank lending
- GET /api/v1/macro/sofr - SOFR rate

## Crypto (2 endpoints)
- GET /api/v1/macro/crypto - Crypto prices
- GET /api/v1/macro/crypto/{symbol} - Single crypto

## Disclosure (2 endpoints)
- GET /api/v3/disclosure/networks - All networks with sustainability disclosure
- GET /api/v3/disclosure/sustainability/{symbol} - Single network sustainability report

## ECB (7 endpoints)
- GET /api/v1/macro/ecb - ECB overview
- GET /api/v1/macro/ecb/economy - Eurozone economy
- GET /api/v1/macro/ecb/fx - ECB exchange rates
- GET /api/v1/macro/ecb/inflation - Eurozone inflation
- GET /api/v1/macro/ecb/rates - ECB interest rates
- GET /api/v1/macro/ecb/series/{series_id} - Single ECB series
- GET /api/v1/macro/ecb/yields - EA bond yields

## EPM (2 endpoints)
- GET /api/v1/epm/example/fresh - Generate fresh DSSE example for testing
- POST /api/v1/epm/verify - Verify DSSE-wrapped EPM manifest

## EU Carbon Intelligence (2 endpoints)
- GET /api/v1/ember/intensity/{country_code} - Grid carbon intensity
- GET /api/v1/eu-ets/price - EU ETS carbon price

## Equities (2 endpoints)
- GET /api/v1/macro/equities - Stock indices
- GET /api/v1/macro/equities/{symbol} - Single index

## Fiscal (3 endpoints)
- GET /api/v1/macro/fiscal - Federal debt overview
- GET /api/v1/macro/fiscal/debt - Federal debt
- GET /api/v1/macro/fiscal/trade - Trade balance

## GeoIP (1 endpoints)
- GET /api/v1/geoip/lookup/{ip} - IP geolocation lookup

## Health (11 endpoints)
- GET /api/health.json - Aggregated system health
- GET /api/v1/climatiq/health - Climatiq integration health
- GET /api/v1/events - System events feed
- GET /api/v1/feeds/health - Feed API health
- GET /api/v1/feeds/health-carbon - Carbon feed health
- GET /api/v1/feeds/health/{symbol} - Feed health by symbol
- GET /api/v1/geoip/health - GeoIP service health
- GET /api/v1/health - API Gateway health
- GET /api/v1/risk/health - Risk service health
- GET /api/v1/rwa/health - RWA API health
- GET /api/v1/vault/health - Vault service health

## Integrity Suite (7 endpoints)
- GET /api/v1/baselines - Get current adaptive baselines
- GET /api/v1/baselines/stats - Get baseline statistics
- GET /api/v1/carbon/consistency - Cross-source consistency check
- GET /api/v1/epm/manifest/{manifest_id} - Supply Chain Carbon Evidence Pack
- GET /api/v1/vc/pubkey/{supplier_id} - Get supplier public key
- GET /api/v1/vc/suppliers - List registered suppliers
- POST /api/v1/vc/verify - Verify JWS signature

## International (3 endpoints)
- GET /api/v1/macro/international/bonds - International bonds
- GET /api/v1/macro/international/fx - FX rates (FRED)
- GET /api/v1/macro/international/spreads - Sovereign spreads

## Knowledge (4 endpoints)
- GET /api/v1/feeds/knowledge/assets - Knowledge base assets
- GET /api/v1/feeds/knowledge/health - Knowledge feed health
- GET /api/v1/feeds/knowledge/stats - Knowledge statistics
- GET /api/v1/feeds/knowledge/status - Knowledge system status

## L2 (4 endpoints)
- GET /api/v2/l2/all - All L2 chain data
- GET /api/v2/l2/cheapest - Get cheapest healthy L2 chain
- GET /api/v2/l2/health - L2 sequencer health status
- GET /api/v2/l2/status/{chain} - Single L2 chain status

## Legacy (2 endpoints)
- GET /api/v1/circuit/health - Circuit health
- GET /api/v1/circuit/status - Circuit breaker

## MOAT (4 endpoints)
- GET /api/v2/quality/status - Data quality metrics
- GET /api/v2/snapshots/latest - Latest data snapshot
- GET /api/v2/snapshots/{snapshot_id} - Get snapshot by ID
- GET /api/v2/verify/{rid} - Verify MOAT report

## Macro (3 endpoints)
- GET /api/v1/macro/proofs - Macro data proofs (attestation)
- GET /api/v1/macro/verification-status - Macro verification status
- GET /api/v1/macro/verified/all - All verified macro data

## Macro Core (9 endpoints)
- GET /api/v1/macro/all - Macro: All core indicators combined
- GET /api/v1/macro/employment - Macro: Unemployment rate, nonfarm payrolls, labor force participation
- GET /api/v1/macro/fed - Macro: Fed Funds Rate, FOMC calendar, rate outlook, last change
- GET /api/v1/macro/gdp - Macro: Real GDP growth QoQ annualized, nominal GDP
- GET /api/v1/macro/health - Macro: Economic Health Index 0-100, status: EXPANSION/STABLE/CAUTION/CONTRACTION
- GET /api/v1/macro/inflation - Macro: CPI YoY, Core CPI, PCE, MoM change, target deviation
- GET /api/v1/macro/risk - Macro: Recession probability, risk assessment
- GET /api/v1/macro/sentiment - Macro: Consumer sentiment, Michigan survey
- GET /api/v1/macro/yields - Macro: Key Treasury yields: 2Y, 10Y, 30Y, 2s10s spread

## RLUSD (9 endpoints)
- GET /api/v3/rlusd/cci - CCI compact
- GET /api/v3/rlusd/evidence/latest - Evidence pack
- GET /api/v3/rlusd/holders - Holder distribution
- GET /api/v3/rlusd/peg/quality - Peg quality
- GET /api/v3/rlusd/risk/cci - CCI detailed
- GET /api/v3/rlusd/status - Service status
- GET /api/v3/rlusd/supply/breakdown - Supply by chain
- GET /api/v3/rlusd/verify/{hash} - Verify hash
- GET /api/v3/rlusd/webhooks/events - Webhook catalog

## RWA (11 endpoints)
- GET /api/v1/rwa/assets - All RWA assets
- GET /api/v1/rwa/assets/{asset_id} - Single RWA asset details
- GET /api/v1/rwa/classify - RWA classification
- GET /api/v1/rwa/grant-info - RWA grant information
- GET /api/v1/rwa/health-carbon - RWA carbon health
- GET /api/v1/rwa/health/{symbol} - RWA health by symbol
- GET /api/v1/rwa/redemption-stress - Redemption stress test results
- GET /api/v1/rwa/redemptions - RWA redemption data
- GET /api/v1/rwa/status - RWA system status
- GET /api/v1/rwa/treasuries - Tokenized treasuries (T-Bills)
- GET /api/v1/rwa/treasury-trust - Treasury trust scores

## RWA Alerts (3 endpoints)
- DELETE /v1/rwa/alerts/{id} - Delete webhook subscription
- GET /v1/rwa/alerts - List webhook subscriptions
- POST /v1/rwa/alerts/subscribe - Create webhook subscription

## RWA Compliance (5 endpoints)
- GET /v1/rwa/compliance - All protocols - compliance overview
- GET /v1/rwa/compliance/check - Cross-border compliance check
- GET /v1/rwa/compliance/jurisdiction/{code} - Filter by jurisdiction
- GET /v1/rwa/compliance/stats - Compliance statistics
- GET /v1/rwa/compliance/{slug} - Single protocol - compliance profile

## RWA Documents (2 endpoints)
- GET /v1/rwa/documents - All protocols - document registry overview
- GET /v1/rwa/documents/{slug} - Single protocol - full document list

## RWA ESG (1 endpoints)
- GET /v1/rwa/esg/{slug} - ESG / carbon score

## RWA Events (3 endpoints)
- GET /v1/rwa/events - All protocols - recent events
- GET /v1/rwa/events/stats - Event statistics
- GET /v1/rwa/events/{slug} - Single protocol - events

## RWA History (2 endpoints)
- GET /v1/rwa/history - All protocols - score history
- GET /v1/rwa/history/{slug} - Single protocol - score timeline

## RWA Legal State (4 endpoints)
- GET /v1/rwa/legal-state - All protocols - legal structure
- GET /v1/rwa/legal-state/search - Search legal states
- GET /v1/rwa/legal-state/stats - Legal state statistics
- GET /v1/rwa/legal-state/{slug} - Single protocol - legal details

## RWA Liquidity (2 endpoints)
- GET /v1/rwa/liquidity - All protocols - liquidity overview
- GET /v1/rwa/liquidity/{slug} - Single protocol - detailed liquidity

## RWA On-Chain (2 endpoints)
- GET /v1/rwa/onchain - All protocols - transparency overview
- GET /v1/rwa/onchain/{slug} - Single protocol - on-chain analysis

## RWA Oracle Feeds (2 endpoints)
- GET /v1/rwa/oracle/feeds/{slug} - Consensus price feed
- GET /v1/rwa/oracle/status - Oracle infrastructure status

## RWA Redemption (2 endpoints)
- GET /v1/rwa/redemption - All protocols - liquidity profiles
- GET /v1/rwa/redemption/{slug} - Single protocol - liquidity profile

## RWA Registry (4 endpoints)
- GET /v1/rwa/registry - All protocol identifiers
- GET /v1/rwa/registry/search - Search by name, symbol, or ISIN
- GET /v1/rwa/registry/stats - Registry statistics
- GET /v1/rwa/registry/{slug} - Single protocol identifiers

## RWA Risk Scoring (5 endpoints)
- GET /v1/rwa/discovery - Newly discovered protocols
- GET /v1/rwa/market - Market overview & aggregate stats
- GET /v1/rwa/risk - All protocol risk scores
- GET /v1/rwa/risk/{slug} - Single protocol - full risk profile + evidence
- GET /v1/rwa/risk/{slug}/pdf - PDF risk report

## Real Estate (3 endpoints)
- GET /api/v1/macro/realestate - Housing overview
- GET /api/v1/macro/realestate/mortgage - Mortgage rates
- GET /api/v1/macro/realestate/prices - Home prices

## Reports (7 endpoints)
- GET /api/v1/reports/audit-export - Audit export
- GET /api/v1/reports/catalog - Available reports catalog
- GET /api/v1/reports/disclosure - Disclosure report
- GET /api/v1/reports/disclosure.json - Disclosure report (JSON)
- GET /api/v2/reports/csrd-esrs - CSRD/ESRS PDF report
- GET /api/v2/reports/dora-operational - DORA Operational PDF report
- GET /api/v2/reports/mica-art66 - MiCA Article 66 PDF report

## Stress (3 endpoints)
- GET /api/v1/macro/expectations - Inflation expectations
- GET /api/v1/macro/stress - Financial stress
- GET /api/v1/macro/volatility - VIX detail

## SupplyChain (6 endpoints)
- GET /api/v1/feeds/supplychain/carbon - Supply chain carbon tracking
- GET /api/v1/feeds/supplychain/health - Supply chain health
- GET /api/v1/feeds/supplychain/product/{product_id} - Product tracking
- GET /api/v1/feeds/supplychain/stats - Supply chain statistics
- GET /api/v1/feeds/supplychain/status - Supply chain status
- GET /api/v1/feeds/supplychain/transfers - Supply chain transfers

## Trading (8 endpoints)
- GET /api/v1/feeds/rsi - RSI indicators
- GET /api/v1/feeds/trading/alpha - Alpha signals
- GET /api/v1/feeds/trading/asset/{symbol} - Single asset trading data
- GET /api/v1/feeds/trading/bias - Market bias indicators
- GET /api/v1/feeds/trading/radar - Trading radar signals
- GET /api/v1/feeds/trading/tokens - Tracked tokens list
- GET /api/v1/feeds/treasury - Treasury data
- GET /api/v1/feeds/trust/combined - Combined trust score

## Unified Integrity (2 endpoints)
- GET /api/v1/integrity/rlusd - RLUSD Integrity Check
- GET /api/v1/integrity/rlusd/baselines - RLUSD Baselines (peg, reserve, CCI)

## XRP (5 endpoints)
- GET /api/v1/feeds/xrp/health - XRP feed health
- GET /api/v1/feeds/xrp/market - XRP market data
- GET /api/v1/feeds/xrp/rlusd - RLUSD stablecoin data
- GET /api/v1/feeds/xrp/rwa - XRP RWA tokenization data
- GET /api/v1/feeds/xrp/whale - XRP whale tracking

## Yields (3 endpoints)
- GET /api/v1/macro/yield-curve - Full Treasury yield curve 1M-30Y
- GET /api/v1/macro/yield-curve/spreads - Yield curve spreads
- GET /api/v1/macro/yield-curve/tips - TIPS real yields

## MCP Server — AI Agent Access (Model Context Protocol)
SSE Endpoint: https://feedoracle.io/mcp/sse
Auto-Discovery: https://feedoracle.io/.well-known/mcp/server.json
Health: https://feedoracle.io/mcp/health
Registry: io.feedoracle/compliance on registry.modelcontextprotocol.io
Claude Desktop: claude mcp add --transport http feedoracle https://feedoracle.io/mcp/

### 10 MCP Tools
- ping() → Server version, uptime, tool count
- compliance_preflight(token_symbol) → PASS/WARN/BLOCK
- mica_status(token_symbol) → MiCA EU authorization
- evidence_profile(protocol) → Evidence grade A–F
- custody_risk(protocol) → DORA Art.28 custody risk
- market_liquidity(protocol) → MiCA Art.45 DEX depth
- evidence_leaderboard(top_n) → 69 protocols ranked
- rlusd_integrity() → RLUSD peg, reserves, CCI
- macro_risk() → 86 FRED series macro risk
- generate_report(report_type) → Signed PDF + XRPL anchor

Responses: HMAC-SHA256 signed, unified schema, audit-grade metadata.

## Chainlink Functions — On-Chain Data (Polygon Mainnet) [LEGACY / DORMANT]
LEGACY: FeedOracle previously published an EconomicHealth snapshot on-chain via Chainlink Functions on Polygon. Subscription 185 is currently dormant; the last confirmed on-chain update was 2026-03-12. The values below reflect that last snapshot and are NOT updated live. Chainlink Functions sunsets in 2026.

### Contract
- FeedOracleConsumer: 0x7Ec0Fd1c43baD079B9dFd01851175645fc82923c (verified on Polygonscan)
- Subscription ID: 185
- Router: 0xdc2AAF042Aeff2E68B3e8E33F19e4B9fA7C73F10
- Polygonscan: https://polygonscan.com/address/0x7Ec0Fd1c43baD079B9dFd01851175645fc82923c

### On-Chain Feeds (read for free via view functions)
- economicHealth() → uint256, 0-100 (US Economic Health Score)
- fedRate() → uint256, value × 100 (e.g., 364 = 3.64%)
- recessionRisk() → uint256, 0-100 (recession probability %)
- isFavorableEconomy() → bool (true if health > 50 and risk < 50)
- getLatestData() → (health, fed, risk, bias, lastUpdated)

### Request Fresh Data [DORMANT — not actively serviced] (historically ~0.2 LINK per request)
- requestEconomicHealth() → triggers Chainlink Functions to fetch from FeedOracle API
- requestFedRate() → fetches current federal funds rate
- requestRecessionRisk() → fetches recession probability

### Solidity Integration
```solidity
IFeedOracleConsumer oracle = IFeedOracleConsumer(0x7Ec0Fd1c43baD079B9dFd01851175645fc82923c);
uint256 health = oracle.economicHealth();
uint256 fed = oracle.fedRate();
if (oracle.isFavorableEconomy()) { /* proceed */ }
```