{
  "x402Version": 2,
  "name": "ToolOracle / FeedOracle x402 Payment Gateway",
  "description": "16 paid endpoints discoverable on the Coinbase x402 Bazaar. Compliance, blockchain risk, agent safety, prediction-market integrity. Pay per call in USDC on Base.",
  "network": "eip155:8453",
  "currency": "USDC",
  "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "payTo": "0x11f591C3496C0632e7B173184f5Bc71dC941125D",
  "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
  "discovery": {
    "bazaar_search": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/search?query=tooloracle",
    "gateway_manifest": "https://tooloracle.io/v2/.well-known/x402",
    "agent_descriptions": "https://tooloracle.io/.well-known/agent-descriptions"
  },
  "endpoints": [
    {
      "path": "/v2/agent_preflight",
      "method": "POST",
      "price": "$0.005",
      "category": "agent-safety",
      "summary": "AI agent decision pre-flight: GO / CAUTION / STOP with cryptographic receipt.",
      "inputSchema": {
        "intent": {
          "type": "string",
          "description": "Description of what the agent wants to do",
          "required": true
        },
        "context": {
          "type": "object",
          "description": "Optional agent context (agent_id, session_id, etc.)",
          "required": false
        }
      },
      "sample_input": {
        "intent": "transfer 1000 EUR to wallet 0xabc..."
      },
      "sample_output": {
        "verdict": "go",
        "cost_units": 1,
        "evidence": []
      },
      "description": "AI agent decision pre-flight + action audit + autonomous safety — should agent X execute action Y? Combined check: evidence freshness, provenance trace, policy gate, risk scoring, hallucination signals. Returns GO / CAUTION / STOP / INSUFFICIENT_EVIDENCE with cryptographic receipt. For autonomous agent workflows: tool calls, financial transactions, content publishing, regulatory submissions, multi-step task execution, agent compliance evidence, MCP gateway routing.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/cve_lookup",
      "method": "POST",
      "price": "$0.005",
      "category": "security",
      "summary": "NIST NVD + CISA KEV vulnerability search by keyword, vendor, product, or CVE ID.",
      "inputSchema": {
        "keyword": {
          "type": "string",
          "description": "Search keyword, vendor, or product name",
          "required": true
        },
        "limit": {
          "type": "integer",
          "description": "Max results (default 10, max 50)",
          "required": false
        }
      },
      "sample_input": {
        "keyword": "openssl",
        "limit": 5
      },
      "sample_output": {
        "cves": [
          {
            "id": "CVE-2024-XXXX",
            "cvss": 9.8,
            "kev": true
          }
        ]
      },
      "description": "CVE lookup + vulnerability check + threat intelligence — search NIST NVD + CISA KEV (Known Exploited Vulnerabilities) by keyword, vendor, product, or CVE ID. Returns CVSS score, severity rating, exploitability, MITRE ATT&CK technique mapping. For security agents, threat intelligence, EU DORA ICT risk assessment, NIS2 vendor due diligence, supply chain security audit, SOC2 evidence, ISO 27001 gap analysis.",
      "example_type": "verified_fixture"
    },
    {
      "path": "/v2/uvo_quick",
      "method": "POST",
      "price": "$0.005",
      "category": "agent-safety",
      "summary": "UVO Action Gate: 9-layer deterministic validation, sub-100ms APPROVE/WARN/ESCALATE/BLOCK.",
      "inputSchema": {
        "proposal": {
          "type": "object"
        }
      },
      "sample_input": {
        "proposal": {
          "action_type": "send_email",
          "target": "user@example.com",
          "content": "..."
        }
      },
      "sample_output": {
        "verdict": "APPROVE",
        "risk_score": 0.12,
        "layers": {
          "schema": "PASS",
          "danger": "PASS"
        }
      },
      "description": "UVO Action Gate — fast deterministic validation. Returns APPROVE/WARN/ESCALATE/BLOCK with risk_score for any agent action proposal. Sub-100ms response. 9-layer pipeline (schema, danger patterns, citations, containment, reversibility, measurability, commitment, existence, hallucination).",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/compliance_preflight",
      "method": "POST",
      "price": "$0.01",
      "category": "compliance",
      "summary": "MiCA stablecoin compliance preflight — PASS/WARN/BLOCK + grade A-F + live ESMA status for one stablecoin token.",
      "inputSchema": {
        "token": {
          "type": "string",
          "required": true,
          "description": "Stablecoin symbol e.g. USDC, USDT, EURC, RLUSD, DAI"
        },
        "issuer": {
          "type": "string",
          "description": "Optional issuer e.g. Circle, Tether, Ripple"
        }
      },
      "sample_input": {
        "token": "USDC"
      },
      "sample_output": {
        "verdict": "PASS",
        "score": 87.4,
        "grade": "A",
        "mica_status": "AUTHORIZED",
        "signed": true
      },
      "description": "EU stablecoin MiCA pre-flight verdict (PASS/WARN/BLOCK) with grade A-F and live ESMA authorization status. Supports USDC, USDT, EURC, RLUSD, DAI and 40+ stablecoins. Required EU regulatory due diligence for CASPs, exchanges, payment & e-money agents.",
      "example_type": "illustrative",
      "status": "live",
      "value_prop": "Check a token before interacting: receive a machine-readable PASS/WARN/BLOCK compliance preflight for $0.01."
    },
    {
      "path": "/v2/macro_snapshot",
      "method": "POST",
      "price": "$0.01",
      "category": "finance",
      "summary": "US macro snapshot: Fed funds, CPI, PPI, yield curve, unemployment, GDP, housing, sentiment.",
      "inputSchema": {},
      "sample_input": {},
      "sample_output": {
        "fed_funds": 4.5,
        "cpi_yoy": 2.7,
        "yield_10y_2y": 0.45,
        "unemployment": 4.1
      },
      "description": "US macro economic snapshot + trading signals + market data — Fed funds rate, CPI inflation, PPI, yield curve (10Y-2Y spread), unemployment, GDP growth, housing index, consumer sentiment in single API call. Real-time from FRED + BLS + BEA. For trading agents, risk models, portfolio rebalancing, economic forecasting, market commentary, research workflows, autonomous treasury management, DeFi macro hedging.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/mica_stablecoin_check",
      "method": "POST",
      "price": "$0.01",
      "category": "compliance",
      "summary": "MiCA full Ampel check across 12 articles + grade A-F. USDC, USDT, EURC, RLUSD, DAI, 40+ stables.",
      "inputSchema": {
        "token": {
          "type": "string",
          "description": "Stablecoin symbol (USDC, USDT, EURC, RLUSD, DAI, etc.)",
          "required": true
        },
        "issuer": {
          "type": "string",
          "description": "Optional issuer name (Circle, Tether, Ripple, etc.)",
          "required": false
        }
      },
      "sample_input": {
        "token": "USDC",
        "issuer": "Circle"
      },
      "sample_output": {
        "verdict": "PASS",
        "score": 87.4,
        "grade": "A",
        "mica_status": "AUTHORIZED"
      },
      "description": "EU stablecoin MiCA compliance audit + regulatory readiness — full Ampel traffic-light check (RED/YELLOW/GREEN) across all 12 MiCA articles (Title III EMT + Title IV ART). Grade A-F + live ESMA authorization status. Supports USDC, USDT, EURC, RLUSD, DAI, FDUSD, PYUSD and 40+ stablecoins. Required regulatory due diligence for CASPs, EU exchanges, payment service providers, e-money institutions, fintech agents. BaFin / ESMA / AMF / FINMA / CySEC aligned. July 2026 CASP deadline.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/orderbook_risk",
      "method": "POST",
      "price": "$0.01",
      "category": "market-integrity",
      "summary": "Kalshi orderbook fragility: thin liquidity, penny walls, single-order dominance scoring.",
      "inputSchema": {
        "ticker": {
          "type": "string",
          "description": "Kalshi market ticker (e.g. KXG7LEADEROUT-45JAN01-FMER)",
          "required": true
        }
      },
      "sample_input": {
        "ticker": "KXG7LEADEROUT-45JAN01-FMER"
      },
      "sample_output": {
        "score": 20,
        "severity": "LOW",
        "manipulation_flags": [
          {
            "signal": "penny_wall_pattern",
            "points": 20
          }
        ]
      },
      "description": "Detects thin liquidity, penny walls, spread risk, and fragile orderbook structures in Kalshi markets. Returns 0-100 manipulation-vulnerability score plus signal-level evidence: wide spread (>$0.10), shallow depth (<10 contracts), few price levels, single-order dominance (>80% in top level), penny-wall pattern (large bids at ≤$0.005, common in wash trading). For agents that need to detect fragile order books before placing orders.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/uvo_citation_check",
      "method": "POST",
      "price": "$0.01",
      "category": "agent-safety",
      "summary": "Citation/source validation: legal articles, statutes, DOIs against authoritative registers.",
      "inputSchema": {
        "citations": {
          "type": "array"
        }
      },
      "sample_input": {
        "citations": [
          "Art. 17 MiCA",
          "§ 823 BGB",
          "doi:10.1038/nature12373"
        ]
      },
      "sample_output": {
        "results": [
          {
            "citation": "Art. 17 MiCA",
            "verdict": "APPROVE",
            "title": "Application for authorisation"
          }
        ]
      },
      "description": "Verify legal & academic citations against authoritative sources. 448 EUR-Lex verified articles (MiCA 149, DSGVO 99, DORA 64, AMLR 90, NIS2 46) + Semantic Scholar + OpenAlex + German codes (BGB, KWG). Detects fake citations like 'Art. 999 MiCA' or 'doi:10.9999/fake-paper'.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/integrity_gate",
      "method": "POST",
      "price": "$0.02",
      "category": "market-integrity",
      "summary": "Pre-trade prediction-market gate: ALLOW/WARN/BLOCK + risk_level 0-100, ECDSA receipt. Polymarket + Kalshi.",
      "inputSchema": {
        "platform": {
          "type": "string",
          "description": "polymarket | kalshi",
          "required": true
        },
        "market_id": {
          "type": "string",
          "description": "Polymarket slug or Kalshi ticker",
          "required": true
        },
        "wallet": {
          "type": "string",
          "description": "Optional Polygon wallet (Polymarket)",
          "required": false
        },
        "candidate": {
          "type": "string",
          "description": "Optional candidate name for Kalshi Rule 5.17(z) match",
          "required": false
        },
        "amount_usd": {
          "type": "number",
          "description": "Optional bet size for risk amplification",
          "required": false
        }
      },
      "sample_input": {
        "platform": "kalshi",
        "market_id": "KXPRESNOMR-28",
        "candidate": "Marjorie Taylor Greene",
        "amount_usd": 5000
      },
      "sample_output": {
        "decision": "BLOCK",
        "risk_level": 81.1,
        "severity": "HIGH",
        "reason": "Rule 5.17(z) conflict-of-interest risk = 95 (CRITICAL)"
      },
      "description": "Pre-trade integrity gate for AI agents on prediction markets. ONE call returns ALLOW/WARN/BLOCK + risk_level 0-100 + sub-scores (market_integrity, liquidity, resolution, event_conflict) + risk_flags + ECDSA-signed evidence receipt. Supports Polymarket and Kalshi. Pattern-matches CFTC v. Van Dyke and Kalshi April 2026 disciplinary cases. The pre-trade question: is this market clean enough to touch?",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/meme_rug_check",
      "method": "POST",
      "price": "$0.02",
      "category": "blockchain-risk",
      "summary": "Memecoin rug-pull check across Base, Solana, ETH, BSC, Arbitrum, Polygon.",
      "inputSchema": {
        "token": {
          "type": "string",
          "description": "Token contract address (0x... or solana base58)",
          "required": true
        },
        "chain": {
          "type": "string",
          "description": "Chain: base, ethereum, solana, bsc, etc.",
          "required": false
        }
      },
      "sample_input": {
        "token": "0x1234...",
        "chain": "base"
      },
      "sample_output": {
        "risk_score": 0.23,
        "verdict": "LOW_RISK",
        "liquidity_locked": true
      },
      "description": "Memecoin rug-pull check + token risk assessment + scam detection — liquidity depth, holder concentration, contract age, volume patterns, LP lockup status, mint authority, honeypot detection. Multi-chain (Base, Solana, Ethereum, BSC, Arbitrum, Polygon). Live DexScreener + on-chain analysis. For DeFi trading agents, copy-trading bots, alpha discovery, MEV protection, treasury due diligence, crypto safety screening, agent token validation.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/sanctions_screen",
      "method": "POST",
      "price": "$0.02",
      "category": "compliance",
      "summary": "Name screening: EU FSF (14k) + OFAC SDN (69k) + UN (3k) + UK HMT (4k).",
      "inputSchema": {
        "name": {
          "type": "string",
          "description": "Person or entity name to screen",
          "required": true
        },
        "country": {
          "type": "string",
          "description": "Optional ISO country code",
          "required": false
        },
        "dob": {
          "type": "string",
          "description": "Optional date of birth YYYY-MM-DD",
          "required": false
        }
      },
      "sample_input": {
        "name": "John Doe",
        "country": "RU"
      },
      "sample_output": {
        "hit": false,
        "matched_lists": [],
        "confidence": 0
      },
      "description": "Sanctions screening + AML compliance check — real-time name screening against EU FSF (14k entities), US OFAC SDN (69k), UN Security Council (3k), UK HMT (4k). Hit/no-hit verdict with entity details, confidence score, matched-list breakdown. For KYC, KYB, CDD, AML, transaction monitoring, agent payment pre-flight, payments compliance, regtech workflows. EU AMLR Art. 21 + FinCEN BSA + FATF Rec. 6 + BaFin GwG compliant.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/uvo_full",
      "method": "POST",
      "price": "$0.02",
      "category": "agent-safety",
      "summary": "UVO full pipeline + multi-model AI consensus on agent action proposals.",
      "inputSchema": {
        "proposal": {
          "type": "object"
        }
      },
      "sample_input": {
        "proposal": {
          "action_type": "publish",
          "content": "..."
        }
      },
      "sample_output": {
        "verdict": "WARN",
        "risk_score": 0.43,
        "ai_consensus": 0.71
      },
      "description": "UVO Action Gate — full validation with AI cross-check. Includes multi-model hallucination detection plus all 9 deterministic layers. ~2s response. Use for high-stakes actions where slower-but-thorough beats fast.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/candidate_conflict_check",
      "method": "POST",
      "price": "$0.05",
      "category": "market-integrity",
      "summary": "Kalshi self-interest risk detector — pattern-matches CFTC Rule 5.17(z) signals.",
      "inputSchema": {
        "ticker": {
          "type": "string",
          "description": "Kalshi market ticker",
          "required": false
        },
        "event_ticker": {
          "type": "string",
          "description": "Kalshi event ticker (need one)",
          "required": false
        },
        "candidate_name": {
          "type": "string",
          "description": "Optional name to match against market",
          "required": false
        }
      },
      "sample_input": {
        "event_ticker": "KXPRESNOMR-28",
        "candidate_name": "Marjorie Taylor Greene"
      },
      "sample_output": {
        "score": 95,
        "severity": "CRITICAL",
        "recommendation": "BLOCK — high CFTC Rule 5.17(z) exposure"
      },
      "description": "Detects candidate self-interest risk in Kalshi prediction markets. Pattern-matches CFTC Rule 5.17(z) signals: election/candidacy markets, named individuals, legislative or policy decisions, regulatory enforcement, sports outcomes. Calibrated against Kalshi April 2026 cases (Moran, Klein, Enriquez — all fined for trading own elections). Returns ALLOW/MONITOR/WARN/BLOCK + 0-100 score + reference cases.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/suspicious_timing_scan",
      "method": "POST",
      "price": "$0.05",
      "category": "market-integrity",
      "summary": "Polymarket pre-event flow scan: large positions, wallet-newness, coordinated timing.",
      "inputSchema": {
        "slug": {
          "type": "string",
          "description": "Polymarket market slug",
          "required": false
        },
        "market_id": {
          "type": "string",
          "description": "Or Polymarket conditionId",
          "required": false
        },
        "window_hours": {
          "type": "integer",
          "description": "Pre-event window in hours (default 72)",
          "required": false
        },
        "min_position_usd": {
          "type": "number",
          "description": "Min notional to flag (default $1000)",
          "required": false
        }
      },
      "sample_input": {
        "slug": "will-israel-launch-a-ground-operation-in-iran-by-may-31-2026",
        "window_hours": 72
      },
      "sample_output": {
        "score": 50,
        "severity": "MEDIUM",
        "window_trades_analyzed": 482
      },
      "description": "Suspicious-timing risk scan for Polymarket markets. Multi-signal scan: large pre-event positions, ratio of wallets new to this market, coordinated timing clusters, one-sided positioning, sensitive-keyword categories (military, regime change, intel, monetary policy). Returns 0-100 score, severity, triggered signals with evidence, top 5 positioners with new-wallet flags. Calibrated against publicly reported cases. Statistical signal only — not legal determination.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/uvo_academic_verify",
      "method": "POST",
      "price": "$0.10",
      "category": "agent-safety",
      "summary": "Academic citation verification: DOI lookup, author match, journal authenticity.",
      "inputSchema": {
        "citations": {
          "type": "array"
        }
      },
      "sample_input": {
        "citations": [
          {
            "doi": "10.1038/nature12373",
            "expected_authors": [
              "Author A"
            ]
          }
        ]
      },
      "sample_output": {
        "verdict": "APPROVE",
        "journal_authentic": true,
        "authors_match": true
      },
      "description": "Deep academic source verification with DOI resolution, journal authenticity (predatory-journal blocklist), and authorship cross-check via OpenAlex + Semantic Scholar. For high-stakes research output where one fake citation kills credibility.",
      "example_type": "illustrative"
    },
    {
      "path": "/v2/evidence_bundle",
      "method": "POST",
      "price": "$0.15",
      "category": "market-integrity",
      "summary": "Signed forensic dossier for Polymarket markets with JWS receipt anchored on Polygon.",
      "inputSchema": {
        "slug": {
          "type": "string",
          "description": "Polymarket market slug",
          "required": false
        },
        "market_id": {
          "type": "string",
          "description": "Or Polymarket conditionId",
          "required": false
        }
      },
      "sample_input": {
        "slug": "will-israel-launch-a-ground-operation-in-iran-by-may-31-2026"
      },
      "sample_output": {
        "evidence_bundle_signed_jws": "eyJhbGciOiJFUzI1NksifQ...",
        "content_hash": "sha256:..."
      },
      "description": "Generates a structured signed evidence bundle for prediction-market risk reviews. Returns a complete forensic dossier on one Polymarket market: market details, integrity scan, volume profile, pre-event flow analysis, resolution risk, top wallet positions, ECDSA-signed JWS receipt anchored on Polygon. For compliance teams, regulators, journalists, and AI agents that need auditable evidence packs, not just data points.",
      "example_type": "synthetic"
    },
    {
      "path": "/v2/nomos/preflight",
      "method": "POST",
      "price": "$0.05",
      "category": "cross-border",
      "summary": "NOMOS cross-border preflight: cached scan + regulatory verdict + protocol match, signed receipt; per-target fields redaction-enforced on BLOCK/ALLOW_PUBLIC_SIGNAL_ONLY.",
      "inputSchema": {
        "source_regime": {
          "type": "string",
          "description": "Source: EU|INDIA|JAPAN|KOREA|SINGAPORE|CHINA",
          "required": false
        },
        "target_regime": {
          "type": "string",
          "description": "Target: EU|INDIA|JAPAN|KOREA|SINGAPORE|CHINA",
          "required": false
        },
        "region": {
          "type": "string",
          "description": "Scanner region: japan|sg_china|india|korea",
          "required": false
        },
        "data_category": {
          "type": "string",
          "description": "public_company_signal|funding_signal|mcp_capability_signal|personal_contact_data|payment_or_wallet_data",
          "required": false
        },
        "query": {
          "type": "string",
          "description": "Free-text query for target search",
          "required": false
        },
        "max_results": {
          "type": "number",
          "description": "Max results (default 10)",
          "required": false
        }
      },
      "sample_input": {
        "source_regime": "EU",
        "target_regime": "JAPAN",
        "region": "japan",
        "data_category": "mcp_capability_signal",
        "query": "MCP-ready AI agent",
        "max_results": 5
      },
      "sample_output": {
        "verdict": "ALLOW",
        "adequacy_status": "recognized",
        "results": [],
        "receipt_hash": "sha256:..."
      },
      "description": "NOMOS Cross-Border Target Preflight — combined call: Asia market scan + regulatory preflight (GDPR/DPDP/PIPL/FSA/MAS) + protocol bridge analysis (MCP/A2A/AIP) in one signed response. Returns verdict (ALLOW/ALLOW_PUBLIC_SIGNAL_ONLY/REVIEW/BLOCK), blocked_fields, protocol_match per target, and SHA-256 receipt_hash. Covers EU-Japan, EU-India, EU-Korea, EU-Singapore, EU-China jurisdiction pairs. Not legal advice — preflight classification only.",
      "example_type": "illustrative"
    }
  ],
  "how_to_pay": [
    "1. POST JSON body to any endpoint above → receive HTTP 402 with payment requirements",
    "2. Sign an EIP-712 payment intent with USDC on Base (eip155:8453) to 0x11f591C3496C0632e7B173184f5Bc71dC941125D",
    "3. Retry the POST with X-PAYMENT header (base64-encoded payment payload)",
    "4. Settlement is handled by Coinbase Developer Platform facilitator. Response includes X-PAYMENT-RESPONSE header with on-chain TX hash."
  ],
  "client_libraries": [
    "Node.js: @x402/fetch, x402-fetch (npm)",
    "Coinbase Developer Platform: api.cdp.coinbase.com/platform/v2/x402",
    "x402 spec: https://x402.org"
  ],
  "publisher": {
    "name": "ToolOracle / FeedOracle",
    "url": "https://tooloracle.io",
    "github": "https://github.com/ToolOracle",
    "contact": "https://feedoracle.io"
  },
  "counts": {
    "paid_products": 17,
    "platform_servers": 99,
    "platform_tools": 1192
  },
  "canonical_source": "https://tooloracle.io/assets/catalog.json",
  "generated_at": "2026-07-14T18:48:01+00:00",
  "example_provenance": "ToolOracle/NOMOS-curated metadata. Each endpoint declares example_type as verified_fixture, illustrative, or synthetic. Illustrative examples are not captured live executions."
}