{ "openapi": "3.1.0", "info": { "title": "FeedOracle Compliance Evidence API", "version": "8.4.1", "description": "FeedOracle Compliance Evidence Infrastructure \u2014 44 MCP servers, 590+ evidence tools across 17 data sources. DORA, MiCA, AMLR and CSRD compliance evidence APIs. ES256K-signed responses, blockchain-anchored. Canonical metrics: https://feedoracle.io/data/feedoracle-metrics.json.", "contact": { "email": "support@feedoracle.io", "url": "https://feedoracle.io/contact.html" }, "license": { "name": "Proprietary" }, "termsOfService": "https://feedoracle.io/terms.html" }, "servers": [ { "url": "https://api.feedoracle.io", "description": "Production" } ], "security": [], "tags": [ { "name": "Verified Reports", "description": "Generate, download, and verify cryptographically signed PDF evidence reports. Each report is hashed (SHA-256), signed (ECDSA secp256k1), and anchored on XRPL blockchain." }, { "name": "Health", "description": "System health endpoints (Public)" }, { "name": "Disclosure", "description": "v3 Sustainability disclosure (Public)" }, { "name": "L2", "description": "Layer 2 fee oracle (Public)" }, { "name": "Attestation", "description": "DAP attestation (Public)" }, { "name": "MOAT" }, { "name": "RLUSD", "description": "RLUSD stablecoin transparency (Public)" }, { "name": "Legacy", "description": "Merkle Oracle verification (Public)" }, { "name": "Carbon", "description": "Carbon data (Key required)" }, { "name": "Macro", "description": "Macro economic (Key required)" }, { "name": "Trading", "description": "Trading signals (Key required)" }, { "name": "XRP", "description": "XRP/RLUSD feeds (Key required)" }, { "name": "RWA", "description": "Real World Assets (Key required)" }, { "name": "Agents", "description": "AI Agent feeds (Key required)" }, { "name": "Knowledge", "description": "Knowledge base (Key required)" }, { "name": "SupplyChain", "description": "Supply chain tracking (Key required)" }, { "name": "Reports", "description": "PDF reports (Pro+ tier)" }, { "name": "GeoIP", "description": "Geo location (Key required)" }, { "name": "Payment", "description": "Billing (Internal)" }, { "name": "Integrity Suite", "description": "Cross-source validation, baselines, and verifiable credentials" }, { "name": "RWA Risk Scoring", "description": "Multi-vector risk scores with letter grades (A-F) for 60+ tokenized asset protocols" }, { "name": "RWA Registry", "description": "Token metadata, issuer details, underlying asset classification (LEI, ISIN)" }, { "name": "RWA Compliance", "description": "Jurisdiction access, sanctions screening, MiCA/DORA/GENIUS status" }, { "name": "RWA Legal State", "description": "Contract powers, transfer finality, dispute resolution" }, { "name": "RWA Oracle Feeds", "description": "Multi-source consensus price feeds with disagreement detection" }, { "name": "RWA Liquidity", "description": "On-chain DEX liquidity depth and volume analysis" }, { "name": "RWA On-Chain", "description": "Smart contract transparency and activity verification" }, { "name": "RWA ESG", "description": "Chain-weighted carbon footprint scoring" }, { "name": "RWA Events", "description": "Risk events, governance changes, anomaly alerts" }, { "name": "RWA History", "description": "Historical score tracking and trend analysis" }, { "name": "RWA Alerts", "description": "Webhook subscriptions for real-time notifications" }, { "name": "RWA Redemption", "description": "Time-to-Cash / institutional liquidity profiles (settlement, gates, fees)" }, { "name": "RWA Documents", "description": "Compliance document registry with source URLs and integrity hashes" }, { "name": "MiCA Compliance", "description": "MiCA regulatory compliance evidence (Art. 22-58) for stablecoins and token issuers" }, { "name": "Stablecoin", "description": "Stablecoin analytics covering 105+ coins \u2014 peg health, reserves, MiCA classification" }, { "name": "Macro Oracle", "description": "US macro-economic data from FRED \u2014 health index, inflation, GDP, fed rates, yield curve" }, { "name": "RWA Risk", "description": "RWA protocol risk intelligence across 9 dimensions for 60+ protocols" }, { "name": "Evidence", "description": "Cryptographically signed evidence infrastructure" }, { "name": "DORA", "description": "DORA ICT risk and resilience compliance data" }, { "name": "CSRD", "description": "CSRD/ESG sustainability reporting data" }, { "name": "ESMA", "description": "ESMA CASP register and regulatory status data" }, { "name": "AI Gateway" }, { "name": "Enterprise Trust Layer" }, { "name": "Agent Trust Management" }, { "name": "MCP Auth" }, { "name": "MCP Transport" }, { "name": "USDC Payment" }, { "name": "Billing" }, { "name": "Signature Verification" }, { "name": "Discovery" }, { "name": "Verification" }, { "name": "KYA - Know Your Agent" }, { "name": "Audit Trail" }, { "name": "Market Risk" }, { "name": "Trust" }, { "name": "Wallet", "description": "Unit-based billing \u2014 check balance, view packages, purchase units via Stripe" }, { "name": "AgentGuard", "description": "Runtime agent security & governance. 20 tools across 4 layers: pre-execution, payload security, governance, post-execution. Agent state machine with automatic escalation." }, { "name": "DORA Ampel", "description": "DORA traffic-light compliance system \u2014 49 tools, 26 articles, 39 checks, 67 controls, 6 entities. Closed-loop: Control\u2192Finding\u2192Owner\u2192ReTest\u2192Close. Escalation, What-if, Board-View, Dependency Graph, Evidence Packs." }, { "name": "MiCA Ampel", "description": "MiCA stablecoin compliance monitoring \u2014 24 tools, 17 tokens, 13 issuers" }, { "name": "AML Oracle", "description": "Anti-money laundering and sanctions screening \u2014 12 tools, 87k+ watchlist entries" }, { "name": "ResearchOracle", "description": "Scientific research intelligence \u2014 200M+ papers, compliance topics" }, { "name": "EULawOracle", "description": "EU financial regulation intelligence \u2014 12 regulations, article lookup, cross-references, deadlines" }, { "name": "RegWatchOracle", "description": "Regulatory watch \u2014 US Federal Register + EU regulatory feeds" }, { "name": "ESMAOracle", "description": "Official ESMA MiCA register \u2014 CASPs, non-compliant entities, white papers" }, { "name": "MacroOracle", "description": "Macro economic intelligence \u2014 ECB + FRED + BLS + World Bank" }, { "name": "LawOracle", "description": "Multi-jurisdiction legal intelligence MCP server. 20 tools, 9 data sources, 4 jurisdictions (US, EU, UK, DE). Obligation mapping, article extraction, DORA OS bridge. Endpoint: https://tooloracle.io/law/mcp" }, { "name": "TestOracle", "description": "DORA Art. 24-27 resilience testing MCP server. 16 tools, 12 scenarios, TLPT tracking, AmpelOracle sync." }, { "name": "ReportingOracle", "description": "DORA NCA reporting MCP server. 14 tools, incident reports, RoI export, TLPT results, annual reports." }, { "name": "CloudOracle", "description": "DORA cloud monitoring: live AWS/GCP/Azure status, concentration risk, CTPP check." }, { "name": "TrainingOracle", "description": "DORA ICT security awareness and training. 13 tools, 7 programmes, phishing simulation." }, { "name": "PolicyOracle", "description": "DORA ICT policy lifecycle. 12 tools, 12 RTS-required policies, gap check, version control." }, { "name": "DORA OS Conductor", "description": "Multi-agent orchestrator. 16 tools coordinating all 16 DORA OS oracles. Workflows, event reactions, board briefings, remediation planning." }, { "name": "DriftOracle", "description": "Self-healing compliance drift detection. Regulatory changes, evidence staleness, cloud drift, auto-remediation." }, { "name": "EventFabric", "description": "Real-time event processing. Webhook receiver, 12 routing rules, auto-dispatch to Conductor." }, { "name": "PredictOracle", "description": "Predictive risk engine. Score trajectories, evidence decay, early warnings, what-if scenarios." }, { "name": "ZKEvidenceOracle", "description": "Zero-knowledge evidence layer. Privacy-preserving proofs, merkle trees, verifiable credentials, selective disclosure." } ], "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key", "description": "Required for v1 data endpoints. Get at /pricing.html" }, "BearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT", "description": "OAuth 2.0 Bearer token from POST /mcp/token" }, "bearerAuth": { "type": "http", "scheme": "bearer", "description": "FeedOracle OAuth 2.1 Bearer token. Obtain via /mcp/register (Dynamic Client Registration, RFC 7591)." } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" }, "message": { "type": "string" } } }, "MetaEnvelope": { "type": "object", "properties": { "api_version": { "type": "string" }, "dataset_version": { "type": "string" }, "schema_version": { "type": "string" } } }, "RlusdStatusEnvelope": { "type": "object", "properties": { "service": { "type": "string" }, "meta": { "$ref": "#/components/schemas/MetaEnvelope" }, "data": { "type": "object" }, "warnings": { "type": "array", "items": { "type": "string" } } } }, "RlusdCciCompact": { "type": "object", "properties": { "cci_score": { "type": "number" }, "grade": { "type": "string" }, "components": { "type": "object" }, "penalty_log": { "type": "object" }, "timestamp": { "type": "string" } } }, "RlusdCciDetailed": { "type": "object", "properties": { "cci_score": { "type": "number" }, "grade": { "type": "string" }, "subscores": { "type": "object" }, "weights": { "type": "object" }, "timestamp": { "type": "string" } } }, "RlusdEvidencePack": { "type": "object", "properties": { "as_of": { "type": "string" }, "guard": { "type": "object" }, "circuit_breaker": { "type": "object" }, "integrity_proof": { "type": "object" }, "disclaimer": { "type": "object" } } }, "RlusdHoldersResponse": { "type": "object", "properties": { "chains": { "type": "object" }, "total_holders": { "type": "integer" }, "timestamp": { "type": "string" } } }, "LegacyCircuitStatus": { "type": "object", "properties": { "status": { "type": "string" }, "action": { "type": "string" }, "checks": { "type": "object" }, "timestamp": { "type": "string" } } }, "LegacyHealth": { "type": "object", "properties": { "status": { "type": "string" }, "service": { "type": "string" } } }, "LegacyZkStatus": { "type": "object", "properties": { "circuit": { "type": "string" }, "runtime_version": { "type": "string" }, "status": { "type": "string" } } }, "LegacyZkAttestationLatest": { "type": "object", "properties": { "tx_hash": { "type": "string" }, "contract": { "type": "string" }, "chain_id": { "type": "integer" }, "min_ratio_bps": { "type": "integer" }, "threshold_passed": { "type": "boolean" } } }, "RlusdSupplyBreakdown": { "type": "object", "properties": { "service": { "type": "string" }, "data": { "type": "object" } } }, "RlusdPegQuality": { "type": "object", "properties": { "service": { "type": "string" }, "data": { "type": "object" } } }, "RlusdWebhookCatalog": { "type": "object", "properties": { "events": { "type": "array" }, "catalog": { "type": "object" } } }, "RlusdVerifyResponse": { "type": "object", "properties": { "valid": { "type": "boolean" } } }, "RWAEvidence": { "type": "object", "description": "ECDSA ES256K cryptographic evidence envelope", "properties": { "manifest_id": { "type": "string", "example": "RWA-94607EEB" }, "payload_hash": { "type": "object", "properties": { "alg": { "type": "string", "example": "SHA-256" }, "hex": { "type": "string" } } }, "signature": { "type": "object", "properties": { "alg": { "type": "string", "example": "ES256K" }, "hex": { "type": "string" }, "kid": { "type": "string", "example": "feedoracle-prod-2026" } } }, "verification": { "type": "object", "properties": { "jwks_url": { "type": "string", "format": "uri", "example": "https://api.feedoracle.io/.well-known/jwks.json" } } } } }, "RWARiskVectors": { "type": "object", "description": "9-dimensional risk breakdown (0-100 each)", "properties": { "tvl_weight": { "type": "integer" }, "yield_spread": { "type": "integer" }, "diversification": { "type": "integer" }, "maturity": { "type": "integer" }, "regulatory": { "type": "integer" }, "institutional": { "type": "integer" }, "dex_liquidity": { "type": "integer" }, "onchain_transparency": { "type": "integer" }, "esg_carbon": { "type": "integer" } } }, "RWAReasonCode": { "type": "object", "properties": { "vector": { "type": "string", "example": "tvl_weight" }, "impact": { "type": "string", "enum": [ "positive", "negative" ] }, "text": { "type": "string", "example": "Strong TVL indicates institutional confidence" } } }, "RWAStablecoinDetail": { "type": "object", "description": "Enhanced fields for regulated_stablecoin assets", "properties": { "issuer": { "type": "string", "example": "Ripple" }, "custodian": { "type": "string" }, "auditor": { "type": "string", "example": "BPM LLP (CPA-attested)" }, "peg": { "type": "object", "properties": { "target": { "type": "number", "example": 1.0 }, "current": { "type": "number" }, "deviation": { "type": "number" } } }, "reserves": { "type": "object", "properties": { "ratio": { "type": "number", "example": 1.042 }, "value_usd": { "type": "number" }, "outstanding": { "type": "number" }, "report_month": { "type": "string" } } }, "compliance": { "type": "object", "properties": { "mica": { "type": "string" }, "genius": { "type": "string" } } }, "anchoring": { "type": "object", "properties": { "total": { "type": "integer", "example": 1888 }, "polygon": { "type": "integer" }, "xrpl": { "type": "integer" } } }, "supply": { "type": "object", "properties": { "total": { "type": "number" }, "chains": { "type": "object" }, "change_24h": { "type": "number" } } } } }, "RWAXrplDetail": { "type": "object", "description": "Enhanced fields for XRPL native assets", "properties": { "network": { "type": "object", "properties": { "ledger_index": { "type": "integer" }, "server_state": { "type": "string" }, "peers": { "type": "integer" } } }, "xrp_market": { "type": "object", "properties": { "price_usd": { "type": "number" }, "change_24h": { "type": "number" }, "volume_24h": { "type": "number" } } }, "whale_flows": { "type": "object", "properties": { "sentiment": { "type": "string", "enum": [ "bullish", "bearish", "neutral" ] }, "net_flow_24h_xrp": { "type": "number" } } }, "rwa_ecosystem": { "type": "object", "properties": { "custody_aum": { "type": "number" }, "rlusd_supply": { "type": "number" }, "tokenized_assets": { "type": "number" } } } } }, "RWAProtocolRisk": { "type": "object", "properties": { "slug": { "type": "string", "example": "rlusd" }, "protocol": { "type": "string", "example": "Ripple RLUSD" }, "type": { "type": "string", "enum": [ "regulated_stablecoin", "treasury", "commodity", "credit", "synthetic", "real_estate", "equities", "insurance", "xrpl_infrastructure", "xrpl_custody", "xrpl_tokenization" ] }, "risk_score": { "type": "integer", "minimum": 0, "maximum": 100, "example": 89 }, "risk_grade": { "type": "string", "enum": [ "A", "B", "C", "D", "F" ] }, "tvl_usd": { "type": "number" }, "risk_vectors": { "$ref": "#/components/schemas/RWARiskVectors" }, "reason_codes": { "type": "object", "properties": { "codes": { "type": "array", "items": { "$ref": "#/components/schemas/RWAReasonCode" } }, "summary": { "type": "string" } } }, "chains": { "type": "object" }, "stablecoin_detail": { "$ref": "#/components/schemas/RWAStablecoinDetail" }, "xrpl_detail": { "$ref": "#/components/schemas/RWAXrplDetail" } } }, "RWAWebhookEvent": { "type": "object", "description": "Payload sent to webhook endpoint", "properties": { "event": { "type": "string", "enum": [ "grade_change", "score_threshold", "anomaly_detected", "peg_deviation", "tvl_drop" ] }, "timestamp": { "type": "string", "format": "date-time" }, "protocol": { "type": "object", "properties": { "slug": { "type": "string" }, "name": { "type": "string" } } }, "previous": { "type": "object", "properties": { "score": { "type": "integer" }, "grade": { "type": "string" } } }, "current": { "type": "object", "properties": { "score": { "type": "integer" }, "grade": { "type": "string" } } }, "reason_codes": { "type": "array", "items": { "$ref": "#/components/schemas/RWAReasonCode" } }, "evidence": { "type": "object", "properties": { "signature": { "type": "string" }, "manifest_id": { "type": "string" } } } } }, "RWARedemptionProfile": { "type": "object", "description": "Institutional liquidity profile - how fast can you exit to cash?", "properties": { "primary_exit": { "type": "string", "enum": [ "ISSUER_DIRECT", "DEX_ONLY", "HYBRID", "OTC", "NONE" ], "description": "Primary redemption channel" }, "settlement_time": { "type": "string", "enum": [ "T+0", "T+1", "T+2_BUSINESS_DAYS", "T+3_BUSINESS_DAYS", "VARIABLE", "LOCK_PERIOD" ], "example": "T+0" }, "settlement_days_max": { "type": "integer", "description": "Maximum calendar days to settlement" }, "redemption_frequency": { "type": "string", "enum": [ "ON_DEMAND", "DAILY", "WEEKLY", "MONTHLY", "AT_MATURITY" ] }, "notice_period_days": { "type": "integer" }, "minimum_redemption_usd": { "type": "number", "nullable": true, "example": 100000 }, "maximum_daily_redemption_usd": { "type": "number", "nullable": true }, "fees": { "type": "object", "nullable": true, "properties": { "type": { "type": "string", "example": "bps" }, "value": { "type": "number", "example": 0 } } }, "gates": { "type": "object", "properties": { "withdrawal_gate": { "type": "boolean", "description": "Can issuer halt redemptions?" }, "suspension_rights": { "type": "boolean" }, "conditions": { "type": "string", "nullable": true, "description": "Under what conditions gates activate" } } }, "kyc_required": { "type": "boolean" }, "redemption_currency": { "type": "string", "example": "USD" }, "nav_frequency": { "type": "string", "enum": [ "REAL_TIME", "DAILY", "WEEKLY", "MONTHLY" ] }, "liquidity_latency_score": { "type": "integer", "minimum": 0, "maximum": 100, "description": "Composite score (0-100): higher = faster exit to cash" }, "confidence": { "type": "number", "minimum": 0, "maximum": 1, "description": "Data confidence level" }, "source": { "type": "string" }, "last_verified": { "type": "string", "format": "date" } } }, "RWADocument": { "type": "object", "description": "Compliance/audit document reference with integrity hash", "properties": { "category": { "type": "string", "enum": [ "attestation", "audit", "prospectus", "legal", "whitepaper", "factsheet", "regulatory" ] }, "title": { "type": "string", "example": "Monthly Attestation Report" }, "url": { "type": "string", "format": "uri", "description": "Source URL (issuer/regulator/auditor hosted)" }, "issuer": { "type": "string", "description": "Document publisher" }, "date": { "type": "string", "format": "date" }, "hash_sha256": { "type": "string", "nullable": true, "description": "SHA-256 for integrity verification" }, "format": { "type": "string", "enum": [ "pdf", "html", "json" ] }, "regulatory_relevance": { "type": "string", "nullable": true, "enum": [ "MiCA", "DORA", "SEC", "NYDFS", null ] } } } } }, "paths": { "/api/health.json": { "get": { "tags": [ "Health" ], "operationId": "getHealthJson", "summary": "Aggregated system health", "description": "Returns all component status. Cache-Control max-age=10.", "responses": { "200": { "description": "Health status with components array" } } } }, "/api/v1/health": { "get": { "tags": [ "Health" ], "operationId": "getV1Health", "summary": "API Gateway health", "description": "Returns gateway status and available endpoints", "responses": { "200": { "description": "Gateway operational status" } } } }, "/api/v1/feeds/health": { "get": { "tags": [ "Health" ], "operationId": "getFeedsHealth", "summary": "Feed API health", "responses": { "200": { "description": "Feed service status" } } } }, "/api/v1/feeds/health-carbon": { "get": { "tags": [ "Health" ], "operationId": "getCarbonHealth", "summary": "Carbon feed health", "responses": { "200": { "description": "Carbon service status" } } } }, "/api/v1/macro/health": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroHealth", "summary": "Macro: Economic Health Index 0-100, status: EXPANSION/STABLE/CAUTION/CONTRACTION", "description": "Economic Health Index 0-100, status: EXPANSION/STABLE/CAUTION/CONTRACTION", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/rwa/health": { "get": { "tags": [ "Health" ], "operationId": "getRwaHealth", "summary": "RWA API health", "responses": { "200": { "description": "RWA service status" } } } }, "/api/v1/climatiq/health": { "get": { "tags": [ "Health" ], "operationId": "getClimatiqHealth", "summary": "Climatiq integration health", "responses": { "200": { "description": "Climatiq connector status" } } } }, "/api/v1/geoip/health": { "get": { "tags": [ "Health" ], "operationId": "getGeoipHealth", "summary": "GeoIP service health", "responses": { "200": { "description": "GeoIP service status" } } } }, "/api/v1/vault/health": { "get": { "tags": [ "Health" ], "operationId": "getVaultHealth", "summary": "Vault service health", "responses": { "200": { "description": "Vault status" } } } }, "/api/v1/risk/health": { "get": { "tags": [ "Health" ], "operationId": "getRiskHealth", "summary": "Risk service health", "responses": { "200": { "description": "Risk service status" } } } }, "/api/v3/disclosure/networks": { "get": { "tags": [ "Disclosure" ], "operationId": "getDisclosureNetworks", "summary": "All networks with sustainability disclosure", "description": "Networks with attestation for MiCA/CSRD", "responses": { "200": { "description": "Disclosure data with disclosure_support, attestation, legal, temporal keys" }, "429": { "description": "Rate limited" } } } }, "/api/v3/disclosure/sustainability/{symbol}": { "get": { "tags": [ "Disclosure" ], "operationId": "getDisclosureSustainability", "summary": "Single network sustainability report", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full sustainability report" }, "404": { "description": "Network not found" } } } }, "/api/v2/l2/cheapest": { "get": { "tags": [ "L2" ], "operationId": "getL2Cheapest", "summary": "Get cheapest healthy L2 chain", "description": "Returns recommended L2 with full ranking by gas cost", "responses": { "200": { "description": "L2 ranking with gas prices in USD" } } } }, "/api/v2/l2/health": { "get": { "tags": [ "L2" ], "operationId": "getL2Health", "summary": "L2 sequencer health status", "description": "Health for 8 L2 chains (ARB, OP, BASE, etc.)", "responses": { "200": { "description": "Health status array" } } } }, "/api/v2/l2/all": { "get": { "tags": [ "L2" ], "operationId": "getL2All", "summary": "All L2 chain data", "responses": { "200": { "description": "Complete L2 data for all chains" } } } }, "/api/v2/l2/status/{chain}": { "get": { "tags": [ "L2" ], "operationId": "getL2Status", "summary": "Single L2 chain status", "parameters": [ { "name": "chain", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Chain details" }, "404": { "description": "Chain not found" } } } }, "/api/v2/attestation/status": { "get": { "tags": [ "Attestation" ], "operationId": "getAttestationStatus", "summary": "DAP system status", "description": "Returns merkle root and multi-chain anchor status", "responses": { "200": { "description": "DAP operational status" } } } }, "/api/v2/attestation/chains": { "get": { "tags": [ "Attestation" ], "operationId": "getAttestationChains", "summary": "Multi-chain anchor status", "description": "Anchor status on ETH, Polygon, Arbitrum, Base", "responses": { "200": { "description": "Chain anchors with tx hashes" } } } }, "/api/v2/attestation/activity": { "get": { "tags": [ "Attestation" ], "operationId": "getAttestationActivity", "summary": "Recent anchor activity", "responses": { "200": { "description": "Activity log with timestamps" } } } }, "/api/v2/attestation/verify/{aid}": { "get": { "tags": [ "Attestation" ], "operationId": "verifyAttestation", "summary": "Verify attestation by ID", "parameters": [ { "name": "aid", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Attestation ID (dap_*)" } ], "responses": { "200": { "description": "Verification result with merkle proof" }, "404": { "description": "Attestation not found" } } } }, "/api/v2/verify/{rid}": { "get": { "tags": [ "MOAT" ], "operationId": "verifyReport", "summary": "Verify MOAT report", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Report ID (MOAT format)" } ], "responses": { "200": { "description": "Report verified with proof" }, "404": { "description": "Report not found" } } } }, "/api/v2/quality/status": { "get": { "tags": [ "MOAT" ], "operationId": "getQualityStatus", "summary": "Data quality metrics", "parameters": [ { "name": "name", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Quality scores" } } } }, "/api/v2/snapshots/latest": { "get": { "tags": [ "MOAT" ], "operationId": "getSnapshotLatest", "summary": "Latest data snapshot", "parameters": [ { "name": "name", "in": "query", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Latest snapshot with hash" } } } }, "/api/v2/snapshots/{snapshot_id}": { "get": { "tags": [ "MOAT" ], "operationId": "getSnapshot", "summary": "Get snapshot by ID", "parameters": [ { "name": "snapshot_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Snapshot data" }, "404": { "description": "Snapshot not found" } } } }, "/api/v1/feeds/carbon/chains": { "get": { "tags": [ "Carbon" ], "operationId": "getCarbonChains", "summary": "Carbon data for all 49 blockchain networks", "description": "Includes CO2, energy, consensus type, carbon score", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Carbon array with 49 chains" }, "401": { "description": "Missing or invalid X-API-Key" } } } }, "/api/v1/feeds/carbon/summary": { "get": { "tags": [ "Carbon" ], "operationId": "getCarbonSummary", "summary": "Carbon summary statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Aggregated carbon stats" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/carbon/chains": { "get": { "tags": [ "Carbon" ], "operationId": "getCarbonChainsAlt", "summary": "Carbon data for 50+ blockchains (public)", "security": [], "responses": { "200": { "description": "Carbon data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/carbon/summary": { "get": { "tags": [ "Carbon" ], "operationId": "getCarbonSummaryAlt", "summary": "Carbon summary (alternate path)", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Summary stats" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/carbon/mica/{symbol}": { "get": { "tags": [ "Carbon" ], "operationId": "getCarbonMica", "summary": "MiCA-formatted carbon data", "description": "Article 66 compliant format", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "MiCA format data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/macro/all": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroAll", "summary": "Macro: All core indicators combined", "description": "All core indicators combined", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/fed": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroFed", "summary": "Macro: Fed Funds Rate, FOMC calendar, rate outlook, last change", "description": "Fed Funds Rate, FOMC calendar, rate outlook, last change", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/inflation": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroInflation", "summary": "Macro: CPI YoY, Core CPI, PCE, MoM change, target deviation", "description": "CPI YoY, Core CPI, PCE, MoM change, target deviation", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/yields": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroYields", "summary": "Macro: Key Treasury yields: 2Y, 10Y, 30Y, 2s10s spread", "description": "Key Treasury yields: 2Y, 10Y, 30Y, 2s10s spread", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/gdp": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroGDP", "summary": "Macro: Real GDP growth QoQ annualized, nominal GDP", "description": "Real GDP growth QoQ annualized, nominal GDP", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/employment": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroEmployment", "summary": "Macro: Unemployment rate, nonfarm payrolls, labor force participation", "description": "Unemployment rate, nonfarm payrolls, labor force participation", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/risk": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroRisk", "summary": "Macro: Recession probability, risk assessment", "description": "Recession probability, risk assessment", "responses": { "200": { "description": "JSON with oracle_ready flag" }, "402": { "description": "Payment Required \u2014 API key missing or insufficient units. Returns pricing and registration instructions.", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "integer", "example": 402 }, "error": { "type": "string", "example": "payment_required" }, "protocol": { "type": "string", "example": "feedoracle-402" }, "message": { "type": "string" }, "packages": { "type": "object" }, "free_tools": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "/api/v1/macro/sentiment": { "get": { "tags": [ "Macro Core" ], "operationId": "getMacroSentiment", "summary": "Macro: Consumer sentiment, Michigan survey", "description": "Consumer sentiment, Michigan survey", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/proofs": { "get": { "tags": [ "Macro" ], "operationId": "getMacroProofs", "summary": "Macro data proofs (attestation)", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Verification proofs" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/macro/verified/all": { "get": { "tags": [ "Macro" ], "operationId": "getMacroVerifiedAll", "summary": "All verified macro data", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Verified dataset" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/macro/verification-status": { "get": { "tags": [ "Macro" ], "operationId": "getMacroVerificationStatus", "summary": "Macro verification status", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Verification status" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trading/radar": { "get": { "tags": [ "Trading" ], "operationId": "getTradingRadar", "summary": "Trading radar signals", "description": "Real-time trading opportunities", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Radar signals" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trading/alpha": { "get": { "tags": [ "Trading" ], "operationId": "getTradingAlpha", "summary": "Alpha signals", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Alpha opportunities" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trading/bias": { "get": { "tags": [ "Trading" ], "operationId": "getTradingBias", "summary": "Market bias indicators", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Bias data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trading/tokens": { "get": { "tags": [ "Trading" ], "operationId": "getTradingTokens", "summary": "Tracked tokens list", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Token list" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trading/asset/{symbol}": { "get": { "tags": [ "Trading" ], "operationId": "getTradingAsset", "summary": "Single asset trading data", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Asset data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/rsi": { "get": { "tags": [ "Trading" ], "operationId": "getRsi", "summary": "RSI indicators", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "RSI data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/treasury": { "get": { "tags": [ "Trading" ], "operationId": "getTreasury", "summary": "Treasury data", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Treasury metrics" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/trust/combined": { "get": { "tags": [ "Trading" ], "operationId": "getTrustCombined", "summary": "Combined trust score", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Trust scores" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/xrp/rlusd": { "get": { "tags": [ "XRP" ], "operationId": "getXrpRlusd", "summary": "RLUSD stablecoin data", "description": "Ripple USD stablecoin metrics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "RLUSD data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/xrp/market": { "get": { "tags": [ "XRP" ], "operationId": "getXrpMarket", "summary": "XRP market data", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Market data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/xrp/rwa": { "get": { "tags": [ "XRP" ], "operationId": "getXrpRwa", "summary": "XRP RWA tokenization data", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "RWA on XRPL" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/xrp/whale": { "get": { "tags": [ "XRP" ], "operationId": "getXrpWhale", "summary": "XRP whale tracking", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Whale movements" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/xrp/health": { "get": { "tags": [ "XRP" ], "operationId": "getXrpHealth", "summary": "XRP feed health", "responses": { "200": { "description": "XRP service status" } } } }, "/api/v1/rwa/assets": { "get": { "tags": [ "RWA" ], "operationId": "getRwaAssets", "summary": "All RWA assets", "description": "Tokenized real world assets", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Asset list" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/assets/{asset_id}": { "get": { "tags": [ "RWA" ], "operationId": "getRwaAsset", "summary": "Single RWA asset details", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "asset_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Asset details" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/treasuries": { "get": { "tags": [ "RWA" ], "operationId": "getRwaTreasuries", "summary": "Tokenized treasuries (T-Bills)", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Treasury tokens" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/treasury-trust": { "get": { "tags": [ "RWA" ], "operationId": "getRwaTreasuryTrust", "summary": "Treasury trust scores", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Trust data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/redemptions": { "get": { "tags": [ "RWA" ], "operationId": "getRwaRedemptions", "summary": "RWA redemption data", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Redemption history" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/redemption-stress": { "get": { "tags": [ "RWA" ], "operationId": "getRwaRedemptionStress", "summary": "Redemption stress test results", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Stress test data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/classify": { "get": { "tags": [ "RWA" ], "operationId": "getRwaClassify", "summary": "RWA classification", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Classification" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/status": { "get": { "tags": [ "RWA" ], "operationId": "getRwaStatus", "summary": "RWA system status", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "System status" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/grant-info": { "get": { "tags": [ "RWA" ], "operationId": "getRwaGrantInfo", "summary": "RWA grant information", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Grant info" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/rwa/health-carbon": { "get": { "tags": [ "RWA" ], "operationId": "getRwaHealthCarbon", "summary": "RWA carbon health", "responses": { "200": { "description": "OK" } } } }, "/api/v1/rwa/health/{symbol}": { "get": { "tags": [ "RWA" ], "operationId": "getRwaHealthSymbol", "summary": "RWA health by symbol", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Health status" } } } }, "/api/v1/feeds/agents/ranking": { "get": { "tags": [ "Agents" ], "operationId": "getAgentsRanking", "summary": "AI agent token ranking", "description": "Rankings for AI agent tokens", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Agent rankings" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/agents/trends": { "get": { "tags": [ "Agents" ], "operationId": "getAgentsTrends", "summary": "AI agent trends", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Trend data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/agents/{symbol}": { "get": { "tags": [ "Agents" ], "operationId": "getAgent", "summary": "Single AI agent data", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/agents/health": { "get": { "tags": [ "Agents" ], "operationId": "getAgentsHealth", "summary": "Agents feed health", "responses": { "200": { "description": "OK" } } } }, "/api/v1/feeds/knowledge/assets": { "get": { "tags": [ "Knowledge" ], "operationId": "getKnowledgeAssets", "summary": "Knowledge base assets", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Asset knowledge" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/knowledge/stats": { "get": { "tags": [ "Knowledge" ], "operationId": "getKnowledgeStats", "summary": "Knowledge statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Stats" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/knowledge/status": { "get": { "tags": [ "Knowledge" ], "operationId": "getKnowledgeStatus", "summary": "Knowledge system status", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Status" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/knowledge/health": { "get": { "tags": [ "Knowledge" ], "operationId": "getKnowledgeHealth", "summary": "Knowledge feed health", "responses": { "200": { "description": "OK" } } } }, "/api/v1/feeds/supplychain/status": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainStatus", "summary": "Supply chain status", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Status" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/supplychain/stats": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainStats", "summary": "Supply chain statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Stats" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/supplychain/carbon": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainCarbon", "summary": "Supply chain carbon tracking", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Carbon data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/supplychain/transfers": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainTransfers", "summary": "Supply chain transfers", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Transfer log" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/supplychain/product/{product_id}": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainProduct", "summary": "Product tracking", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Product journey" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/feeds/supplychain/health": { "get": { "tags": [ "SupplyChain" ], "operationId": "getSupplychainHealth", "summary": "Supply chain health", "responses": { "200": { "description": "OK" } } } }, "/api/v2/reports/mica-art66": { "get": { "tags": [ "Reports" ], "operationId": "getReportMica", "summary": "MiCA Article 66 PDF report", "description": "EU MiCA sustainability disclosure PDF", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "PDF report" }, "401": { "description": "Pro+ tier required" } } } }, "/api/v2/reports/csrd-esrs": { "get": { "tags": [ "Reports" ], "operationId": "getReportCsrd", "summary": "CSRD/ESRS PDF report", "description": "EU CSRD sustainability reporting PDF", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "PDF report" }, "401": { "description": "Pro+ tier required" } } } }, "/api/v2/reports/dora-operational": { "get": { "tags": [ "Reports" ], "operationId": "getReportDora", "summary": "DORA Operational PDF report", "description": "EU DORA operational resilience PDF", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "PDF report" }, "401": { "description": "Pro+ tier required" } } } }, "/api/v1/reports/catalog": { "get": { "tags": [ "Reports" ], "operationId": "getReportsCatalog", "summary": "Available reports catalog", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Report list" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/reports/disclosure": { "get": { "tags": [ "Reports" ], "operationId": "getReportsDisclosure", "summary": "Disclosure report", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Report" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/reports/disclosure.json": { "get": { "tags": [ "Reports" ], "operationId": "getReportsDisclosureJson", "summary": "Disclosure report (JSON)", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "JSON report" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/reports/audit-export": { "get": { "tags": [ "Reports" ], "operationId": "getReportsAuditExport", "summary": "Audit export", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Export data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/geoip/lookup/{ip}": { "get": { "tags": [ "GeoIP" ], "operationId": "getGeoipLookup", "summary": "IP geolocation lookup", "security": [], "parameters": [ { "name": "ip", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Location data" }, "401": { "description": "Unauthorized" } } } }, "/api/v1/events": { "get": { "tags": [ "Health" ], "operationId": "getEvents", "summary": "System events feed", "responses": { "200": { "description": "Events stream" } } } }, "/api/v1/feeds/health/{symbol}": { "get": { "tags": [ "Health" ], "operationId": "getFeedHealthSymbol", "summary": "Feed health by symbol", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Health status" } } } }, "/api/v3/rlusd/status": { "get": { "tags": [ "RLUSD" ], "operationId": "getRlusdStatus", "summary": "Service status", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdStatusEnvelope" } } } } } } }, "/api/v3/rlusd/cci": { "get": { "tags": [ "RLUSD" ], "operationId": "getCciCompact", "summary": "CCI compact", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdCciCompact" } } } } } } }, "/api/v3/rlusd/risk/cci": { "get": { "tags": [ "RLUSD" ], "operationId": "getCciDetailed", "summary": "CCI detailed", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdCciDetailed" } } } } } } }, "/api/v3/rlusd/supply/breakdown": { "get": { "tags": [ "RLUSD" ], "operationId": "getSupplyBreakdown", "summary": "Supply by chain", "security": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdSupplyBreakdown" } } } } } } }, "/api/v3/rlusd/peg/quality": { "get": { "tags": [ "RLUSD" ], "operationId": "getPegQuality", "summary": "Peg quality", "security": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdPegQuality" } } } } } } }, "/api/v3/rlusd/evidence/latest": { "get": { "tags": [ "RLUSD" ], "operationId": "getEvidenceLatest", "summary": "Evidence pack", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdEvidencePack" } } } } } } }, "/api/v3/rlusd/holders": { "get": { "tags": [ "RLUSD" ], "operationId": "getHolders", "summary": "Holder distribution", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdHoldersResponse" } } } } } } }, "/api/v3/rlusd/webhooks/events": { "get": { "tags": [ "RLUSD" ], "operationId": "getWebhookEvents", "summary": "Webhook catalog", "security": [], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdWebhookCatalog" } } } } } } }, "/api/v1/circuit/status": { "get": { "tags": [ "Legacy" ], "operationId": "getCircuitStatus", "summary": "Circuit breaker", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegacyCircuitStatus" } } } } } } }, "/api/v3/attestations/{attestation_id}": { "get": { "tags": [ "Attestations" ], "operationId": "getAttestation", "summary": "Get attestation by ID", "security": [], "parameters": [ { "name": "attestation_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Attestation data" }, "404": { "description": "Not found" } } } }, "/api/v3/attestations/verify/{attestation_id}": { "get": { "tags": [ "Attestations" ], "operationId": "verifyAttestationV3", "summary": "Verify attestation on-chain", "security": [], "parameters": [ { "name": "attestation_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Verification result" } } } }, "/api/v3/rlusd/verify/{hash}": { "get": { "tags": [ "RLUSD" ], "operationId": "verifyHash", "summary": "Verify hash", "security": [], "parameters": [ { "name": "hash", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RlusdVerifyResponse" } } } } } } }, "/api/v1/circuit/health": { "get": { "tags": [ "Legacy" ], "operationId": "getCircuitHealth", "summary": "Circuit health", "security": [], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegacyHealth" } } } } } } }, "/api/v1/carbon/consistency": { "get": { "tags": [ "Integrity Suite" ], "summary": "Cross-source consistency check", "description": "Validates data across VeChain, EU ETS, Ember, UK Grid", "responses": { "200": { "description": "Consistency report with confidence score 0.0-1.0" } } } }, "/api/v1/baselines": { "get": { "tags": [ "Integrity Suite" ], "summary": "Get current adaptive baselines", "responses": { "200": { "description": "Current baseline values (30-day rolling)" } } } }, "/api/v1/baselines/stats": { "get": { "tags": [ "Integrity Suite" ], "summary": "Get baseline statistics", "responses": { "200": { "description": "Full stats with history days" } } } }, "/api/v1/vc/suppliers": { "get": { "tags": [ "Integrity Suite" ], "summary": "List registered suppliers", "responses": { "200": { "description": "List of supplier IDs with public keys" } } } }, "/api/v1/vc/pubkey/{supplier_id}": { "get": { "tags": [ "Integrity Suite" ], "summary": "Get supplier public key", "parameters": [ { "name": "supplier_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "PEM-encoded ECDSA P-256 public key" } } } }, "/api/v1/vc/verify": { "post": { "tags": [ "Integrity Suite" ], "summary": "Verify JWS signature", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "jws": { "type": "string" } } } } } }, "responses": { "200": { "description": "Verification result with payload" } } } }, "/api/v1/evidence/supplychain-carbon/{product_id}": { "get": { "tags": [ "Evidence" ], "summary": "Supply chain carbon evidence for product", "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Carbon evidence" } } } }, "/api/v1/epm/verify": { "post": { "tags": [ "EPM" ], "summary": "Verify DSSE-wrapped EPM manifest", "operationId": "verifyEPM", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "payloadType", "payload", "signatures" ], "properties": { "payloadType": { "type": "string" }, "payload": { "type": "string" }, "signatures": { "type": "array" } } } } } }, "responses": { "200": { "description": "Verification passed" }, "400": { "description": "Invalid DSSE or manifest" }, "409": { "description": "Replay detected" } } } }, "/api/v1/epm/example/fresh": { "get": { "tags": [ "EPM" ], "summary": "Generate fresh DSSE example for testing", "operationId": "freshExample", "parameters": [ { "name": "type", "in": "query", "schema": { "type": "string", "enum": [ "rlusd", "carbon" ], "default": "rlusd" } } ], "responses": { "200": { "description": "Fresh DSSE envelope with unique manifest_id" } } } }, "/api/v1/epm/manifest/{manifest_id}": { "get": { "tags": [ "Integrity Suite" ], "summary": "Supply Chain Carbon Evidence Pack", "parameters": [ { "name": "product_id", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "country", "in": "query", "schema": { "type": "string", "enum": [ "DE", "UK" ], "default": "DE" } }, { "name": "supplier", "in": "query", "schema": { "type": "string" }, "description": "Supplier ID for signed VC" } ], "responses": { "200": { "description": "Evidence pack with consistency, carbon estimate, optional VC" } } } }, "/api/v1/eu-ets/price": { "get": { "tags": [ "EU Carbon Intelligence" ], "summary": "EU ETS carbon price", "responses": { "200": { "description": "Current EUA price in EUR/tCO2" } } } }, "/api/v1/ember/intensity/{country_code}": { "get": { "tags": [ "EU Carbon Intelligence" ], "summary": "Grid carbon intensity", "parameters": [ { "name": "country_code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "ISO 3166-1 alpha-3 (DEU, GBR, FRA, etc.)" } ], "responses": { "200": { "description": "CO2 intensity in gCO2/kWh" } } } }, "/api/v1/integrity/rlusd": { "get": { "tags": [ "Unified Integrity" ], "summary": "RLUSD Integrity Check", "parameters": [ { "name": "signed", "in": "query", "schema": { "type": "boolean", "default": false } } ], "responses": { "200": { "description": "Integrity report with confidence score" } } } }, "/api/v1/integrity/rlusd/baselines": { "get": { "tags": [ "Unified Integrity" ], "summary": "RLUSD Baselines (peg, reserve, CCI)", "responses": { "200": { "description": "Fixed target baselines" } } } }, "/v1/rwa/risk": { "get": { "tags": [ "RWA Risk Scoring" ], "summary": "All protocol risk scores", "description": "Composite risk scores for 60+ tokenized asset protocols with market summary and grade distribution.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by asset type" } ], "responses": { "200": { "description": "Risk scores for all protocols", "content": { "application/json": { "schema": { "type": "object", "properties": { "protocols_scored": { "type": "integer", "example": 61 }, "total_tvl_usd": { "type": "number" }, "protocols": { "type": "array", "items": { "$ref": "#/components/schemas/RWAProtocolRisk" } }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } }, "401": { "description": "Missing or invalid API key" }, "429": { "description": "Rate limit exceeded (60 req/min)" } } } }, "/v1/rwa/risk/{slug}": { "get": { "tags": [ "RWA Risk Scoring" ], "summary": "Single protocol - full risk profile + evidence", "description": "Complete risk profile with 9 vector scores, reason codes, compliance, legal state. For regulated stablecoins includes stablecoin_detail. For XRPL assets includes xrpl_detail.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol identifier (e.g. rlusd, blackrock-buidl, xrpl-ecosystem)" } ], "responses": { "200": { "description": "Full protocol risk profile", "content": { "application/json": { "schema": { "type": "object", "properties": { "protocol": { "$ref": "#/components/schemas/RWAProtocolRisk" }, "benchmark": { "type": "object", "properties": { "tbill_3m": { "type": "number", "example": 3.6 } } }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } }, "401": { "description": "Missing or invalid API key" }, "404": { "description": "Protocol not found" }, "429": { "description": "Rate limit exceeded (60 req/min)" } } } }, "/v1/rwa/risk/{slug}/pdf": { "get": { "tags": [ "RWA Risk Scoring" ], "summary": "PDF risk report", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol identifier (e.g. rlusd, blackrock-buidl, xrpl-ecosystem)" } ], "responses": { "200": { "description": "PDF report", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/market": { "get": { "tags": [ "RWA Risk Scoring" ], "summary": "Market overview & aggregate stats", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Market overview", "content": { "application/json": { "schema": { "type": "object", "properties": { "total_tvl_usd": { "type": "number" }, "protocols_scored": { "type": "integer" }, "grade_distribution": { "type": "object" }, "type_breakdown": { "type": "object" }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } } } } }, "/v1/rwa/registry": { "get": { "tags": [ "RWA Registry" ], "summary": "All protocol identifiers", "description": "Structured identifiers including token metadata, issuer details, LEI, ISIN.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Registry entries" } } } }, "/v1/rwa/registry/{slug}": { "get": { "tags": [ "RWA Registry" ], "summary": "Single protocol identifiers", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Registry entry" }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/registry/search": { "get": { "tags": [ "RWA Registry" ], "summary": "Search by name, symbol, or ISIN", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query" } ], "responses": { "200": { "description": "Matching protocols" } } } }, "/v1/rwa/registry/stats": { "get": { "tags": [ "RWA Registry" ], "summary": "Registry statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Aggregate registry stats" } } } }, "/v1/rwa/compliance": { "get": { "tags": [ "RWA Compliance" ], "summary": "All protocols - compliance overview", "description": "MiCA, DORA, sanctions screening, jurisdiction access for all protocols.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Compliance data" } } } }, "/v1/rwa/compliance/{slug}": { "get": { "tags": [ "RWA Compliance" ], "summary": "Single protocol - compliance profile", "description": "Jurisdiction access, sanctions screening, investor requirements, KYC level.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Compliance profile" }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/compliance/jurisdiction/{code}": { "get": { "tags": [ "RWA Compliance" ], "summary": "Filter by jurisdiction", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "code", "in": "path", "required": true, "schema": { "type": "string" }, "description": "ISO jurisdiction code (US, EU, SG)" } ], "responses": { "200": { "description": "Protocols in jurisdiction" } } } }, "/v1/rwa/compliance/check": { "get": { "tags": [ "RWA Compliance" ], "summary": "Cross-border compliance check", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "from", "in": "query", "schema": { "type": "string" }, "description": "Source jurisdiction" }, { "name": "to", "in": "query", "schema": { "type": "string" }, "description": "Target jurisdiction" } ], "responses": { "200": { "description": "Compliance check result" } } } }, "/v1/rwa/compliance/stats": { "get": { "tags": [ "RWA Compliance" ], "summary": "Compliance statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Aggregate compliance stats" } } } }, "/v1/rwa/legal-state": { "get": { "tags": [ "RWA Legal State" ], "summary": "All protocols - legal structure", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Legal state overview" } } } }, "/v1/rwa/legal-state/{slug}": { "get": { "tags": [ "RWA Legal State" ], "summary": "Single protocol - legal details", "description": "Contract powers, transfer finality, dispute resolution, governance.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Legal state details" }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/legal-state/search": { "get": { "tags": [ "RWA Legal State" ], "summary": "Search legal states", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Keyword (e.g. multisig, timelock, arbitration)" } ], "responses": { "200": { "description": "Matching entries" } } } }, "/v1/rwa/legal-state/stats": { "get": { "tags": [ "RWA Legal State" ], "summary": "Legal state statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Aggregate legal stats" } } } }, "/v1/rwa/oracle/feeds/{slug}": { "get": { "tags": [ "RWA Oracle Feeds" ], "summary": "Consensus price feed", "description": "Multi-source aggregation (median/weighted median) with outlier removal. Sources include Chainlink, Pyth, CoinGecko.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Oracle feed data", "content": { "application/json": { "schema": { "type": "object", "properties": { "oracle": { "type": "object", "properties": { "value_str": { "type": "string", "example": "5054.88000000" }, "precision": { "type": "integer" }, "base_asset": { "type": "string" }, "consensus": { "type": "object", "properties": { "rule": { "type": "string", "example": "weighted_median" }, "sources": { "type": "integer" }, "agreement_pct": { "type": "number" } } }, "staleness": { "type": "object", "properties": { "oldest_source_age_s": { "type": "integer" }, "is_stale": { "type": "boolean" } } } } } } } } } }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/oracle/status": { "get": { "tags": [ "RWA Oracle Feeds" ], "summary": "Oracle infrastructure status", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Oracle status overview" } } } }, "/v1/rwa/liquidity": { "get": { "tags": [ "RWA Liquidity" ], "summary": "All protocols - liquidity overview", "description": "DEX liquidity summaries. Note: many RWA tokens trade via mint/redeem on primary markets.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Liquidity overview" } } } }, "/v1/rwa/liquidity/{slug}": { "get": { "tags": [ "RWA Liquidity" ], "summary": "Single protocol - detailed liquidity", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Liquidity details", "content": { "application/json": { "schema": { "type": "object", "properties": { "result": { "type": "object", "properties": { "m": { "type": "object", "properties": { "total_liq_usd": { "type": "number" }, "vol_24h_usd": { "type": "number" }, "pair_count": { "type": "integer" } } }, "liq": { "type": "object", "properties": { "score": { "type": "integer" }, "cat": { "type": "string", "enum": [ "DEEP", "MODERATE", "THIN", "NO_DEX" ] } } } } } } } } } }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/onchain": { "get": { "tags": [ "RWA On-Chain" ], "summary": "All protocols - transparency overview", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "On-chain overview" } } } }, "/v1/rwa/onchain/{slug}": { "get": { "tags": [ "RWA On-Chain" ], "summary": "Single protocol - on-chain analysis", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "On-chain details", "content": { "application/json": { "schema": { "type": "object", "properties": { "verification_status": { "type": "string", "enum": [ "TRANSPARENT", "PARTIAL", "OPAQUE" ] }, "score": { "type": "integer" }, "proxy_detected": { "type": "boolean" } } } } } }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/esg/{slug}": { "get": { "tags": [ "RWA ESG" ], "summary": "ESG / carbon score", "description": "Chain-weighted carbon footprint scoring with data provenance.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "ESG score", "content": { "application/json": { "schema": { "type": "object", "properties": { "score": { "type": "integer" }, "category": { "type": "string", "enum": [ "EXCELLENT", "GOOD", "MODERATE", "POOR" ] }, "chains_matched": { "type": "integer" } } } } } }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/events": { "get": { "tags": [ "RWA Events" ], "summary": "All protocols - recent events", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Risk events" } } } }, "/v1/rwa/events/{slug}": { "get": { "tags": [ "RWA Events" ], "summary": "Single protocol - events", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Protocol events" }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/events/stats": { "get": { "tags": [ "RWA Events" ], "summary": "Event statistics", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Event type distribution" } } } }, "/v1/rwa/history": { "get": { "tags": [ "RWA History" ], "summary": "All protocols - score history", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Historical scores" } } } }, "/v1/rwa/history/{slug}": { "get": { "tags": [ "RWA History" ], "summary": "Single protocol - score timeline", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Score history" }, "404": { "description": "Protocol not found" } } } }, "/v1/rwa/discovery": { "get": { "tags": [ "RWA Risk Scoring" ], "summary": "Newly discovered protocols", "description": "Auto-discovered on-chain RWA protocols not yet in scored registry.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Discovered protocols" } } } }, "/v1/rwa/alerts": { "get": { "tags": [ "RWA Alerts" ], "summary": "List webhook subscriptions", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Active subscriptions" } } } }, "/v1/rwa/alerts/subscribe": { "post": { "tags": [ "RWA Alerts" ], "summary": "Create webhook subscription", "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "webhook_url" ], "properties": { "webhook_url": { "type": "string", "format": "uri" }, "events": { "type": "array", "items": { "type": "string", "enum": [ "grade_change", "score_threshold", "anomaly_detected", "peg_deviation", "tvl_drop" ] } }, "slugs": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "201": { "description": "Subscription created" } }, "callbacks": { "onEvent": { "{$request.body#/webhook_url}": { "post": { "summary": "Webhook event delivery", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RWAWebhookEvent" } } } }, "responses": { "200": { "description": "Acknowledged" } } } } } } } }, "/v1/rwa/alerts/{id}": { "delete": { "tags": [ "RWA Alerts" ], "summary": "Delete webhook subscription", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Deleted" } } } }, "/v1/rwa/redemption": { "get": { "tags": [ "RWA Redemption" ], "summary": "All protocols - liquidity profiles", "description": "Institutional exit analysis: settlement times, gates, minimum amounts, fees. Data expanded progressively.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Redemption profiles", "content": { "application/json": { "schema": { "type": "object", "properties": { "protocols_count": { "type": "integer" }, "protocols": { "type": "array", "items": { "$ref": "#/components/schemas/RWARedemptionProfile" } }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } }, "401": { "description": "Missing or invalid API key" } } } }, "/v1/rwa/redemption/{slug}": { "get": { "tags": [ "RWA Redemption" ], "summary": "Single protocol - liquidity profile", "description": "Complete Time-to-Cash analysis: settlement time, gates, fees, minimum amounts, liquidity latency score.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Redemption profile", "content": { "application/json": { "schema": { "type": "object", "properties": { "redemption_profile": { "$ref": "#/components/schemas/RWARedemptionProfile" }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } }, "404": { "description": "Protocol not found or no data available yet (progressive expansion)" }, "401": { "description": "Missing or invalid API key" } } } }, "/v1/rwa/documents": { "get": { "tags": [ "RWA Documents" ], "summary": "All protocols - document registry overview", "description": "Summary of available compliance documents per protocol. Source URLs point to issuer-hosted originals.", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Document registry overview" }, "401": { "description": "Missing or invalid API key" } } } }, "/v1/rwa/documents/{slug}": { "get": { "tags": [ "RWA Documents" ], "summary": "Single protocol - full document list", "description": "Attestation reports, prospectuses, audit reports, legal documents. URLs point to issuer/auditor sources. SHA-256 hashes for integrity verification where available.", "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ], "responses": { "200": { "description": "Document list", "content": { "application/json": { "schema": { "type": "object", "properties": { "slug": { "type": "string" }, "documents": { "type": "array", "items": { "$ref": "#/components/schemas/RWADocument" } }, "total_documents": { "type": "integer" }, "last_updated": { "type": "string", "format": "date" }, "evidence": { "$ref": "#/components/schemas/RWAEvidence" } } } } } }, "404": { "description": "Protocol not found or no data available yet (progressive expansion)" }, "401": { "description": "Missing or invalid API key" } } } }, "/api/v1/macro/yield-curve": { "get": { "tags": [ "Yields" ], "operationId": "getYieldCurve", "summary": "Full Treasury yield curve 1M-30Y", "description": "11 tenors: 1M,3M,6M,1Y,2Y,3Y,5Y,7Y,10Y,20Y,30Y with shape analysis", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/yield-curve/spreads": { "get": { "tags": [ "Yields" ], "operationId": "getYieldSpreads", "summary": "Yield curve spreads", "description": "2s10s, 3M-10Y, 5s30s, term premium, inversion signals", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/yield-curve/tips": { "get": { "tags": [ "Yields" ], "operationId": "getYieldTIPS", "summary": "TIPS real yields", "description": "5Y,10Y,20Y,30Y TIPS and breakeven inflation", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/sofr": { "get": { "tags": [ "Credit" ], "operationId": "getSOFR", "summary": "SOFR rate", "description": "Secured Overnight Financing Rate, benchmark status", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/credit": { "get": { "tags": [ "Credit" ], "operationId": "getCreditSpreads", "summary": "Credit spreads", "description": "AAA/BAA yields, BAA-AAA spread, prime rate", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/lending": { "get": { "tags": [ "Credit" ], "operationId": "getLending", "summary": "Bank lending", "description": "C&I loan rates, lending standards, tightening index", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/fed-rates": { "get": { "tags": [ "Credit" ], "operationId": "getFedRates", "summary": "Fed overnight rates", "description": "EFFR, OBFR, Reverse Repo ON RRP", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/commodities": { "get": { "tags": [ "Commodities" ], "operationId": "getCommodities", "summary": "All commodities", "description": "Energy + metals overview", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/commodities/energy": { "get": { "tags": [ "Commodities" ], "operationId": "getEnergy", "summary": "Energy prices", "description": "WTI, Brent, natgas, gasoline, propane", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/commodities/metals": { "get": { "tags": [ "Commodities" ], "operationId": "getMetals", "summary": "Precious metals", "description": "Gold, silver, copper indices", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/equities": { "get": { "tags": [ "Equities" ], "operationId": "getEquities", "summary": "Stock indices", "description": "S&P 500, NASDAQ, Dow Jones", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/equities/{symbol}": { "get": { "tags": [ "Equities" ], "operationId": "getEquity", "summary": "Single index", "description": "By symbol", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "sp500, nasdaq, dow" } ], "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/crypto": { "get": { "tags": [ "Crypto" ], "operationId": "getCrypto", "summary": "Crypto prices", "description": "BTC/USD, ETH/USD via FRED", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/crypto/{symbol}": { "get": { "tags": [ "Crypto" ], "operationId": "getCryptoSingle", "summary": "Single crypto", "description": "By symbol", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "btc or eth" } ], "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/stress": { "get": { "tags": [ "Stress" ], "operationId": "getStress", "summary": "Financial stress", "description": "Composite score, VIX, STLFSI, TED, HY spread", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/volatility": { "get": { "tags": [ "Stress" ], "operationId": "getVolatility", "summary": "VIX detail", "description": "CBOE VIX, regime classification", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/expectations": { "get": { "tags": [ "Stress" ], "operationId": "getExpectations", "summary": "Inflation expectations", "description": "Michigan inflation expectations", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/realestate": { "get": { "tags": [ "Real Estate" ], "operationId": "getRealEstate", "summary": "Housing overview", "description": "Prices, rates, activity metrics", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/realestate/prices": { "get": { "tags": [ "Real Estate" ], "operationId": "getREPrices", "summary": "Home prices", "description": "Case-Shiller, FHFA HPI, median price", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/realestate/mortgage": { "get": { "tags": [ "Real Estate" ], "operationId": "getMortgage", "summary": "Mortgage rates", "description": "30Y, 15Y fixed, ARM rates", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/fiscal": { "get": { "tags": [ "Fiscal" ], "operationId": "getFiscal", "summary": "Federal debt overview", "description": "Total debt, deficit, debt-to-GDP, foreign holdings", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/fiscal/debt": { "get": { "tags": [ "Fiscal" ], "operationId": "getFiscalDebt", "summary": "Federal debt", "description": "Debt total, foreign held, Debt/GDP ratio", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/fiscal/trade": { "get": { "tags": [ "Fiscal" ], "operationId": "getFiscalTrade", "summary": "Trade balance", "description": "Trade balance, USD index, monetary base", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/business": { "get": { "tags": [ "Business" ], "operationId": "getBusiness", "summary": "Business overview", "description": "Production, utilization, credit, delinquency", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/business/production": { "get": { "tags": [ "Business" ], "operationId": "getProduction", "summary": "Industrial production", "description": "Industrial production index, capacity utilization", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/business/credit": { "get": { "tags": [ "Business" ], "operationId": "getBizCredit", "summary": "Business credit", "description": "Commercial loans, consumer credit, delinquency", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/international/bonds": { "get": { "tags": [ "International" ], "operationId": "getIntlBonds", "summary": "International bonds", "description": "Germany 10Y, UK 10Y, Japan 10Y yields", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/international/fx": { "get": { "tags": [ "International" ], "operationId": "getIntlFX", "summary": "FX rates (FRED)", "description": "EUR,GBP,JPY,CHF,CNY,KRW,MXN,INR,BRL vs USD", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/international/spreads": { "get": { "tags": [ "International" ], "operationId": "getIntlSpreads", "summary": "Sovereign spreads", "description": "US-DE, US-UK, US-JP yield spreads", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb": { "get": { "tags": [ "ECB" ], "operationId": "getECB", "summary": "ECB overview", "description": "Key rates, EUR/USD, HICP inflation, GDP, unemployment. Source: ECB Data Portal", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/rates": { "get": { "tags": [ "ECB" ], "operationId": "getECBRates", "summary": "ECB interest rates", "description": "Refi, deposit, marginal lending, eSTR, EURIBOR 3M/6M/12M", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/fx": { "get": { "tags": [ "ECB" ], "operationId": "getECBFX", "summary": "ECB exchange rates", "description": "EUR vs USD,GBP,JPY,CHF,CNY + EUR strength index", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/inflation": { "get": { "tags": [ "ECB" ], "operationId": "getECBInflation", "summary": "Eurozone inflation", "description": "EA HICP, core HICP, Germany HICP, target assessment", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/economy": { "get": { "tags": [ "ECB" ], "operationId": "getECBEconomy", "summary": "Eurozone economy", "description": "GDP growth, unemployment, M3 money supply", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/yields": { "get": { "tags": [ "ECB" ], "operationId": "getECBYields", "summary": "EA bond yields", "description": "10Y AAA government bond yield, real yield", "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/api/v1/macro/ecb/series/{series_id}": { "get": { "tags": [ "ECB" ], "operationId": "getECBSeries", "summary": "Single ECB series", "description": "Any of the 20 ECB series", "parameters": [ { "name": "series_id", "in": "path", "required": true, "schema": { "type": "string" }, "description": "e.g. eur_usd, deposit_rate, hicp_ea, gdp_ea" } ], "responses": { "200": { "description": "JSON with oracle_ready flag" } } } }, "/reports/api/report/generate": { "post": { "tags": [ "Verified Reports" ], "summary": "Generate a cryptographically signed evidence report", "description": "Generates a PDF report with SHA-256 hash, ECDSA signature, and XRPL blockchain anchor.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string", "enum": [ "rwa_risk", "macro_risk", "mica", "dora" ] } } } } } }, "responses": { "200": { "description": "Report generated with proof chain" } } } }, "/reports/api/report/{report_id}/pdf": { "get": { "tags": [ "Verified Reports" ], "summary": "Download report PDF", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "PDF file", "content": { "application/pdf": {} } } } } }, "/reports/api/report/{report_id}/verify": { "get": { "tags": [ "Verified Reports" ], "summary": "Verify report cryptographic integrity", "parameters": [ { "name": "report_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Verification proof (hash, signature, signer)" } } } }, "/reports/api/reports": { "get": { "tags": [ "Verified Reports" ], "summary": "List all generated reports", "responses": { "200": { "description": "Array of reports with metadata" } } } }, "/reports/api/health": { "get": { "tags": [ "Verified Reports" ], "summary": "Reports service health", "responses": { "200": { "description": "Service status" } } } }, "/api/v1/csrd/": { "get": { "tags": [ "CSRD / ESRS" ], "summary": "CSRD service root with available endpoints", "responses": { "200": { "description": "OK" } } } }, "/api/v1/csrd/chain-footprint/{symbol}": { "get": { "tags": [ "CSRD / ESRS" ], "summary": "Per-chain carbon footprint for CSRD reporting", "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Chain symbol (e.g., ETH, BTC, SOL)" } ], "responses": { "200": { "description": "Chain-specific GHG emissions data" } } } }, "/api/v1/csrd/esrs-e1": { "get": { "tags": [ "CSRD / ESRS" ], "summary": "ESRS E1 Climate Change disclosure: Scope 3 Category 11 GHG emissions for blockchain networks", "responses": { "200": { "description": "ESRS E1-6 GHG emissions and E1-9 financial effects" } } } }, "/api/v1/csrd/eu-energy-mix": { "get": { "tags": [ "CSRD / ESRS" ], "summary": "EU energy mix data for CSRD context", "responses": { "200": { "description": "EU energy generation breakdown by source" } } } }, "/api/v1/dora/": { "get": { "tags": [ "DORA Compliance" ], "summary": "DORA service root with available endpoints", "responses": { "200": { "description": "OK" } } } }, "/api/v1/dora/evidence-infrastructure": { "get": { "tags": [ "DORA Compliance" ], "summary": "Evidence infrastructure for DORA compliance reporting", "responses": { "200": { "description": "Evidence pack structure for DORA compliance" } } } }, "/api/v1/dora/ict-risk": { "get": { "tags": [ "DORA Compliance" ], "summary": "ICT Risk Management framework (DORA Art. 5-16)", "responses": { "200": { "description": "ICT risk management requirements and assessment" } } } }, "/api/v1/dora/incident-reporting": { "get": { "tags": [ "DORA Compliance" ], "summary": "ICT-related incident reporting (DORA Art. 17-23)", "responses": { "200": { "description": "Incident classification and reporting requirements" } } } }, "/api/v1/dora/overview": { "get": { "tags": [ "DORA Compliance" ], "summary": "DORA regulation overview covering Articles 5-27", "responses": { "200": { "description": "Overview of DORA chapters and requirements" } } } }, "/api/v1/dora/resilience-testing": { "get": { "tags": [ "DORA Compliance" ], "summary": "Digital operational resilience testing (DORA Art. 24-27)", "responses": { "200": { "description": "Resilience testing requirements and threat-led penetration testing" } } } }, "/api/v1/dora/third-party": { "get": { "tags": [ "DORA Compliance" ], "summary": "Third-party risk management (DORA Art. 28-44)", "responses": { "200": { "description": "Third-party ICT provider risk assessment framework" } } } }, "/api/v1/esma/": { "get": { "tags": [ "ESMA Register" ], "summary": "ESMA Register service root with available endpoints", "responses": { "200": { "description": "OK" } } } }, "/api/v1/esma/casps": { "get": { "tags": [ "ESMA Register" ], "summary": "Authorized Crypto-Asset Service Providers (20 entities across 11 EU jurisdictions)", "responses": { "200": { "description": "List of authorized CASPs with LEI, NCA, services, authorization date" } }, "parameters": [ { "name": "country", "in": "query", "schema": { "type": "string" }, "description": "Filter by country code (DE, FR, IE, AT, etc.)" }, { "name": "service", "in": "query", "schema": { "type": "string" }, "description": "Filter by service type (exchange, custody, transfer, portfolio_management)" } ] } }, "/api/v1/esma/emt-issuers": { "get": { "tags": [ "ESMA Register" ], "summary": "E-Money Token issuers (7 entities: 5 EUR, 2 USD stablecoins)", "responses": { "200": { "description": "List of EMT issuers with token details, license type, reserve model" } }, "parameters": [ { "name": "currency", "in": "query", "schema": { "type": "string" }, "description": "Filter by peg currency (EUR, USD)" } ] } }, "/api/v1/esma/non-compliant": { "get": { "tags": [ "ESMA Register" ], "summary": "Non-compliant entities flagged for MiCA violations (5 entities)", "responses": { "200": { "description": "List of non-compliant entities with issue type and severity" } } } }, "/api/v1/esma/pending": { "get": { "tags": [ "ESMA Register" ], "summary": "Pending MiCA applications (3 entities)", "responses": { "200": { "description": "List of pending applications with type and NCA" } } } }, "/api/v1/esma/search": { "get": { "tags": [ "ESMA Register" ], "summary": "Full-text search across all register entities", "responses": { "200": { "description": "Search results with entity type and matching fields" } }, "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Search query (e.g., coinbase, tether, circle)" } ] } }, "/api/v1/esma/stats": { "get": { "tags": [ "ESMA Register" ], "summary": "Aggregated register statistics by country, service type, currency", "responses": { "200": { "description": "Statistical breakdown of registered entities" } } } }, "/api/v1/esma/summary": { "get": { "tags": [ "ESMA Register" ], "summary": "Register summary: CASPs, EMT issuers, non-compliant, pending counts with MiCA deadline countdown", "responses": { "200": { "description": "Register summary with entity counts and MiCA days remaining" } } } }, "/api/v1/eu-energy/generation/{country}": { "get": { "tags": [ "EU Energy" ], "summary": "Real-time electricity generation by source from ENTSO-E Transparency Platform", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Country code (e.g., DE, FR, ES, IT)" } ], "responses": { "200": { "description": "Generation by type with renewable percentage, updated every 15 minutes" } } } }, "/api/v1/eu-energy/load/{country}": { "get": { "tags": [ "EU Energy" ], "summary": "Real-time electricity load from ENTSO-E", "parameters": [ { "name": "country", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Country code" } ], "responses": { "200": { "description": "Total electricity load in MW" } } } }, "/api/v1/evidence/asset-registry/{protocol_id}": { "get": { "summary": "Asset Registry", "description": "On-chain asset registry for RWA protocols.", "tags": [ "Evidence" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "protocol_id", "in": "path", "required": true, "schema": { "type": "string" } } ] } }, "/api/v1/evidence/custody/{slug}": { "get": { "summary": "Custody Evidence", "description": "Custody and counterparty risk evidence for RWA protocols.", "tags": [ "Evidence" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug (e.g. blackrock-buidl)" } ] } }, "/api/v1/evidence/mica/full/{symbol}": { "get": { "summary": "MiCA Full Evidence", "description": "MiCA article-coverage evidence pack. Provides MiCA-relevant evidence indicators for human review; not a compliance verdict.", "tags": [ "Evidence" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/mica/custody-risk/{protocol}": { "get": { "summary": "MiCA Custody Risk Feed", "description": "Feed-format custody risk analysis per Art. 26/27/54.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "protocol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug" } ] } }, "/api/v1/feeds/mica/document-compliance/{symbol}": { "get": { "summary": "MiCA Document Compliance Feed", "description": "Feed-format document compliance check per Art. 29/30/37/55.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/mica/full-pack/{symbol}": { "get": { "summary": "MiCA Full Evidence Pack Feed", "description": "Feed-format complete MiCA evidence pack covering Art. 22-58.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/mica/interest-check/{symbol}": { "get": { "summary": "MiCA Interest Check Feed", "description": "Feed-format interest prohibition check per Art. 23/52.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/mica/reserve-quality/{symbol}": { "get": { "summary": "MiCA Reserve Quality Feed", "description": "Feed-format reserve quality assessment per Art. 24/25/36/53.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/mica/significant-issuer/{symbol}": { "get": { "summary": "MiCA Significant Issuer Feed", "description": "Feed-format significant issuer detection per Art. 45/58.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/feeds/stablecoin": { "get": { "summary": "Stablecoin Universe", "description": "Returns comprehensive data for 105+ stablecoins including market cap, peg status, reserve composition, MiCA classification, and risk scores.", "tags": [ "Stablecoin" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/feeds/stablecoin/meta": { "get": { "summary": "Stablecoin Metadata", "description": "Returns metadata for the stablecoin feed including data sources, update frequency, and coverage.", "tags": [ "Stablecoin" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/feeds/stablecoin/{symbol}": { "get": { "summary": "Single Stablecoin Status", "description": "Enterprise-grade single stablecoin status including peg health, reserve analysis, issuer details, MiCA classification, and compliance scores.", "tags": [ "Stablecoin" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/mica/": { "get": { "summary": "MiCA Endpoints Index", "description": "Lists all available MiCA compliance REST API endpoints.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/mica/custody/{slug}": { "get": { "summary": "Custody Risk Analysis (Art. 26/27/54)", "description": "Evaluates custody and counterparty risk including SIFI status, concentration risk, and DORA Art. 28 relevance.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Protocol slug (e.g. blackrock-buidl)" } ] } }, "/api/v1/mica/documents/{symbol}": { "get": { "summary": "Document Compliance (Art. 29/30/37/55)", "description": "Evaluates whitepaper and disclosure document compliance against MiCA documentation requirements.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/mica/full/{symbol}": { "get": { "summary": "Full MiCA Evidence Pack (Art. 22-58)", "description": "Comprehensive MiCA compliance evidence pack covering 12+ articles. Includes significant issuer check, interest prohibition, reserve quality, document compliance, and custody risk in a single response.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/mica/interest/{symbol}": { "get": { "summary": "Interest Prohibition Check (Art. 23/52)", "description": "Checks whether a stablecoin complies with MiCA interest prohibition rules under Articles 23 (EMT) and 52 (ART).", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/mica/reserves/{symbol}": { "get": { "summary": "Reserve Quality Assessment (Art. 24/25/36/53)", "description": "Analyzes reserve composition and quality against MiCA reserve requirements including eligible asset types, concentration limits, and custody standards.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/api/v1/mica/significant/{symbol}": { "get": { "summary": "Significant Issuer Check (Art. 45/58)", "description": "Determines if a stablecoin issuer qualifies as significant under MiCA Articles 45 (EMT) or 58 (ART) based on market cap, transaction volume, and cross-border activity.", "tags": [ "MiCA Compliance" ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } } }, "parameters": [ { "name": "symbol", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stablecoin symbol (e.g. usdc, usdt, dai)" } ] } }, "/v1/rwa/anomalies": { "get": { "tags": [ "Anomaly Detection" ], "summary": "ML anomaly scores", "parameters": [ { "$ref": "#/components/parameters/ApiKeyHeader" }, { "$ref": "#/components/parameters/NonceHeader" } ], "responses": { "200": { "description": "Success" }, "503": { "$ref": "#/components/responses/DataUnavailable" } } } }, "/v1/rwa/health": { "get": { "tags": [ "System" ], "summary": "API Health Check", "responses": { "200": { "description": "Status and endpoint list" } } } }, "/v1/rwa/oracle/assets": { "get": { "tags": [ "Oracle Feeds" ], "summary": "Supported oracle assets", "parameters": [ { "$ref": "#/components/parameters/ApiKeyHeader" }, { "$ref": "#/components/parameters/NonceHeader" } ], "responses": { "200": { "description": "Success" } } } }, "/api/v1/macro/defi-relevant": { "get": { "tags": [ "Macro Oracle" ], "summary": "DeFi Macro Bundle", "description": "Curated macro-economic data bundle for DeFi/RWA protocols. Includes SOFR lending rates, VIX/credit spreads, BTC/ETH reference prices, yield curve, inflation expectations, EUR/USD, and S&P 500 \u2014 with computed risk level.", "operationId": "getDefiMacroBundle", "responses": { "200": { "description": "DeFi-relevant macro bundle with risk level" } } } }, "/api/v1/macro/ecb/mica-reserve": { "get": { "tags": [ "MiCA Compliance" ], "summary": "ECB MiCA Reserve Intelligence", "description": "MiCA Art. 36/38 reserve management intelligence for EUR stablecoins. ECB policy rates, EURIBOR benchmarks, real yield analysis, currency stability, and compliance signals \u2014 sourced from ECB Data Portal.", "operationId": "getEcbMicaReserve", "responses": { "200": { "description": "MiCA reserve intelligence with compliance signals" } } } }, "/ai/query": { "post": { "summary": "Natural Language \u2192 Evidence Bundle", "description": "Submit a natural language question, receive a cryptographically signed evidence bundle. Two-tier intent classification (regex + DeepSeek fallback). Every response includes evidence{}, jws{}, sla{}, trust{}, schema_ref.", "tags": [ "AI Gateway" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "question": { "type": "string", "example": "Is USDC MiCA compliant?" }, "symbol": { "type": "string", "example": "USDC" } }, "required": [ "question" ] } } } }, "responses": { "200": { "description": "Signed evidence bundle with JWS, SLA, trust metadata" } } } }, "/ai/capabilities": { "get": { "summary": "AI Gateway Capabilities", "description": "Lists all supported intents with example queries and routing information.", "tags": [ "AI Gateway" ], "responses": { "200": { "description": "Capability manifest" } } } }, "/ai/explain": { "post": { "summary": "Grade Explainability", "description": "Explain why an asset received a specific compliance grade. Returns per-dimension scoring with regulatory article references.", "tags": [ "AI Gateway" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string" }, "evidence_pack_id": { "type": "string" } } } } } }, "responses": { "200": { "description": "Dimension-level scoring explanation" } } } }, "/ai/provenance": { "post": { "summary": "Data Provenance Graph", "description": "Full provenance chain from source data to evidence bundle. Every node individually hashed, Merkle-chained.", "tags": [ "AI Gateway" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "symbol": { "type": "string" }, "frameworks": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "200": { "description": "Provenance graph with upstream hashes" } } } }, "/evidence/bundle": { "post": { "summary": "Multi-Framework Evidence Bundle", "description": "Aggregate evidence across multiple frameworks (mica, dora, rwa, macro, stablecoin_risk) in a single request.", "tags": [ "AI Gateway" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "asset": { "type": "string", "example": "USDC" }, "frameworks": { "type": "array", "items": { "type": "string" }, "example": [ "mica", "macro" ] } } } } } }, "responses": { "200": { "description": "Multi-framework evidence bundle with JWS, SLA" } } } }, "/evidence/freshness": { "get": { "summary": "Data Source Freshness", "description": "Health check of all upstream data sources with per-source latency, status, and SLA metrics.", "tags": [ "AI Gateway" ], "responses": { "200": { "description": "Source health status with SLA" } } } }, "/schemas/": { "get": { "summary": "Schema Registry Index", "description": "List all 8 versioned JSON Schemas (Draft 2020-12): evidence-envelope, mica, dora, rwa, macro, stablecoin-risk, amlr, sla.", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "Schema registry with total count and URLs" } } } }, "/schemas/v1/{framework}": { "get": { "summary": "Individual JSON Schema", "description": "Retrieve a specific versioned JSON Schema for evidence validation.", "tags": [ "Enterprise Trust Layer" ], "parameters": [ { "name": "framework", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "evidence-envelope", "mica", "dora", "rwa", "macro", "stablecoin-risk", "amlr", "sla" ] } } ], "responses": { "200": { "description": "JSON Schema (Draft 2020-12)" }, "404": { "description": "Schema not found" } } } }, "/evidence/registry": { "get": { "summary": "Evidence Registry (Compliance Transparency Log)", "description": "Append-only log of every evidence pack produced. Inspired by Google Certificate Transparency. Filterable by framework, asset, date range.", "tags": [ "Enterprise Trust Layer" ], "parameters": [ { "name": "framework", "in": "query", "schema": { "type": "string" } }, { "name": "asset", "in": "query", "schema": { "type": "string" } }, { "name": "from", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "schema": { "type": "string", "format": "date" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 50, "maximum": 200 } }, { "name": "offset", "in": "query", "schema": { "type": "integer", "default": 0 } }, { "name": "has_anchor", "in": "query", "schema": { "type": "boolean" } } ], "responses": { "200": { "description": "Paginated evidence registry entries" } } } }, "/evidence/registry/{pack_id}": { "get": { "summary": "Evidence Pack Detail", "description": "Retrieve details of a specific evidence pack from the registry.", "tags": [ "Enterprise Trust Layer" ], "parameters": [ { "name": "pack_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Evidence pack detail" }, "404": { "description": "Pack not found" } } } }, "/evidence/registry/stats": { "get": { "summary": "Registry Statistics", "description": "Aggregated statistics: total packs, per framework, per asset, per day.", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "Registry statistics" } } } }, "/evidence/stream": { "get": { "summary": "Streaming Evidence (SSE)", "description": "Real-time Server-Sent Events for compliance state changes. Events: peg_deviation, regime_change, market_stress, reserve_alert. Events fire only on state change. Every event is SHA-256 hashed.", "tags": [ "Enterprise Trust Layer" ], "parameters": [ { "name": "events", "in": "query", "schema": { "type": "string" }, "description": "Comma-separated event types" }, { "name": "assets", "in": "query", "schema": { "type": "string" }, "description": "Comma-separated asset symbols" } ], "responses": { "200": { "description": "text/event-stream with signed events" } } } }, "/evidence/stream/status": { "get": { "summary": "Stream Status", "description": "Poller status, connected clients, current state, supported events, thresholds.", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "Stream status" } } } }, "/evidence/replay/{pack_id}": { "get": { "summary": "Deterministic Audit Replay", "description": "Reconstruct an evidence pack from the immutable snapshot archive. hash_match: true = cryptographic proof of deterministic reproducibility.", "tags": [ "Enterprise Trust Layer" ], "parameters": [ { "name": "pack_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Replayed evidence with hash match proof" }, "404": { "description": "Snapshot not found" } } } }, "/evidence/snapshots/stats": { "get": { "summary": "Snapshot Archive Statistics", "description": "Total snapshots, storage size, compression ratio, per-framework and per-day counts.", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "Snapshot statistics" } } } }, "/ai/agent/register": { "post": { "summary": "Register AI Agent", "description": "Register a new AI agent. Returns agent_id, API key (90-day lifecycle), and initial reputation score (50/100).", "tags": [ "Agent Trust Management" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "agent_name" ], "properties": { "agent_name": { "type": "string" }, "organization": { "type": "string" }, "purpose": { "type": "string", "enum": [ "compliance", "trading", "audit", "risk_management", "general" ] }, "frameworks": { "type": "array", "items": { "type": "string" } } } } } } }, "responses": { "201": { "description": "Agent registered with API key" } } } }, "/ai/agent/{agent_id}/trust": { "get": { "summary": "Agent Trust Status", "description": "Current trust status: reputation score (0-100), tier (EXEMPLARY/TRUSTED/STANDARD/DEGRADED/RESTRICTED), key expiry, rate governance, request statistics.", "tags": [ "Agent Trust Management" ], "parameters": [ { "name": "agent_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Agent trust status" }, "404": { "description": "Agent not found" } } } }, "/ai/agent/{agent_id}/rotate-key": { "post": { "summary": "Rotate Agent API Key", "description": "Rotate agent API key. Old key invalidated immediately. +5 reputation bonus. New 90-day lifecycle.", "tags": [ "Agent Trust Management" ], "requestBody": { "content": { "application/json": { "schema": { "type": "object", "required": [ "current_api_key" ], "properties": { "current_api_key": { "type": "string" } } } } } }, "responses": { "200": { "description": "New API key with reputation update" } } } }, "/ai/agent/leaderboard": { "get": { "summary": "Agent Reputation Leaderboard", "description": "Top agents ranked by reputation score with ecosystem statistics.", "tags": [ "Agent Trust Management" ], "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20 } } ], "responses": { "200": { "description": "Agent leaderboard and ecosystem stats" } } } }, "/verify/sdk": { "get": { "summary": "Validation SDK Info", "description": "SDK installation instructions, supported languages (Python available, TS/Rust/Go planned), and 7 verification checks.", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "SDK info and check descriptions" } } } }, "/verify/self-test": { "get": { "summary": "SDK Self-Test", "description": "Run live self-test: generates evidence, verifies with SDK (7 checks: hash, JWS, key, freshness, schema, SLA confidence, SLA freshness).", "tags": [ "Enterprise Trust Layer" ], "responses": { "200": { "description": "Self-test result with per-check status" } } } }, "/mcp/register": { "post": { "tags": [ "MCP Auth" ], "summary": "Dynamic Client Registration (RFC 7591)", "description": "Register an M2M client. Pass grant_types=[\"client_credentials\"] for agent use.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "client_name": { "type": "string" }, "grant_types": { "type": "array", "items": { "type": "string" }, "example": [ "client_credentials" ] }, "redirect_uris": { "type": "array", "items": { "type": "string" } }, "scope": { "type": "string", "example": "mcp:read" } }, "required": [ "client_name", "grant_types", "redirect_uris" ] } } } }, "responses": { "201": { "description": "Client registered", "content": { "application/json": { "schema": { "type": "object", "properties": { "client_id": { "type": "string" }, "client_secret": { "type": "string" }, "grant_types": { "type": "array", "items": { "type": "string" } } } } } } } } } }, "/mcp/token": { "post": { "tags": [ "MCP Auth" ], "summary": "OAuth 2.0 Token (client_credentials + authorization_code)", "description": "Issue Bearer token. For M2M: grant_type=client_credentials, no browser required.", "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "grant_type": { "type": "string", "enum": [ "client_credentials", "authorization_code", "refresh_token" ] }, "client_id": { "type": "string" }, "client_secret": { "type": "string" }, "scope": { "type": "string" }, "code": { "type": "string", "description": "For authorization_code flow only" } }, "required": [ "grant_type" ], "example": { "grant_type": "client_credentials", "client_id": "fo_client_abc123", "client_secret": "fo_secret_xyz", "scope": "mcp:read" } } } } }, "responses": { "200": { "description": "Bearer token", "content": { "application/json": { "schema": { "type": "object", "properties": { "access_token": { "type": "string" }, "token_type": { "type": "string", "example": "Bearer" }, "expires_in": { "type": "integer", "example": 3600 }, "tier": { "type": "string" } }, "example": { "access_token": "fo_cc_...", "token_type": "Bearer", "expires_in": 3600, "tier": "free" } } } } } } } }, "/mcp/revoke": { "post": { "tags": [ "MCP Auth" ], "summary": "Token Revocation (RFC 7009)", "description": "Revoke an access token. Returns HTTP 200 + empty body on success (RFC 7009).", "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "client_id": { "type": "string" }, "client_secret": { "type": "string" } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "Revoked (empty body)" } } } }, "/mcp/sse": { "get": { "tags": [ "MCP Transport" ], "summary": "Compliance MCP \u2014 SSE stream (18 tools)", "description": "Server-Sent Events transport. Connect with Bearer token. Tools: MiCA, DORA, RWA, stablecoin risk.", "security": [ { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "SSE stream \u2014 session_id in first event" } } } }, "/mcp/messages": { "post": { "tags": [ "MCP Transport" ], "summary": "Compliance MCP \u2014 JSON-RPC message endpoint", "description": "Send JSON-RPC 2.0 messages to active SSE session.", "parameters": [ { "name": "session_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "security": [ { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string", "example": "2.0" }, "id": { "type": "integer" }, "method": { "type": "string", "example": "tools/call" }, "params": { "type": "object" } } } } } }, "responses": { "202": { "description": "Accepted \u2014 result delivered via SSE" } } } }, "/mcp/risk/sse": { "get": { "tags": [ "MCP Transport" ], "summary": "Stablecoin Risk MCP \u2014 SSE stream (13 tools)", "description": "Risk intelligence tools: SAFE/CAUTION/AVOID assessments, peg monitoring, reserve analysis.", "security": [ { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "SSE stream" } } } }, "/mcp/macro/sse": { "get": { "tags": [ "MCP Transport" ], "summary": "Macro Economic Oracle MCP \u2014 SSE stream (13 tools)", "description": "FRED-sourced macro data, ECB rates, yield curves, on-chain anchoring.", "responses": { "200": { "description": "SSE stream \u2014 public, no auth required" } } } }, "/api/billing/register": { "post": { "tags": [ "Billing" ], "summary": "Free API key \u2014 no credit card, no browser", "description": "Self-service registration. Returns API key immediately. 500 welcome units, no credit card required.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string" } }, "required": [ "email" ] } } } }, "responses": { "200": { "description": "API key issued", "content": { "application/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string", "example": "fo_f_..." }, "tier": { "type": "string", "example": "free" } } } } } } } } }, "/verify": { "get": { "tags": [ "Signature Verification" ], "summary": "Public ES256K signature verification guide", "description": "Returns step-by-step instructions to independently verify any MCP response signature using public JWKS. No FeedOracle trust required.", "parameters": [ { "name": "rid", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional request_id for context" } ], "responses": { "200": { "description": "Verification instructions", "content": { "application/json": { "schema": { "type": "object", "example": { "algorithm": "ES256K", "jwks_url": "https://feedoracle.io/.well-known/jwks.json", "kid": "feedoracle-mcp-es256k-1", "steps": [ "1. Fetch JWKS", "2. Remove signature+verify_url from payload", "3. JSON.stringify sorted", "4. Verify ES256K sig" ] } } } } } } } }, "/feedoracle_agent_verify.py": { "get": { "tags": [ "Verification" ], "summary": "Public agent journey verification script", "description": "Executable Python script. Runs 38 independent checks against all public endpoints. No server access required. pip install cryptography && python3 feedoracle_agent_verify.py", "responses": { "200": { "description": "Python script (text/plain)" } } } }, "/.well-known/oauth-authorization-server": { "get": { "tags": [ "Discovery" ], "summary": "OAuth 2.0 Authorization Server Metadata (RFC 8414)", "description": "Discover token_endpoint, registration_endpoint, revocation_endpoint, grant_types_supported.", "responses": { "200": { "description": "OAuth metadata" } } } }, "/.well-known/oauth-protected-resource": { "get": { "tags": [ "Discovery" ], "summary": "OAuth Protected Resource Metadata", "description": "x_feedoracle_upgrade (pricing, USDC, M2M paths) + x_feedoracle_evidence (ES256K, JWKS).", "responses": { "200": { "description": "Resource metadata" } } } }, "/.well-known/jwks.json": { "get": { "tags": [ "Discovery" ], "summary": "JSON Web Key Set \u2014 public signing keys", "description": "Contains feedoracle-mcp-es256k-1 (ES256K/secp256k1) for independent MCP response verification.", "responses": { "200": { "description": "JWKS" } } } }, "/.well-known/mcp/server-card.json": { "get": { "tags": [ "Discovery" ], "summary": "MCP Server Card \u2014 agent self-service metadata", "description": "Machine-readable service description: tools, auth, upgrade paths, rate-limit signals.", "responses": { "200": { "description": "Server card" } } } }, "/mcp/kya/register": { "post": { "summary": "Register AI agent identity (KYA)", "description": "Register agent metadata (name, purpose, org) to receive trust score and access level. Required for trust-gated tools.", "tags": [ "KYA - Know Your Agent" ], "operationId": "kya_register", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "agent_name": { "type": "string" }, "agent_purpose": { "type": "string" }, "owner_email": { "type": "string" }, "owner_org": { "type": "string" }, "owner_jurisdiction": { "type": "string" }, "risk_appetite": { "type": "string", "enum": [ "conservative", "moderate", "aggressive" ] } }, "required": [ "agent_name", "agent_purpose", "owner_email", "owner_org" ] } } } }, "responses": { "200": { "description": "Agent registered with trust score and access level" } } } }, "/mcp/kya/status": { "get": { "summary": "Check agent KYA trust status", "description": "Returns trust level, score breakdown, and which tools are accessible.", "tags": [ "KYA - Know Your Agent" ], "operationId": "kya_status", "parameters": [ { "name": "client_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Trust status with score and tool access" } } } }, "/mcp/audit/log": { "post": { "summary": "Log a compliance decision to tamper-proof audit trail", "description": "Creates chain-linked audit entry with evidence snapshots. Returns trail_id and chain_hash.", "tags": [ "Audit Trail" ], "operationId": "audit_log", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "PASS", "BLOCK", "WARN", "HOLD" ] }, "evidence_request_ids": { "type": "array", "items": { "type": "string" } }, "reasoning": { "type": "string" }, "target_asset": { "type": "string" }, "jurisdiction": { "type": "string", "default": "EU" } }, "required": [ "decision", "evidence_request_ids", "reasoning" ] } } } }, "responses": { "200": { "description": "Audit entry with trail_id and chain_hash" } } } }, "/mcp/audit/query": { "get": { "summary": "Query audit trail decision history", "description": "Returns chain-linked decision log with evidence snapshots.", "tags": [ "Audit Trail" ], "operationId": "audit_query", "parameters": [ { "name": "client_id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "target_asset", "in": "query", "schema": { "type": "string" } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 20 } } ], "responses": { "200": { "description": "Decision history with chain hashes" } } } }, "/mcp/audit/verify": { "get": { "summary": "Verify audit trail chain integrity", "description": "Cryptographic verification of chain hash linkage. Returns valid/invalid with break point.", "tags": [ "Audit Trail" ], "operationId": "audit_verify", "parameters": [ { "name": "client_id", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Chain integrity result" } } } }, "/mcp/evidence/bundle": { "get": { "summary": "Multi-framework evidence bundle (single call)", "description": "Aggregates evidence across MiCA, DORA, RWA, macro, stablecoin_risk frameworks. Returns signed bundle with pack_id.", "tags": [ "Evidence" ], "operationId": "evidence_bundle", "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "frameworks", "in": "query", "schema": { "type": "string", "default": "mica,macro" } } ], "responses": { "200": { "description": "Signed evidence bundle" } } } }, "/mcp/evidence/leaderboard": { "get": { "summary": "Evidence-graded protocol leaderboard", "description": "Top protocols ranked by evidence grade A-F across 61 RWA protocols & 105+ stablecoins.", "tags": [ "Evidence" ], "operationId": "evidence_leaderboard", "parameters": [ { "name": "limit", "in": "query", "schema": { "type": "integer", "default": 10 } } ], "responses": { "200": { "description": "Ranked leaderboard with grades" } } } }, "/mcp/evidence/profile": { "get": { "summary": "Multi-dimensional evidence profile", "description": "Governance, custody, reserves, market depth dimensions for an asset.", "tags": [ "Evidence" ], "operationId": "evidence_profile", "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Evidence profile with dimension scores" } } } }, "/mcp/market/liquidity": { "get": { "summary": "DEX liquidity depth & exit channel analysis", "description": "Stablecoin-specific liquidity analysis across DEXs.", "tags": [ "Market Risk" ], "operationId": "market_liquidity", "parameters": [ { "name": "symbol", "in": "query", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Liquidity depth analysis" } } } }, "/mcp/trust-policy": { "get": { "summary": "Trust Policy v1.0", "description": "Machine-readable trust policy defining data sourcing, signing, verification, and SLA commitments.", "tags": [ "Trust" ], "operationId": "trust_policy", "responses": { "200": { "description": "Trust policy document" } } } }, "/wallet/balance": { "get": { "summary": "Check wallet balance", "description": "Returns current unit balance for the authenticated API key.", "tags": [ "Wallet" ], "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "Balance returned" }, "401": { "description": "Invalid or missing API key" } } } }, "/wallet/packages": { "get": { "summary": "List available packages", "description": "Returns all available unit packages with pricing in EUR.", "tags": [ "Wallet" ], "responses": { "200": { "description": "Package list returned" } } } }, "/wallet/pricing": { "get": { "summary": "Full pricing table", "description": "Returns complete pricing table with monthly and annual packages.", "tags": [ "Wallet" ], "responses": { "200": { "description": "Pricing table returned" } } } }, "/wallet/stripe/checkout": { "post": { "summary": "Create Stripe checkout session", "description": "Creates a Stripe checkout session for purchasing a unit package. Redirects to Stripe.", "tags": [ "Wallet" ], "security": [ { "ApiKeyAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "package": { "type": "string", "enum": [ "starter", "growth", "pro", "enterprise", "starter_annual", "growth_annual", "pro_annual", "enterprise_annual" ], "description": "Package to purchase" } }, "required": [ "package" ] } } } }, "responses": { "302": { "description": "Redirect to Stripe checkout" }, "401": { "description": "Invalid API key" } } } }, "/guard/mcp": { "post": { "tags": [ "AgentGuard" ], "summary": "AgentGuard MCP Server (20 tools)", "description": "JSON-RPC 2.0 MCP endpoint. Methods: initialize, tools/list, tools/call. Tools include policy_preflight, tool_risk_score, output_safety_scan, emergency_kill, tool_manifest_verify, and 15 more. Bearer token required for non-public tools.", "operationId": "agentguardMcp", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "jsonrpc": { "type": "string", "example": "2.0" }, "id": { "type": "integer", "example": 1 }, "method": { "type": "string", "enum": [ "initialize", "tools/list", "tools/call" ] }, "params": { "type": "object" } } } } } }, "responses": { "200": { "description": "MCP JSON-RPC response" }, "401": { "description": "Bearer token required" } }, "security": [ { "bearerAuth": [] } ] } }, "/guard/health": { "get": { "tags": [ "AgentGuard" ], "summary": "AgentGuard health check", "operationId": "agentguardHealth", "responses": { "200": { "description": "Server status with tool count, uptime, DB stats" } } } }, "/ampel/mcp/": { "post": { "tags": [ "DORA Ampel" ], "summary": "DORA AmpelOracle MCP endpoint (49 tools)", "description": "DORA compliance traffic-light system via MCP protocol. Tools: readiness_check, assess_all, onboard_entity, bridge_resolve, gap_report, generate_report, audit_trail, freshness_check. AgentGuard-integrated.", "operationId": "doraAmpelMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/mica-ampel/mcp/": { "post": { "tags": [ "MiCA Ampel" ], "summary": "MiCA AmpelOracle MCP endpoint (24 tools)", "description": "MiCA stablecoin compliance via MCP protocol. Tools: readiness_check, assess_token, assess_entity, validate_whitepaper, insider_escalation, stor_workflow, generate_report. 17 tokens, 13 issuers.", "operationId": "micaAmpelMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/aml-oracle/mcp/": { "post": { "tags": [ "AML Oracle" ], "summary": "AML Oracle MCP endpoint (12 tools)", "description": "Sanctions screening (EU FSF, OFAC SDN, UN SC, Interpol), PEP checks, KYC bundles, adverse media, country risk, transaction risk scoring. 87k+ watchlist entries.", "operationId": "amlOracleMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/guard-oracle/mcp/": { "post": { "tags": [ "AgentGuard" ], "summary": "AgentGuard MCP endpoint (20 security tools)", "description": "Runtime security for AI agent workflows. Policy preflight, output safety scan, audit logging, emergency kill, rate limiting, scope checking. Agent states: active/monitoring/approval_required/suspended/killed.", "operationId": "agentGuardMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/research-oracle/mcp/": { "post": { "tags": [ "ResearchOracle" ], "summary": "ResearchOracle MCP (11 tools) \u2014 200M+ papers, arXiv, Crossref", "operationId": "researchOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/eulaw-oracle/mcp/": { "post": { "tags": [ "EULawOracle" ], "summary": "EULawOracle MCP (8 tools) \u2014 12 EU regulations, article-level, cross-references", "operationId": "euLawOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/regwatch-oracle/mcp/": { "post": { "tags": [ "RegWatchOracle" ], "summary": "RegWatchOracle MCP (6 tools) \u2014 US Federal Register + EU RSS", "operationId": "regWatchOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/esma-oracle/mcp/": { "post": { "tags": [ "ESMAOracle" ], "summary": "ESMAOracle MCP (8 tools) \u2014 177 CASPs, authorization checks", "operationId": "esmaOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/macro/mcp/": { "post": { "tags": [ "MacroOracle" ], "summary": "MacroOracle MCP (22 tools) \u2014 FRED+ECB+WorldBank+BLS", "operationId": "macroOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/law/mcp/": { "post": { "tags": [ "LawOracle" ], "summary": "LawOracle MCP (20 tools) - Multi-jurisdiction legal intelligence", "description": "Multi-jurisdiction legal search, obligation mapping (DORA/MiCA/AMLR), article extraction, DORA OS bridge. Tools: multi_jurisdiction_search, obligation_search, obligation_trace, article_extract, federal_register_search, sec_filing_search, court_opinion_search, congress_bill_search, regulations_gov_search, eurlex_search, uk_legislation_search, de_law_list, de_law_lookup, sec_company_filings, federal_register_document, congress_bill_detail, uk_act_content, jurisdiction_list, health_check, ping.", "operationId": "lawOracleMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/law/health": { "get": { "tags": [ "LawOracle" ], "summary": "LawOracle health check", "operationId": "lawOracleHealth", "responses": { "200": { "description": "Server status with tool count" } } } }, "/test/mcp/": { "post": { "tags": [ "TestOracle" ], "summary": "TestOracle MCP (16 tools) \u2014 DORA Resilience Testing", "description": "Art. 24-27 testing management: create_test_programme, register_test, scenario_library, tlpt_status, tester_qualification, test_coverage, sync_to_ampel, evidence_pack, obligation_map.", "operationId": "testOracleMcp", "responses": { "200": { "description": "MCP JSON-RPC response" } } } }, "/test/health": { "get": { "tags": [ "TestOracle" ], "summary": "TestOracle health check", "operationId": "testOracleHealth", "responses": { "200": { "description": "Server status" } } } }, "/reporting/mcp/": { "post": { "tags": [ "ReportingOracle" ], "summary": "ReportingOracle MCP (14 tools)", "operationId": "reportingOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/reporting/health": { "get": { "tags": [ "ReportingOracle" ], "summary": "ReportingOracle health", "operationId": "reportingOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/cloud/mcp/": { "post": { "tags": [ "CloudOracle" ], "summary": "CloudOracle MCP (14 tools)", "operationId": "cloudOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/cloud/health": { "get": { "tags": [ "CloudOracle" ], "summary": "CloudOracle health", "operationId": "cloudOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/training/mcp/": { "post": { "tags": [ "TrainingOracle" ], "summary": "TrainingOracle MCP (13 tools) \u2014 DORA ICT Security Training", "operationId": "trainingOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/training/health": { "get": { "tags": [ "TrainingOracle" ], "summary": "TrainingOracle health", "operationId": "trainingOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/policy/mcp/": { "post": { "tags": [ "PolicyOracle" ], "summary": "PolicyOracle MCP (12 tools) \u2014 DORA ICT Policy Governance", "operationId": "policyOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/policy/health": { "get": { "tags": [ "PolicyOracle" ], "summary": "PolicyOracle health", "operationId": "policyOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/conductor/mcp/": { "post": { "tags": [ "DORA OS Conductor" ], "summary": "DORA OS Conductor (16 tools) \u2014 Master Orchestrator", "operationId": "conductorMcp", "responses": { "200": { "description": "MCP response" } } } }, "/conductor/health": { "get": { "tags": [ "DORA OS Conductor" ], "summary": "Conductor health + oracle availability", "operationId": "conductorHealth", "responses": { "200": { "description": "Status" } } } }, "/drift/mcp/": { "post": { "tags": [ "DriftOracle" ], "summary": "DriftOracle MCP (14 tools) \u2014 Self-Healing Drift Detection", "operationId": "driftOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/drift/health": { "get": { "tags": [ "DriftOracle" ], "summary": "DriftOracle health", "operationId": "driftOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/eventfabric/mcp/": { "post": { "tags": [ "EventFabric" ], "summary": "EventFabric MCP (14 tools)", "operationId": "eventFabricMcp", "responses": { "200": { "description": "MCP response" } } } }, "/eventfabric/health": { "get": { "tags": [ "EventFabric" ], "summary": "EventFabric health", "operationId": "eventFabricHealth", "responses": { "200": { "description": "Status" } } } }, "/predict/mcp/": { "post": { "tags": [ "PredictOracle" ], "summary": "PredictOracle MCP (12 tools) \u2014 Predictive Risk", "operationId": "predictOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/predict/health": { "get": { "tags": [ "PredictOracle" ], "summary": "PredictOracle health", "operationId": "predictOracleHealth", "responses": { "200": { "description": "Status" } } } }, "/zk/mcp/": { "post": { "tags": [ "ZKEvidenceOracle" ], "summary": "ZKEvidenceOracle MCP (14 tools)", "operationId": "zkOracleMcp", "responses": { "200": { "description": "MCP response" } } } }, "/zk/health": { "get": { "tags": [ "ZKEvidenceOracle" ], "summary": "ZK health", "operationId": "zkOracleHealth", "responses": { "200": { "description": "Status" } } } } } }