DPX — AI Intelligence Oracle + Settlement Rail

KYA — Know Your Agent. Three-tier registration: ANONYMOUS ($1K/day, instant), REGISTERED ($25K/day, self-attested email+entity), VERIFIED (institutional caps, GLEIF LEI confirmed instantly — no documents). VERIFIED agents get FATF R.16 attestation on every settlement and full AP2 mandate support.

Verify a registered DPX agent and receive a signed 1-hour credential. Returns KYA level, effective spend caps, owner verification status, mandate active status, and FATF R.16 compliance attestation. Attach credential.signature as X-Agent-Credential header on DPX /settle requests.

Create or update an AP2-compatible spend mandate for a REGISTERED or VERIFIED DPX agent. Sets per-agent settlement constraints: max notional per settlement, daily cap, optional counterparty whitelist, allowed currency pairs, ESG floor, and expiry.

Live DPX protocol analytics: oracle stability score, ESG composite score, all-in fee rate, settlement readiness verdict, and data availability across core services.

Execute up to 20 settlements in a single call. Each item follows the same schema as settlement.execute. Returns per-item results and aggregate summary.

Screen an individual by name against the OpenSanctions PEP (Politically Exposed Person) dataset. Returns match confidence, position/role, nationality, related entities, and overall risk level (HIGH / MEDIUM / LOW / NONE). HIGH or MEDIUM matches require Enhanced Due Diligence per FATF Recommendations 12 and 13.

Returns a structured calendar of upcoming and in-effect compliance obligations across MiCA, SFDR, CSRD, GENIUS Act, and FATF Recommendations 15/16. Also returns a DPX alignment section mapping each framework to specific DPX endpoints that satisfy it.

Trace the beneficial ownership chain for any legal entity up to 3 levels deep using GLEIF relationship records, then screen every node against the OpenSanctions consolidated sanctions list (OFAC SDN, EU, UN, UK OFSI). Returns CLEAR / REVIEW_REQUIRED / BLOCKED verdict and FATF R.16 beneficial ownership compliance attestation.

Live DPX protocol performance metrics from Cloudflare Workers Analytics. Returns total requests, error rate, daily average, peak day, per-service breakdown, and weekly trend for the last 7 or 30 days.

Screen up to 50 entities in a single call. Accepts LEIs or company names (GLEIF-resolved). Returns results ranked by composite ESG score descending. Useful for portfolio-level compliance screening, supplier due diligence, and TMS pre-payment checks.

Resolve a company name, domain, or ticker to a LEI via GLEIF and return the full ESG score. Removes the need for callers to have a LEI. Returns Environmental (40%), Social (35%), and Governance (25%) pillar scores, composite 0–100, fee surcharge tier, and per-source breakdown.

Score an entire counterparty portfolio in one call (up to 200 entities by LEI or name). Returns portfolio-level composite E/S/G scores, tier distribution, aggregate fee surcharge impact in basis points, worst offenders, top performers, MiCA Article 72 monitoring status, and SFDR PAI flags.

Get the live counterparty risk score (ESG-denominated) for a wallet address or the protocol default. Returns Environmental, Social, and Governance risk scores (0–100 each), composite weighted average, and the compliance-adjusted settlement fee percentage this score produces. Updated hourly from 6 institutional data sources.

Get the historical ESG composite trend for a specific entity by LEI. Returns score history, trend direction (IMPROVING / STABLE / DETERIORATING), and delta over the requested window.

Register an entity for ongoing ESG monitoring. DPX checks the score daily and fires a webhook when the composite score shifts by ≥ thresholdPoints. Satisfies MiCA Article 72 ongoing monitoring requirements.

Compare DPX settlement fees against Stripe, Wise, SWIFT, bank wire, PayPal, and Convera/WU for a given amount. Returns per-competitor fee amount, DPX savings in USD, and whether DPX is cheaper.

Get the complete DPX fee schedule: all components (core/FX/ESG/license), volume discount tiers (Standard / Growth / Institutional / Sovereign), ESG fee table by score, scenario examples, and competitive benchmarks vs Stripe, Wise, SWIFT, and bank wire.

Verify that the off-chain fee quote matches what the on-chain DPXSettlementRouter contract will charge. Returns feesMatch (true/false). Call after settlement.quote and before settlement.execute to confirm fee integrity.

Pre-flight check for a DPX settlement. Returns oracle status, compliance verdict, ESG score, fee estimate, and go/no-go recommendation before committing funds.

Seasonal climate event calendar with commodity impact. Returns 12 critical annual windows (hurricane season, corn pollination, Brazil frost risk, Black Sea harvest, ENSO influence periods, etc.) sorted by urgency — active windows first.

Climate-driven price pressure outlook for a commodity. Returns BULLISH/BEARISH/NEUTRAL signal with 30/60/90-day horizons, confidence score, per-region stressor breakdown, and current FRED price reference. Covers 11 commodities: WHEAT, CORN, SOYB, COFFEE, COCOA, COTTON, SUGAR, WTI, NG, COPPER, LUMBER.

Climate stress test for a multi-commodity portfolio. Pass up to 20 positions with weights. Returns aggregate portfolio climate score, most stressed positions, potential climate hedges, and a plain-language summary.

All ~40 global commodity production regions ranked by current climate risk score. Each region shows which commodities it affects and its current climate risk level (HIGH/MODERATE/LOW).

What-if climate scenario analysis. Apply a named scenario or custom stressor multipliers to any subset of commodities and see how signals shift. Built-in scenarios: la_nina_moderate, la_nina_severe, el_nino_moderate, gulf_hurricane_major, us_plains_drought_severe, black_sea_disruption, brazil_frost, chile_drought_copper, pacific_northwest_wildfire.

All 60+ currency corridors with current stability tier, daily volatility estimate, and regulatory flags. Sort is best-first (OPTIMAL → ADVERSE). Filter by source currency with the from parameter. Free.

All-in settlement cost quote for cross-border payments. CFO-grade output: exact amount received in target currency after rail fees, 48h FX cost variance expressed in dollars, corridor stability overlay, and optimal execution window.

Live mid-market FX rate for any currency pair. Returns mid rate, bid/ask spread, daily volatility %, regulatory flags for the corridor, and data freshness. Sourced from central bank rates (open.er-api.com, updated hourly). Free.

Poll the status of a DPX integration verification request by ID. Returns PENDING / VERIFIED / FAILED.

Initiate DPX integration verification — confirms the caller's wallet address and API key are registered. Returns a verification request ID to poll for completion.

Aftershock propagation model — given a macro shock origin, magnitude, and elapsed time, models secondary shocks across financial corridors.

Financial contagion model — maps how a shock at one node propagates through the network. Call with listNodes:true to discover valid origin IDs.

Gender-based violence and opportunity oracle — maps GBV prevalence, female LFPR gender gap, Women Business and Law Index, women in parliament, GDP per capita, and Gini to dual output: gbvRiskScore (suppression risk) + opportunityScore (reform upside). 18 countries.

Resonance oracle — detects when multiple independent macro signals amplify each other, producing outsized systemic risk. Returns resonance score, active amplification pairs, and regime.

Register a webhook to receive alerts when a DPX intelligence signal crosses a threshold. Supported signals: stability, cascade, macro_stress, climate, fx, or any. Edge-triggered, not repeated every hour.

Cancel an intelligence subscription by ID. Stops future webhook alerts for that subscription.

Check the status of an intelligence subscription by ID. Returns current signal score, last fired timestamp, total alerts fired, and subscription configuration.

Tectonic shift oracle — detects slow-moving structural breaks in global macro (debt cycles, reserve currency shifts, demographic inflections) before they surface in market data.

Create a DPX payment invoice. Returns invoiceId, payment address, amount, and expiry. Counterparty pays via USDC on Base; DPX notifies via callbackUrl on confirmation.

Get the status of a DPX invoice by ID. Returns current status (pending/paid/expired), amount, and payment details.

Trigger execution of a DPX invoice payment. Initiates on-chain USDC transfer to the invoice recipient address.

Butterfly effect cascade model: map climate, geopolitical, economic, and commodity shocks through a structured propagation graph. Call with listNodes:true to discover valid origin IDs.

FX settlement intelligence — per-pair execution risk for 10 major currency corridors. SETTLE_NOW / DELAY / AVOID recommendations updated hourly.

Global shipping stress oracle — Suez/Panama bottleneck scores, port congestion index, container rate trend, and DPX corridor impact for shipping-dependent payment flows.

List all Mercury bank accounts connected to DPX. Returns account names, available and current balances (in USD), account kind, and status. Proxied through the Settlement Agent.

Authorize an ACH payment from a Mercury account. Returns authorization details and payment ID. Set autoExecute:true to immediately submit after authorization.

Send a domestic or international wire payment from a Mercury account via the DPX Settlement Agent. Supports ACH, domestic wire, and international wire. Defaults to sandbox=true.

Execute a Mercury account sweep — moves funds above a threshold through DPX yield routing or settlement. Returns sweep result and DPX transaction reference.

List recent transactions for a Mercury account. Returns normalized transaction objects with amount (USD), status, counterparty name, and DPX tag status.

Get the live governance score (0–100) for any legal entity identified by LEI or company name. Pulls from GLEIF (LEI registration status, renewal compliance) and World Bank Worldwide Governance Indicators.

Pay-per-call macro intelligence briefing gated by MPP micropayment. Send 0.001 USDC on Base to the DPX fee collector then pass the txHash. Returns 8-layer macro signal with AI synthesis.