FeedOracle Compliance Agent

[GATEWAY|AUDIT] Full cryptographic provenance chain for an asset's evidence data. Traces every data point from external source (FRED series ID, ESMA register, CoinGecko, on-chain) through FeedOracle processing to final bundle. Each node individually SHA256-hashed. Chain hash = merkle-style hash of all nodes. Tamper-proof audit trail for EU AI Act explainability + MiCA evidence requirements. Returns: series_ids, providers, external_sources, per-node hashes, chain_hash.

[GATEWAY] Natural language evidence query. Routes any plain-English question to the correct FeedOracle evidence APIs automatically. Two-tier classifier: regex (fast) + DeepSeek LLM fallback for complex queries. Returns signed evidence bundle (SHA256 + pack_id). No hallucinations — data from verified FeedOracle APIs. Examples: IsUSDS MiCA compliant? / What is recession risk? / Evaluate EURC for treasury.

Log a decision your agent made, linking it to evidence from prior tool calls. Creates a tamper-proof, chain-linked audit entry. Pass request_ids from prior tool calls to snapshot the evidence basis. Regulators can verify the chain. Returns trail_id and chain_hash.

Query your agent's audit trail history. Returns chain-linked decision log with evidence snapshots. Filter by asset or decision type. Use audit_verify to check chain integrity.

Cryptographically verify that an agent's audit trail has not been tampered with. Checks chain hash linkage from genesis to head. Returns valid/invalid with break point if tampered.

Pre-flight regulatory check. Returns PASS/WARN/BLOCK with reason_codes, sources, confidence. Not legal advice.

Custody & counterparty risk assessment. SIFI status, concentration risk. DORA Art.28 relevant.

Detect anomalous behavior patterns for an AI agent: unusual call frequency, new tools never used before, calls outside normal hours, sudden risk score changes, repeated failures. Returns list of anomalies with severity and timestamps.

Open a fraud/abuse investigation case for a suspicious AI agent. Records evidence summary, suspicion reasons, and recommended actions. Creates an immutable case record for audit purposes.

Human-readable explanation of why an AI agent is considered suspicious. Combines fraud score, anomalies, policy violations, and case history into a clear narrative. Essential for transparent AI governance and regulatory reporting.

Compute a fraud/suspicion score (0-100) for an AI agent based on behavioral analysis: failed call ratio, denied decisions, scope escalation attempts, burst patterns, and policy violations. Higher score = more suspicious. Part of DetectiveOracle — the forensic layer for AI agent ecosystems.

Analyze an agent and recommend whether quarantine is needed. Evaluates fraud score, anomaly count, policy violations, and state history. Returns recommendation (clear/monitor/quarantine/suspend) with confidence and reasoning.

MiCA Art. 29/30 (ART): recovery & redemption plans. Art. 55 (EMT): annual independent audit. Returns compliance score 0-100, audit freshness, plan status, and any stale/missing document alerts.

[GATEWAY|KEY] Single-call multi-framework evidence aggregation. Fetches MiCA, DORA, RWA, Macro and Stablecoin Risk evidence in one signed bundle. Returns FO-EVB-* bundle ID + SHA256 hash + per-framework status. Enterprise due diligence in one call. frameworks: mica, dora, rwa, macro, stablecoin_risk (or 'all'). Replaces 23 individual API calls.

Top protocols ranked by evidence grade A-F across 61 RWA protocols & 105+ stablecoins.

Multi-dimensional evidence profile: governance, custody, reserves, market depth. Grade A-F.

[HEAVY|KEY] Generate a signed, XRPL-anchored PDF compliance report. Creates a new document. Requires API key for Professional/Enterprise tiers.

MiCA Art. 23 (ART) / Art. 52 (EMT): scans for issuer-native yield mechanisms. Issuers are prohibited from paying interest to token holders. Returns risk level NONE/LOW/MEDIUM/HIGH with explanation.

Register your AI agent's identity and purpose to unlock trust-gated tools. Provide agent metadata (name, purpose, org, jurisdiction) to receive a trust score and access level. Higher trust = more tools. Required for evidence_bundle, generate_report, mica_full_pack, ai_provenance, ai_explain.

Check your agent's current KYA trust level, score breakdown, and tool access. Shows which tools are available at your trust level and what to do to unlock more.

US macro risk composite from 86 FRED economic series.

DEX liquidity depth & exit channel analysis. MiCA Art.45 relevant.

Live gold spot price USD/oz with evidence signature. Includes 24h change % and linked RWA tokens PAXG and XAUT for MiCA reserve asset evaluation. MiCA Art.36 relevant.

Live gold (XAU) and silver (XAG) prices in one evidence-signed call. USD/oz with 24h change. Useful for RWA reserve asset valuation and gold-backed stablecoin compliance.

Live silver spot price USD/oz with evidence signature and 24h change %.

[HEAVY|KEY] Complete MiCA compliance evidence for one token (12 MiCA articles). Aggregates: Art. 35 peg + Art. 45/58 significant + Art. 23/52 interest + Art. 29/30/55 documents + Art. 24/25/53 reserves. Returns overall_mica_compliant flag and compliance_flags list. Ideal for due diligence.

[HEAVY|KEY] Full MiCA market status: peg alerts, significant issuers, interest prohibition violations, stale audits, reserve violations, issuer revenue flags. Best entry point for compliance monitoring dashboards.

MiCA EU authorization status. Cross-referenced with ESMA/EBA registers.

Real-time peg deviation for any stablecoin. MiCA Art. 35: issuers must maintain peg at all times. Returns deviation %, status (STABLE/WARN/ALERT/CRITICAL), 30-day history summary.

30-day peg deviation history for a stablecoin. MiCA Art. 35 requires continuous peg maintenance. Returns daily deviation, max/min/avg, stability score 0-100, and depeg event count.

Quick connectivity test. Returns server version, uptime, and available tool count. No auth required.

Explains WHY an agent action was blocked or flagged by AgentGuard. Provide the tool name and optional context to get a human-readable explanation of which policies matched, what risk level was assigned, and what the agent can do to proceed. Essential for transparent AI governance.

Machine-readable pricing information for any FeedOracle tool. Returns unit cost, tier requirements, free tier availability, and estimated EUR cost. Use this before calling paid tools to check budget. Enables autonomous agent budget management.

MiCA Art. 24/25 (ART): reserve management policy. Art. 53 (EMT): 100%% in deposits or highly liquid low-risk assets. Returns Art. 53 eligibility %%, liquidity score, asset mix, and any violations.

RLUSD real-time integrity monitoring & attestation verification.

MiCA Art. 45 (ART) / Art. 58 (EMT): checks if issuer exceeds €5B reserve threshold. Significant issuers require EBA oversight and 3% own-funds. Returns threshold%, days-to-significant projection, and additional obligations.

Recent changes, new tools, deprecations, and breaking changes in the FeedOracle ecosystem. Agents check this to adapt to API changes. Returns version history with migration notes.

AI agent describes a problem it's experiencing, and SupportOracle diagnoses the cause and provides a machine-readable fix. Covers: authentication errors, 402 payment required, tool not found, timeout, rate limiting, parameter errors. The self-healing layer for the agent ecosystem.

Machine-readable explanation of any HTTP error code in the FeedOracle ecosystem. Returns cause, fix steps, related tools, and whether the error is transient or permanent. Agents call this to understand what went wrong and auto-recover.

Comprehensive health check of all FeedOracle and ToolOracle services. Tests every MCP endpoint, checks response times, verifies signing keys, and returns a traffic-light status for each service. The agent's first call when something seems wrong.

List of current known issues, bugs, and their workarounds. Agents check this before filing a support ticket. Includes severity, affected tools, workaround steps, and expected resolution time.

Step-by-step onboarding guide for new AI agents joining the FeedOracle ecosystem. Returns the optimal sequence of first calls, registration steps, and how to unlock all capabilities. The welcome mat for autonomous agents.

Open a persistent support ticket for an issue that cannot be auto-resolved. Records the problem, affected tool, error details, and agent context. Returns a ticket ID for tracking. Tickets are reviewed and resolved by the system or operators.

Check the status of a previously opened support ticket. Returns current status, resolution notes, and estimated fix time.

Fetch latest ZK solvency attestation from Polygon contract 0x3a0A7f28a7fcA960D6f727Ba9914187948ceB3a6. Returns threshold_passed, min_ratio_bps, age_seconds, bound snapshot hash, Polygonscan link.

Generate a Zero-Knowledge proof that reserve ratio exceeds a threshold — without revealing exact amounts. Bound to latest on-chain RLUSD snapshot. MiCA Art.36 / DORA Art.28. Circuit: reserve_guard_v1 on Polygon. Returns proof hash, public inputs, snapshot binding.

Verify the latest generated ZK solvency proof cryptographically via Noir circuit verifier. Returns valid/invalid and verifier version.