API Documentation

What FeedOracle Is

FeedOracle is compliance evidence infrastructure for regulated financial institutions. We provide machine-readable, cryptographically signed evidence for DORA, MiCA, and AMLR compliance workflows — from threat intelligence to board-level governance reports.

Core Function

• Aggregates compliance evidence from 17 institutional data sources
• Structures evidence for DORA, MiCA, and AMLR regulatory frameworks
• Provides cryptographic attestation via the DAP protocol
• Documents methodology, sources, and data quality transparently

What FeedOracle Is NOT

Responsibility Allocation

• FeedOracle: Delivers data as documented, maintains stated methodologies, provides signed evidence artifacts
• Data User: Validates suitability, ensures compliance, bears disclosure responsibility

Who Uses FeedOracle

FeedOracle APIs serve organizations requiring verifiable compliance evidence for DORA, MiCA, and AMLR — from operational risk management to regulatory reporting.

Architecture

FeedOracle is a multi-layer compliance evidence infrastructure with 11 MCP servers, 203+ tools, and 17 institutional data sources. Every response is ES256K-signed, SHA-256 hashed, and optionally anchored on Polygon + XRPL.

Layer 6: EVIDENCE OUTPUT    ES256K signatures | SHA-256 content hash | Verified PDF reports | XRPL + Polygon anchoring
Layer 5: COMPLIANCE ENGINE  MiCA (preflight, peg, reserves, Art.23-58) | DORA (8 Oracles, 95 tools, Art.5-44) | AMLR screening
Layer 4: RISK + ANALYSIS    Stablecoin 7-signal scoring | Macro regime classification | Custody + counterparty risk
Layer 3: API + MCP GATEWAY  11 MCP servers (SSE) | 200+ REST endpoints | OAuth 2.0 + API key auth | OpenAPI 3.1
Layer 2: INTELLIGENCE       ResearchOracle | EULawOracle | RegWatchOracle | ESMAOracle | OECDOracle | MacroOracle
Layer 1: DATA SOURCES       FRED (86) | ECB (20) | OECD SDMX | ESMA | NVD | CISA KEV | CERT-Bund | MITRE ATT+CK | DefiLlama | +8 more

MCP Server overview (11 servers, 203+ tools)

DORA operating layer (8 Oracles, 95 tools, all 49 articles)

Full DORA coverage across 6 operational layers. The AmpelOracle provides a closed-loop finding lifecycle: register, assign owner, re-test, close, with SHA-256 audit chain and escalation engine.

Blockchain oracles (13 chains)

Each chain oracle provides on-chain intelligence via dedicated MCP server at feedoracle.io/chain-oracles/.

Authentication

Include your API key in the request header:

X-API-Key: YOUR_API_KEY

Auth Semantics

• Public (ignore X-API-Key): /api/v2/verify/*, /api/v2/snapshots/*, /api/v2/quality/status, /api/v2/l2/*
• Tier-gated (require key): /api/v2/webhooks*, /api/v2/exports*
• Enterprise-only: /api/v2/enterprise/pack

Note: Public endpoints ignore X-API-Key if provided. Do not send keys to public endpoints unless required by internal policy.

Clarification: Verification (reading existing attestations) is public. EPM generation (creating new Evidence Pack Manifests) is tier-limited — see Pricing.

Get your API key at /pricing.

Base URL

https://feedoracle.io

MCP Servers 11 SERVERS · 203+ TOOLS

FeedOracle provides three Model Context Protocol (MCP) servers that give AI agents direct access to regulatory compliance, stablecoin operational risk, and macroeconomic intelligence. Any MCP-compatible client — Claude Desktop, Cursor, Windsurf, or custom agents — can connect instantly.

Compliance Server (33 tools) — FeedOracle Core

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "feedoracle-compliance": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedoracle.io/mcp/sse"]
    },
    "feedoracle-macro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedoracle.io/mcp/macro/sse"]
    },
    "feedoracle-risk": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://feedoracle.io/mcp/risk/sse"]
    }
  }
}

Terminal (one-liner)

# Compliance Server (MiCA, DORA, evidence)
npx -y mcp-remote https://feedoracle.io/mcp/sse

# Macro Intelligence Server (FRED, yields, regime)
npx -y mcp-remote https://feedoracle.io/mcp/macro/sse

# Stablecoin Risk Server (7-signal scoring, 105+ tokens)
npx -y mcp-remote https://feedoracle.io/mcp/risk/sse

Compliance Tools (18)

Verdicts

Response Schema

Every tool returns a unified envelope with cryptographic signing:

{
  "schema_version": "2.1.0",
  "tool": "compliance_preflight",
  "request_id": "fo-d2e33f04f33f",
  "timestamp": "2026-02-20T11:57:51Z",
  "decision": "PASS",
  "reason_codes": ["ALL_CHECKS_PASSED"],
  "confidence": 1.0,
  "evidence": { ... },
  "sources": [{"registry": "...", "fetched_at": "..."}],
  "meta": {"ttl_seconds": 300, "data_freshness": "live", "jurisdiction_scope": "EU"},
  "signature": {"alg": "ES256K", "kid": "feedoracle-mcp-es256k-1", "sig": "MEU...", "content_hash": "sha256:...", "independently_verifiable": true}
}

Unit-based pricing

All 206 MCP tools across 11 servers are available on every plan. Billing is unit-based: each tool call costs 1, 3, or 10 units depending on complexity. Free tools (ping, health_check) cost 0 units.

Unit costs: Light tools = 1 unit (peg check, macro risk, MiCA status) | Medium = 3 units (compliance preflight, AI queries) | Heavy = 10 units (PDF reports, evidence bundles, full MiCA packs). See pricing page for full details.

API availability by tier

All tools and endpoints are available on every plan. The difference is monthly unit volume and access to advanced features like PDF reports and webhooks.

Unit cost examples

Annual plans available with 2x bonus units (≈17% savings). Full pricing details →

Verified Reports API

Evidence Report Generation 6 TYPES · 5 ENDPOINTS

Signed PDF evidence. SHA-256 + ECDSA + XRPL. Now including AMLR digital asset screening (EU 2024/1624). Evidence Terminal

AMLR Screening API NEW

Carbon Data

{
  "count": 54,
  "timestamp": 1739836800,
  "chains": [{
    "symbol": "ETH",
    "chain": "Ethereum",
    "consensus": "Proof of Stake",
    "energy_twh_year": 0.0026,
    "co2_mt_year": 0.0013,
    "renewable_energy_percent": 52,
    "green_score": 85,
    "data_quality": "THIRD_PARTY_VERIFIED",
    "data_source": "CCRI"
  }]
}

Disclosure API v3 DAP

DAP - Disclosure Attestation Protocol NEW

Cryptographic proof of what data was delivered, when it was delivered, and that it has not been altered. Every API response is hashed, aggregated into Merkle trees, and anchored on-chain.

Blockchain Anchoring

Report hashes anchored as XRPL memo fields. Verify via xrpscan.com.

MOAT v2 Evidence NEW

Verify, Snapshots, Quality. Full docs →

Webhooks PRO+

Real-time events. Full docs →

S3 Exports PRO+

Export to your S3. Full docs →

L2 Intelligence NEW

Fee Oracle + Health. Full docs →

Enterprise Features ENTERPRISE

PDF Disclosure Reports (Professional+)

curl -H "X-API-Key: KEY" "https://api.feedoracle.io/api/v2/reports/mica-art66" -o report.pdf

Data Sources & Provenance

FeedOracle aggregates data from 17 institutional-grade sources. Every data point is traceable to its origin. No synthetic data, no interpolation, no AI-generated estimates.

Data Disclaimer

FeedOracle provides data for informational purposes to support regulatory disclosure obligations. This data does not constitute legal, financial, tax, or compliance advice.

Data Quality Levels

• Third-Party Sourced: Data obtained from established external providers (Cambridge CBECI, CCRI, DNV) who maintain independent data collection methodologies. "Verified" refers to source integrity, not audit or certification. Source attribution provided.
• Calculated: Data computed by FeedOracle using documented methodologies. Methodology available upon request.

User Responsibility

Data users are solely responsible for:

1. Validating data suitability for their specific use case
2. Ensuring compliance with applicable regulations
3. Accuracy of disclosures to competent authorities
4. Independent verification where required by their regulatory framework

Standard API Response Footer

{
  "legal": {
    "disclaimer": "Data provided for informational purposes only.",
    "responsibility": "User remains solely responsible for regulatory compliance.",
    "data_quality": "THIRD_PARTY_SOURCED | CALCULATED",
    "source": "Source attribution",
    "timestamp": "ISO 8601 timestamp",
    "terms": "https://feedoracle.io/terms.html"
  }
}

Language Guidelines

FeedOracle maintains strict language standards for legal and regulatory safety.

Forbidden Phrases

Allowed Alternatives

Use Cases

For detailed integration examples, see the Use Cases documentation.