DPX — Institutional Cross-Border Settlement
REMOTE · MCP.UNTITLEDFINANCIAL.COM · 2 COMPONENTS · SCANNED AUG 20
AI-native settlement rail + intelligence oracle for autonomous agents. x402, Base mainnet, 81 tools.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: this server exposes a tool marked destructive (intelligence.subscription.delete) and its handshake is open, but we could not confirm whether a tool call is gated, so we do not assert it is callable unauthenticated. View diagnostics → Unverified
- HTTPS check failed: the endpoint is reachable over plaintext HTTP. See how to fix → View diagnostics → Fail
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability71
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 14268 tokens (~171/item across 83 items; 83 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management50
- Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (87% of tools); any adoption earns full credit.Pass
Capabilities40
- Spec-recency check failed: implements MCP spec 2025-03-26; the latest is 2026-07-28. See how to fix → Fail
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · mcp.untitledfinancial.com
claude mcp add --transport http untitledfinancial-dpx https://mcp.untitledfinancial.com/mcp
[mcp_servers.untitledfinancial-dpx] url = "https://mcp.untitledfinancial.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"untitledfinancial-dpx": {
"type": "remote",
"url": "https://mcp.untitledfinancial.com/mcp",
"enabled": true
}
}
} openclaw mcp add untitledfinancial-dpx --url https://mcp.untitledfinancial.com/mcp --transport streamable-http
mcp_servers:
untitledfinancial-dpx:
url: "https://mcp.untitledfinancial.com/mcp" {
"mcpServers": {
"untitledfinancial-dpx": {
"type": "http",
"url": "https://mcp.untitledfinancial.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 19 Aug 26 +1
- “invoice.pay” reworded the description of “sandbox” cosmetic
- “card.settle” reworded the description of “sandbox” cosmetic
2 cosmetic changes on this day. Switch on “Show cosmetic changes” to see them.
- 17 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Aug 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 10 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Aug 26 −1
- Schema quality: excellent → good functional
- New tool “card.settle” functional
- New tool “card.positions” functional
- 8 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Aug 2026 · Probed https://mcp.untitledfinancial.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=untitledfinancial.com | CN=WE1,O=Google Trust Services,C=US | 2 Jul 2026 | 1 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | 1ade9dbe68188e5f0e41323198acc322 |
| SANs: untitledfinancial.com, mcp.untitledfinancial.com, *.mcp.untitledfinancial.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC insecure
Validation of mcp.untitledfinancial.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| untitledfinancial.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.untitledfinancial.com/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.untitledfinancial.com/mcp | Served over HTTP | 200 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
agent.kya_register ~412
KYA — Know Your Agent. Three-tier registration model — compliance burden scales with settlement risk, no documents ever required. ANONYMOUS: agent name only, $1K/day cap, instant. REGISTERED: add ownerEntity + ownerEmail (self-attested, no verification), $25K/day cap, instant. VERIFIED: add ownerLei (active GLEIF LEI) — DPX calls the public GLEIF API, confirms ACTIVE status, and grants VERIFIED instantly. No documents, no manual review; LEI issuers (LOUs) have already done identity verification and DPX inherits it. VERIFIED agents get institutional caps (governed by mandate), FATF R.16 attestation on every settlement, and full AP2 mandate support. Legal basis: FATF R.16 originator = owner entity (not the agent); MiCA Art. 45/72 accepts LEI; GENIUS Act satisfied by entity attestation.
| Name | Type | Req | Description |
|---|---|---|---|
| framework | string | – | Agent framework: "claude", "gpt-4o", "gemini", "custom", etc. |
| mandate | object | – | Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents. |
| name | string | yes | Human-readable name for this agent. |
| ownerEmail | string | – | Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified. |
| ownerEntity | string | – | Organization or person that owns/operates this agent. Required for REGISTERED tier. |
| ownerLei | string | – | 20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org. |
| protocols | array | – | Supported protocols: ["x402", "ap2", "mcp", "a2a"]. |
| publicKey | string | – | Optional public key for credential signature verification. |
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | Unique agent identifier (agt_...). Store this. |
| kyaLevel | string | – | – |
| kyaScore | number | – | Trust score 0–100. |
| leiEntityName | string | – | Legal name from GLEIF record (VERIFIED only). |
| leiVerified | boolean | – | true if LEI was confirmed via GLEIF API. |
| tierCaps | object | – | maxNotionalUsd and dailyCapUsd effective for this agent. |
| tierNote | string | – | Explanation of tier and how to upgrade. |
No examples provided.
agent.kya_verify ~131
Verify a registered DPX agent and receive a signed 1-hour credential. Returns KYA level, effective spend caps (tier or mandate), owner verification status, mandate active status, and FATF R.16 compliance attestation. Attach credential.signature as X-Agent-Credential header and agentId as X-Agent-Id header on DPX /settle requests — enables mandate enforcement, per-agent audit trail, and FATF attestation. Credential expires in 1 hour; call again to refresh before expiry.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | yes | Agent ID from agent.kya_register (agt_...). |
| Name | Type | Req | Description |
|---|---|---|---|
| credential | object | – | agentId, issuedAt, expiresAt, mandateId, attestation (kyaLevel, ownerVerified, mandateActive, fatfCompliant, dailyCapUsd, maxNotionalUsd), signature |
| kyaLevel | string | – | – |
| kyaScore | number | – | – |
| mandate | object | – | Active mandate if present, null if expired. |
| verified | boolean | – | – |
No examples provided.
agent.mandate_create ~264
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 (LEIs or wallets), allowed currency pairs, ESG floor, and expiry. ANONYMOUS agents cannot hold mandates — register with ownerEntity + ownerEmail first. REGISTERED agents have mandate caps clamped to their tier limit ($25K). VERIFIED agents (GLEIF LEI confirmed) set their own caps with no platform ceiling. Mandate is AP2-formatted for interoperability with Google Agent Payments Protocol.
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | yes | Agent ID from agent.kya_register. |
| counterpartyWhitelist | array | – | LEIs or wallet addresses. Empty = any counterparty. |
| currencyPairs | array | – | Allowed pairs e.g. ["USD|EUR"]. Empty = any pair. |
| dailyCapUsd | number | yes | Max USD per calendar day (UTC). |
| esgFloor | number | – | Min counterparty ESG score (0 = no floor). |
| expiresAt | number | – | Unix timestamp for mandate expiry. |
| issuedBy | string | – | Organization issuing this mandate. |
| maxNotionalUsd | number | yes | Max USD per single settlement. |
| Name | Type | Req | Description |
|---|---|---|---|
| agentId | string | – | – |
| ap2Compatible | boolean | – | – |
| effectiveCaps | object | – | Actual caps after tier clamping. |
| mandate | object | – | Full mandate object. |
| mandateId | string | – | Unique mandate ID (mnd_...). |
No examples provided.
analytics.overview ~56
Get live DPX performance analytics. Returns current stability score, ESG composite scores, live fee breakdown, oracle health across all data sources, and a settlement readiness assessment. Use for dashboards, reporting, and AI-driven monitoring of protocol health.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| esgScore | number | – | Protocol ESG composite score 0–100 |
| fees | object | – | – |
| oracleHealth | object | – | Health status per oracle data source |
| settlementReady | boolean | – | True if conditions are suitable for settlement |
| stabilityScore | number | – | Current oracle stability score 0–100 |
| timestamp | string | – | ISO 8601 analytics timestamp |
No examples provided.
batch_settle ~78
Submit multiple settlements in a single call. Runs all settlements concurrently — one failure does not block others. Returns a summary (total/succeeded/failed) and per-item results mirroring what POST /settle would return. Maximum 50 per batch.
| Name | Type | Req | Description |
|---|---|---|---|
| settlements | array | yes | Array of settlement request objects (same schema as the settle tool) |
| Name | Type | Req | Description |
|---|---|---|---|
| results | array | – | – |
| summary | object | – | – |
No examples provided.
card.positions ~159
Plan treasury settlement for a crypto card program. Accepts net positions per corridor (e.g. USD-BRL: $2.3M, USD-EUR: €450K) and returns an optimal settlement plan — which corridors to settle now vs. hold, which stablecoin to use per corridor, and estimated all-in fee. No settlement is executed. Call this before card.settle to review the plan. Free.
| Name | Type | Req | Description |
|---|---|---|---|
| positions | array | yes | Array of net positions. Each: { corridor: "USD-BRL", netAmountUsd: 2300000, recipientAddress?: "0x..." } |
| settlementDate | string | – | Settlement date ISO string (defaults to today UTC). E.g. "2026-08-09". |
No output schema declared.
No examples provided.
card.settle ~143
Execute treasury settlement for a crypto card program. Takes the same positions array as card.positions but executes all settlements via DPX batch — compliance-gated, oracle-priced, stablecoin-routed. Each position requires a recipientAddress. Use sandbox:true for testing. Returns per-corridor settlement results and a summary.
| Name | Type | Req | Description |
|---|---|---|---|
| positions | array | yes | Array of net positions. Each: { corridor: "USD-BRL", netAmountUsd: 2300000, recipientAddress: "0x..." }. recipientAddress is required for every position. |
| sandbox | boolean | – | true = test mode, no on-chain execution. Default true — set false only for live execution. |
No output schema declared.
No examples provided.
compliance.pep_screen ~171
Screen an individual by name against the OpenSanctions PEP (Politically Exposed Person) dataset. PEPs include heads of state, senior government officials, senior executives of state-owned enterprises, senior politicians, senior military officers, judicial officials, and their close associates and family members. Returns match confidence, position/role, nationality, related entities, and an overall risk level (HIGH / MEDIUM / LOW / NONE). HIGH or MEDIUM matches require Enhanced Due Diligence (EDD) per FATF Recommendations 12 and 13 before settlement. Optionally filter by country.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO-2 country code to narrow the search (e.g. "IT"). Optional. |
| q | string | yes | Full name to screen (e.g. "Mario Draghi"). |
| Name | Type | Req | Description |
|---|---|---|---|
| fatfCompliance | object | – | EDD required flag, FATF R.12/13 attestation, note |
| matched | boolean | – | – |
| matches | array | – | Per match: caption, datasets, position, nationality, birthDate, relatedEntities, riskLevel, matchScore |
| overallRisk | string | – | – |
| totalMatches | number | – | – |
No examples provided.
compliance.regulatory_calendar ~126
Returns a structured calendar of upcoming and in-effect compliance obligations across MiCA (EU crypto-asset markets regulation), SFDR (Sustainable Finance Disclosure Regulation), CSRD (Corporate Sustainability Reporting Directive), the US GENIUS Act (payment stablecoin framework), and FATF Recommendations 15/16. For each event: framework, jurisdiction, requirement summary, effective date, impact level, and article reference. Also returns a DPX alignment section mapping each framework to the specific DPX endpoints that satisfy it. Use this before settlement workflow design, compliance gap analysis, or regulatory reporting.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| dpxAlignment | object | – | Per-framework mapping to DPX endpoints that satisfy each obligation |
| inEffect | array | – | Currently active requirements, most recent first |
| upcoming | array | – | Events not yet in effect, sorted by effective date ascending |
No examples provided.
compliance.ubo_chain ~198
Trace the beneficial ownership chain for any legal entity up to 3 levels deep using GLEIF relationship records, then screen every node in the chain against the OpenSanctions consolidated sanctions list (OFAC SDN, EU, UN, UK OFSI). Returns chain structure (SUBJECT → DIRECT_PARENT → ULTIMATE_PARENT), per-node sanctions status, LEI lapse flags, overall CLEAR / REVIEW_REQUIRED / BLOCKED verdict, and FATF R.16 beneficial ownership compliance attestation. Required for correspondent banking due diligence, FATF R.12/13 UBO identification, and MiCA Article 72 counterparty risk management.
| Name | Type | Req | Description |
|---|---|---|---|
| deep | boolean | – | Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only). |
| lei | string | yes | 20-character GLEIF LEI of the entity to trace (e.g. "2594007XIACKNMUAW223"). |
| Name | Type | Req | Description |
|---|---|---|---|
| chain | array | – | Per-node: level, role, lei, entityName, country, leiStatus, sanctions (matched, score, datasets), riskFlag |
| chainDepth | number | – | – |
| fatfR16 | object | – | FATF R.16 beneficial ownership compliance attestation |
| overallStatus | string | – | – |
| riskFlags | array | – | Nodes with sanctions hits or lapsed LEIs |
| ultimateBeneficialOwner | object | – | lei, entityName, country, leiStatus of the UBO |
No examples provided.
compute.cost ~125
Get a model recommendation for a task type without running inference. Returns the best free model for the task, its strengths and speed tier, and a list of alternatives. Use this when an agent needs to select a model before committing to inference, or to surface model selection logic to a human. Free.
| Name | Type | Req | Description |
|---|---|---|---|
| speed | boolean | – | true = prefer fastest model over most capable. Default false. |
| task | string | yes | Description of the task — e.g. "summarize a financial document", "write Python code", "translate from French", "reason through a math problem". |
No output schema declared.
No examples provided.
compute.models ~72
List all AI models available through DPX Compute. All models are free-tier (no token cost) — routed via OpenRouter. Returns model IDs, provider, capability strengths, context window, and speed tier. Use this before compute.route to understand what models are available and pick the right one for a task. Free.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
compute.route ~205
Route a task to the best available free AI model and run inference. DPX selects the model based on the task type (reasoning → DeepSeek R1, code → Llama 3.3 70B, multilingual → Qwen 2.5 72B, fast → Llama 3.1 8B), calls OpenRouter, and returns the completion. All models are free-tier — no token cost. Pay per call in USDC via x402. Use this when an agent needs to delegate a subtask to a language model without managing model selection or API keys.
| Name | Type | Req | Description |
|---|---|---|---|
| messages | array | – | Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message. |
| preferSpeed | boolean | – | true = use the fastest available free model regardless of task type. Default false. |
| task | string | yes | Plain-language description of what the model should do. Used for model selection. |
No output schema declared.
No examples provided.
computer_use.pay ~229
Complete a payment that Claude's computer use session has identified on screen — a checkout form, wire transfer UI, invoice approval, or vendor portal payment step. Call this instead of typing credentials into a UI. Describe what you see on screen, provide the amount and recipient, and DPX runs the full oracle gate → compliance screen → settlement flow. Returns a receipt. Use whenever computer use encounters a payment that would otherwise require human re-entry or approval.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Payment amount in USD as shown on screen |
| counterparty_name | string | – | Vendor or payee name as shown on screen |
| purpose | string | yes | Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement |
| recipient_address | string | yes | Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead. |
| sandbox | boolean | – | Set false for live execution. Default: true |
| screen_context | string | yes | Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail. |
| Name | Type | Req | Description |
|---|---|---|---|
| aiConfidence | number | – | – |
| aiDecision | string | – | – |
| decision | string | – | – |
| feeUsd | number | – | – |
| netUsd | number | – | – |
| reason | string | – | – |
| settlementId | string | – | – |
| status | string | – | – |
| txHash | string | – | – |
No examples provided.
dpx.metrics ~109
Live performance metrics for the DPX settlement infrastructure — pulled directly from production telemetry. Returns request volumes, error rates, growth trends, per-service breakdown, and spike analysis across all active DPX workers. Free — designed for investor due diligence, analyst queries, and Standard Metrics / portfolio management integrations. No auth required.
| Name | Type | Req | Description |
|---|---|---|---|
| window | string | – | Time window for metrics. "7d" = last 7 days, "30d" = last 30 days. Default: 30d. |
| Name | Type | Req | Description |
|---|---|---|---|
| dailyAverage | number | – | – |
| errorRate | string | – | – |
| peakDay | object | – | – |
| services | array | – | – |
| summary | string | – | – |
| totalRequests | number | – | – |
| weeklyTrend | array | – | – |
| window | string | – | – |
No examples provided.
esg.batch ~128
Screen up to 50 entities in a single call. Accepts LEIs or company names (GLEIF-resolved). Returns results ranked by composite ESG score descending — highest scoring counterparties first. Useful for portfolio-level compliance screening, supplier due diligence, and TMS pre-payment checks. Name resolution is slower than direct LEI input.
| Name | Type | Req | Description |
|---|---|---|---|
| leis | array | – | Array of LEIs to screen (fastest path — no GLEIF resolution needed). |
| names | array | – | Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name). |
| Name | Type | Req | Description |
|---|---|---|---|
| failed | number | – | – |
| results | array | – | Entities sorted by composite score descending. Each item includes lei, entityName, score object, or an error note. |
| succeeded | number | – | – |
| total | number | – | – |
No examples provided.
esg.lookup ~209
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 (SEC EDGAR, OSHA, BLS SOII, EU E-PRTR, ESMA, World Bank WGI, GLEIF). Use when you have a company name but not a LEI.
| Name | Type | Req | Description |
|---|---|---|---|
| country | string | – | ISO-2 country code to narrow results (e.g. "US", "DE"). Optional but improves match accuracy. |
| narrate | boolean | – | Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer. |
| q | string | yes | Company name, domain, or ticker to look up (e.g. "Apple Inc", "siemens.com", "MSFT") |
| Name | Type | Req | Description |
|---|---|---|---|
| found | boolean | – | – |
| narration | string | – | Plain-language compliance narrative (only when narrate=true) |
| resolved | object | – | – |
| score | object | – | Full ESG score object with composite, environmental, social, governance, feeTier, feeSurcharge, sources, coverage |
No examples provided.
esg.portfolio ~154
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 (bottom 10% by composite), top performers, MiCA Article 72 ongoing monitoring status, and SFDR PAI flags. The canonical pre-settlement compliance check for treasury systems and TMS integrations.
| Name | Type | Req | Description |
|---|---|---|---|
| label | string | – | Optional label for this portfolio (e.g. "Q3 2026 Counterparties"). |
| leis | array | – | LEIs to score (fastest — no name resolution). |
| names | array | – | Company names to score (GLEIF-resolved). |
| Name | Type | Req | Description |
|---|---|---|---|
| compliance | object | – | micaArticle72, highRiskCount, sfdr flags |
| distribution | object | – | byTier counts, min, max, median |
| entities | object | – | – |
| label | string | – | – |
| portfolio | object | – | composite, environmental, social, governance, tier, avgFeeSurcharge, totalFeeImpactBps |
| topPerformers | array | – | – |
| worstOffenders | array | – | Bottom 10% entities with weakest pillar identified |
No examples provided.
esg.score ~132
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: WorldBank, IMF, OECD, UN SDG API, ClimateMonitor, and SEC EDGAR. Required by EU SFDR Principal Adverse Impact reporting and CSRD financed emissions disclosure for institutional clients.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Wallet address (0x...) to score. Omit for protocol default. |
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Scored wallet address or "default" |
| environmental | number | – | Environmental score 0–100 |
| esgScore | number | – | Composite ESG score 0–100 |
| feePct | number | – | ESG fee percentage applied at settlement |
| governance | number | – | Governance score 0–100 |
| social | number | – | Social score 0–100 |
| sources | array | – | Data sources used |
| tier | string | – | ESG tier label |
| updatedAt | string | – | ISO 8601 last update timestamp |
No examples provided.
esg.trend ~134
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. Data accumulates each time the entity is scored via esg.lookup, esg.batch, or esg.portfolio. Useful for due diligence, MiCA Article 72 ongoing monitoring reports, and detecting counterparties whose ESG posture is degrading.
| Name | Type | Req | Description |
|---|---|---|---|
| days | number | – | Lookback window in days (7–365). Default 90. |
| lei | string | yes | 20-character GLEIF LEI. |
| Name | Type | Req | Description |
|---|---|---|---|
| baseline | number | – | – |
| current | number | – | – |
| dataPoints | number | – | – |
| days | number | – | – |
| delta | number | – | Score change over the window (positive = improving) |
| history | array | – | – |
| lei | string | – | – |
| trend | string | – | – |
No examples provided.
esg.watch ~139
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. Returns a watchId for status checks and cancellation. Webhook payload includes previous/current score, delta, and tier change.
| Name | Type | Req | Description |
|---|---|---|---|
| lei | string | yes | 20-character GLEIF LEI of the entity to monitor. |
| thresholdPoints | number | – | Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1. |
| webhookUrl | string | yes | HTTPS URL to POST score change alerts to. Must be HTTPS. |
| Name | Type | Req | Description |
|---|---|---|---|
| baselineScore | number | – | Composite score at registration (used as first comparison point) |
| baselineTier | string | – | – |
| createdAt | string | – | – |
| entityName | string | – | – |
| lei | string | – | – |
| watchId | string | – | UUID — use to check status (GET /esg/watch/:id) or cancel (DELETE /esg/watch/:id) |
No examples provided.
fees.compare ~153
Compare DPX settlement cost against Stripe cross-border (5.4% + $0.30), Wise (0.40–1.50%), Ripple ODL (0.20–0.50%), Lightspark, SWIFT (2.00–5.00%), PayPal, and bank wire. Returns dollar savings vs each at the current DPX all-in rate (~2.035% typical). Also returns GENIUS Act and MiCA compliance status for each competitor.
| Name | Type | Req | Description |
|---|---|---|---|
| amountUsd | number | yes | Settlement amount in USD |
| esgScore | number | – | ESG score 0–100 |
| hasFx | boolean | – | Cross-currency? Adds 0.40% FX fee. |
| Name | Type | Req | Description |
|---|---|---|---|
| amountUsd | number | – | Settlement amount compared |
| comparison | object | – | Per-competitor comparison keyed by competitor ID |
| dpx | object | – | – |
| note | string | – | Context note on comparison methodology |
No examples provided.
fees.schedule ~64
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| benchmarks | object | – | Competitor fee benchmarks |
| examples | array | – | Fee calculation examples |
| fees | object | – | Fee component definitions |
| tiers | object | – | Volume discount tiers |
No examples provided.
fees.verify ~87
Verify that the off-chain fee quote matches what the on-chain DPXSettlementRouter contract will charge. Returns feesMatch (true/false). Call after get_quote and before settle to confirm fee integrity.
| Name | Type | Req | Description |
|---|---|---|---|
| amountUsd | number | yes | Settlement amount in USD |
| esgScore | number | – | ESG score 0–100 |
| hasFx | boolean | – | Cross-currency settlement? |
| Name | Type | Req | Description |
|---|---|---|---|
| delta | number | – | Absolute difference in basis points |
| feesMatch | boolean | – | True if off-chain quote matches on-chain contract |
| offChainFee | object | – | – |
| onChainFee | object | – | – |
| recommendation | string | – | PROCEED | INVESTIGATE |
No examples provided.
flow_check ~159
Single pre-flight call before settling. Runs oracle check, compliance screen, and stablecoin routing in parallel and returns a unified go/no-go decision. Replaces the 3-step oracle → screen → route loop. Returns: decision (PROCEED/HOLD/BLOCKED), recommended token, estimated net received, oracle score, compliance verdict, and a ready-to-use settleBody.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Counterparty wallet address for compliance screen (optional but recommended) |
| amount | number | yes | Settlement amount in source currency |
| from | string | – | Source currency code (default: USD) |
| lei | string | – | Counterparty LEI for enhanced compliance check (optional) |
| to | string | – | Destination currency code (default: USD) |
| Name | Type | Req | Description |
|---|---|---|---|
| compliance | object | – | – |
| decision | string | – | PROCEED | HOLD | BLOCKED |
| estimatedNetUsd | number | – | Estimated net received after all fees |
| oracle | object | – | – |
| ready | boolean | – | True when decision is PROCEED |
| settleBody | object | – | Ready to POST to /settle (null if BLOCKED or HOLD) |
| token | string | – | Recommended stablecoin (USDC, EURC, or USDT) |
| ttlSeconds | number | – | – |
No examples provided.
forecast.calendar ~75
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, then by months until next occurrence. Each entry includes affected commodities, severity, and the agronomic basis.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| calendar | array | – | Seasonal events sorted by urgency — active events first |
| currentMonth | number | – | Current UTC month (1–12) for reference |
No examples provided.
forecast.commodity_outlook ~158
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. Designed for institutional research teams evaluating commodity positions. Signals reflect supply constraint risk from climate — not a financial recommendation. Cache: 4h.
| Name | Type | Req | Description |
|---|---|---|---|
| fresh | boolean | – | true = bypass 4h cache and recompute live signals |
| symbol | string | yes | Commodity symbol |
| Name | Type | Req | Description |
|---|---|---|---|
| climateScore | number | – | Supply constraint pressure 0–100; >65 = elevated bullish pressure |
| confidence | number | – | Signal confidence 0–1 |
| currentPrice | object | – | Latest FRED price reference (value, unit, date) |
| forecastedAt | string | – | – |
| horizons | object | – | 30d / 60d / 90d — each has signal, confidence, basis |
| inGrowingSeason | boolean | – | true = stressors in peak transmission window — act faster |
| name | string | – | – |
| reasoning | string | – | Plain-language synthesis of climate signals and price implications |
| recommendation | string | – | – |
| regions | array | – | Per production-region climate scores and drought/temperature readings |
| signal | string | – | – |
| stressors | array | – | Active climate stressors with severity, region, price impact estimate, probability |
| symbol | string | – | – |
No examples provided.
forecast.portfolio_stress ~91
Climate stress test for a multi-commodity portfolio. Pass up to 20 positions with weights (percentages or fractions — normalized internally). Returns aggregate portfolio climate score, which positions are most stressed, which could act as climate hedges, and a plain-language summary. Useful for commodity fund managers evaluating aggregate climate exposure before rebalancing.
| Name | Type | Req | Description |
|---|---|---|---|
| positions | array | yes | Portfolio positions with symbol and weight |
| Name | Type | Req | Description |
|---|---|---|---|
| dominantRisk | string | – | Most climate-stressed position |
| hedgeCandidates | array | – | Symbols with climateScore ≤ 35 — potential climate hedges |
| portfolioClimateScore | number | – | Weighted aggregate climate stress 0–100 |
| positions | array | – | Per-position signal and climate score |
| stressedPositions | array | – | Symbols with climateScore ≥ 65 |
| summary | string | – | – |
No examples provided.
forecast.production_regions ~62
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). Use to identify which geographic zones are under active climate stress and which commodities are most exposed.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| regions | array | – | Regions sorted by climate risk score, with affected commodities and risk level |
| updatedAt | string | – | – |
No examples provided.
forecast.scenario ~171
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. Use to stress-test a commodity thesis before committing to a position.
| Name | Type | Req | Description |
|---|---|---|---|
| scenario | string | – | Built-in scenario ID — or omit and provide stressorOverrides |
| stressorOverrides | object | – | Custom multipliers if not using a named scenario (1.0 = no change) |
| symbols | array | – | Symbols to analyze — omit for all 11 |
| Name | Type | Req | Description |
|---|---|---|---|
| description | string | – | – |
| portfolioImpact | object | – | mostImpacted, leastImpacted, averageClimateScore |
| results | array | – | Per-commodity signal, climateScore, recommendation, topStressor, reasoning |
| scenario | string | – | – |
No examples provided.
fx.corridors ~102
All 60+ currency corridors with current stability tier, daily volatility estimate, and regulatory flags. Sort is best-first (OPTIMAL → ADVERSE). Use to compare corridors before choosing a payment route — e.g. "which LATAM corridor is most stable for a $2M payment this week?" Filter by source currency with the from parameter. Free.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | – | Optional: filter to corridors starting from this currency (e.g. USD) |
| Name | Type | Req | Description |
|---|---|---|---|
| corridorCount | number | – | – |
| corridors | array | – | Corridors sorted best-first with score, tier, vol, regulatory flags |
| summary | object | – | Count by tier: OPTIMAL / FAVORABLE / CAUTION / ELEVATED_RISK / ADVERSE |
No examples provided.
fx.cost_certainty ~166
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. Answers "if I send $X today, what does my counterparty receive net of everything, and how certain is that number?" Requires x402 micropayment.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount to send |
| amountCurrency | string | – | Currency of the amount (defaults to from) |
| from | string | yes | Source currency ISO 4217 (e.g. USD) |
| lei | string | – | Optional counterparty LEI for ESG-adjusted fee tier |
| to | string | yes | Target currency ISO 4217 (e.g. BRL) |
| Name | Type | Req | Description |
|---|---|---|---|
| corridorIntelligence | object | – | Corridor stability score, regulatory flags, cascade level |
| costCertainty | object | – | 48h volatility, uncertainty in USD, received range in target currency |
| executionRecommendation | object | – | SETTLE_NOW / DELAY_24H / DELAY_48H with best execution window UTC |
| railFees | object | – | All-in fee breakdown in USD |
| settlement | object | – | Sent and received amounts with live FX rate |
No examples provided.
fx.rate ~101
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, no API key required). Free.
| Name | Type | Req | Description |
|---|---|---|---|
| from | string | yes | Source currency ISO 4217 code (e.g. USD) |
| to | string | yes | Target currency ISO 4217 code (e.g. BRL) |
| Name | Type | Req | Description |
|---|---|---|---|
| ask | number | – | – |
| bid | number | – | – |
| corridorFlags | array | – | Regulatory flags for this corridor |
| dailyVolatilityPct | number | – | Estimated daily FX volatility % |
| mid | number | – | Mid-market rate (from → to) |
| pair | string | – | – |
| spreadPct | number | – | Implied interbank spread % |
| updatedAt | string | – | – |
No examples provided.
integration.status ~88
Check the status of a DPX integration verification session. Polls Base mainnet for receipt of the $0.01 USDC handshake payment. Returns "pending" until payment is detected on-chain, then "verified" with the txHash and a Basescan explorer link. Poll every 10–15 seconds after sending the payment.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | verificationId returned by integration.verify. |
| Name | Type | Req | Description |
|---|---|---|---|
| explorer | string | – | Basescan URL for the verification transaction. |
| id | string | – | – |
| message | string | – | – |
| status | string | – | Current verification state. |
| txHash | string | – | Transaction hash of the $0.01 payment. Present when verified. |
| verifiedAt | string | – | ISO timestamp of on-chain confirmation. Present when status is "verified". |
| walletAddress | string | – | – |
No examples provided.
integration.verify ~136
Initiate a $0.01 USDC onboarding handshake for a new DPX integration. Returns the DPX treasury address and payment instructions. The client sends $0.01 USDC on Base mainnet to confirm their wallet is funded and settlement rails are clear. Call integration.status to poll for confirmation. Required for all new integrations before production settlements are enabled.
| Name | Type | Req | Description |
|---|---|---|---|
| apiKey | string | – | Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext. |
| walletAddress | string | yes | The client wallet address (0x...) that will send the $0.01 verification payment. |
| Name | Type | Req | Description |
|---|---|---|---|
| expiresAt | string | – | ISO timestamp — verification window closes after 24 hours. |
| payment | object | – | – |
| polling | object | – | – |
| status | string | – | Always "pending" on creation. |
| verificationId | string | – | Session ID — use with integration.status to poll for payment confirmation. |
No examples provided.
intelligence.aftershock ~233
Aftershock Intelligence — models the secondary waves that follow a primary cascade event. Takes a primary shock (origin node, event type, magnitude, elapsed hours) and returns three aftershock waves: Wave 1 (0–72h immediate secondary effects), Wave 2 (1–4 weeks policy response distortions), Wave 3 (1–6 months structural changes now permanently locked in). Identifies which nodes are rebounding, which face amplified pressure, and which are structurally altered. Companion to market.cascade — run cascade first, then aftershock to see the full picture. POST with origin, eventType, magnitude, elapsedHours.
| Name | Type | Req | Description |
|---|---|---|---|
| elapsedHours | number | – | Hours elapsed since the primary event. Default 24. |
| eventType | string | – | Description of the primary event. |
| horizonHours | number | – | Forward horizon to model in hours. Default 4320 (6 months). |
| magnitude | number | yes | Primary shock magnitude 1–100. |
| origin | string | yes | Origin node ID from the primary cascade (e.g. "geo.conflict", "climate.drought"). |
| Name | Type | Req | Description |
|---|---|---|---|
| synthesis | string | – | – |
| wave1 | object | – | Immediate (0–72h): rebound, amplified, structural nodes. |
| wave2 | object | – | Policy response phase (1–4 weeks). |
| wave3 | object | – | Structural lock-in (1–6 months). |
No examples provided.
intelligence.contagion ~183
Contagion Intelligence — simulates how a macro or financial shock spreads through 30 nodes across 6 domains (financial systems, real economies, commodity networks, policy anchors, social systems, physical infrastructure) using an epidemiological R-value model. Returns system R trajectory, per-epoch spread map, superspreader nodes, containment forecast, and AI briefing. R < 1.0 = self-limiting; R ≥ 1.0 = expanding. Call /contagion/nodes first to discover valid origin IDs. POST with origin and magnitude.
| Name | Type | Req | Description |
|---|---|---|---|
| listNodes | boolean | – | If true, returns all valid origin node IDs instead of running a simulation. |
| magnitude | number | – | Initial shock magnitude 1–100. |
| origin | string | – | Origin node ID. Call intelligence.contagion with listNodes:true to discover valid IDs. |
| Name | Type | Req | Description |
|---|---|---|---|
| containment | object | – | Forecast of when/if containment is achieved. |
| spreadMap | array | – | Per-epoch infection state across all nodes. |
| superspreaders | array | – | Nodes with highest R contribution. |
| synthesis | string | – | – |
| systemR | number | – | System-level R value. ≥1.0 means spreading. |
No examples provided.
intelligence.gender_risk ~151
Gender Risk & Opportunity Intelligence — maps the structural relationship between GBV prevalence, legal discrimination, female labour force participation, and economic outcomes across 18 countries. Returns two independent scores: gbvRiskScore (0–100 suppression risk — high GBV → female LFPR suppression → GDP drag → fiscal stress → sovereign risk premium) and opportunityScore (0–100 reform upside — improving GBV indicators, closing LFPR gender gaps, and strengthening legal rights precede FDI inflows and consumer credit expansion). Five transmission mechanisms. Live FRED economic stress feedback. AI synthesis. Data: WHO GHO, World Bank WDI, FRED. 12h cache. No input required — GET.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| countries | array | – | Per-country: gbvRiskScore, opportunityScore, LFPR gap, WBL index, GDP per capita, transmission mechanisms. |
| regionalSummary | object | – | – |
| synthesis | string | – | – |
No examples provided.
intelligence.resonance ~120
Resonance Intelligence — detects when multiple independent macro forces are oscillating in phase across 28 signals in 5 domains, amplifying each other rather than cancelling. A single shock is manageable; resonance turns a bad quarter into a systemic crisis. Returns per-signal phase angles, resonance clusters (groups of 3+ aligned signals), amplitude amplification factor, system resonance score (0–100), and historical danger-zone comparison to crisis precedents (2008, 2011, 2020, 1997 EM). No input required — GET.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| amplificationFactor | number | – | Constructive interference gain across dominant cluster. |
| dangerZoneMatch | object | – | Similarity to historical crisis resonance patterns. |
| resonanceClusters | array | – | Groups of 3+ signals in mutual resonance. |
| synthesis | string | – | – |
| systemResonanceScore | number | – | 0–100. Higher = more dangerous in-phase alignment. |
No examples provided.
intelligence.subscribe ~177
Register a webhook to receive alerts when a DPX intelligence signal crosses a threshold. Supported signals: stability (overall 0–100 score), cascade (shock propagation risk), macro_stress, climate, fx, or any. The cron checks hourly and fires the webhook on crossing — edge-triggered, not repeated every hour. Returns a subscriptionId for status checks and cancellation. Use for treasury alert systems, TMS integrations, or autonomous agent monitoring loops.
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | – | Fire when signal goes above or below threshold. Default: above. |
| label | string | – | Optional label for your own tracking. |
| signal | string | – | Signal to monitor. Default: stability. |
| threshold | number | yes | Score value (0–100) that triggers the webhook. |
| webhookUrl | string | yes | HTTPS URL to POST alerts to. |
| Name | Type | Req | Description |
|---|---|---|---|
| currentScore | number | – | Signal score at registration time |
| deleteUrl | string | – | – |
| direction | string | – | – |
| signal | string | – | – |
| statusUrl | string | – | – |
| subscriptionId | string | – | – |
| threshold | number | – | – |
No examples provided.
intelligence.subscription.delete ~46
Cancel an intelligence subscription by ID. Stops future webhook alerts for that subscription. The alert log is retained for audit purposes.
| Name | Type | Req | Description |
|---|---|---|---|
| subscriptionId | string | yes | UUID returned by intelligence.subscribe. |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | – | – |
| subscriptionId | string | – | – |
No examples provided.
intelligence.subscription.get ~60
Check the status of an intelligence subscription by ID. Returns current signal score, last fired timestamp, total alerts fired, and subscription configuration. Use after intelligence.subscribe to verify a subscription is active.
| Name | Type | Req | Description |
|---|---|---|---|
| subscriptionId | string | yes | UUID returned by intelligence.subscribe. |
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | – | – |
| lastCheckedAt | string | – | – |
| lastFiredAt | string | – | – |
| lastScore | number | – | – |
| signal | string | – | – |
| subscriptionId | string | – | – |
| threshold | number | – | – |
| totalAlertsFired | number | – | – |
No examples provided.
intelligence.tectonic ~108
Tectonic Intelligence — maps slow-moving structural stress across 22 fault lines in 5 domains (demographic, fiscal, environmental, infrastructure, geopolitical). Each node carries current stress (0–100), accumulation rate (%/yr), tipping threshold, and estimated years to rupture. Where market.cascade traces an acute shock, tectonic surfaces latent pressure before it ruptures. Returns per-node stress state, rupture sequence, horizon timeline, and AI synthesis briefing. No input required — GET.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| faultLines | array | – | Per-node: domain, label, stress, accumulationRate, yearsToRupture, tippingThreshold. |
| ruptureSequence | array | – | Ordered fault lines by proximity to rupture. |
| synthesis | string | – | AI briefing on the most dangerous structural accumulations. |
| systemStress | number | – | Composite tectonic stress 0–100. |
No examples provided.
invoice.create ~167
Create an agent-to-agent invoice. Agent A calls this to request payment from Agent B. Returns an invoiceId and payUrl — Agent B calls invoice.pay with the invoiceId to settle. Invoice expires after ttlSeconds (default 24h).
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Invoice amount in source currency |
| callbackUrl | string | – | URL to notify when invoice is paid |
| currency | string | – | Source currency code (default: USD) |
| description | string | – | Human-readable payment description |
| destinationCurrency | string | – | Destination currency (default: same as currency) |
| recipientAddress | string | – | Payee wallet address (can also be provided at pay time) |
| ttlSeconds | number | – | Invoice TTL in seconds (default: 86400 = 24h) |
| Name | Type | Req | Description |
|---|---|---|---|
| expiresAt | string | – | – |
| invoiceId | string | – | UUID — pass to invoice.get or invoice.pay |
| payUrl | string | – | Direct URL to pay this invoice |
| status | string | – | OPEN | PAID | EXPIRED |
No examples provided.
invoice.get ~64
Retrieve an agent-to-agent invoice by ID. Returns status (OPEN/PAID/EXPIRED), amount, currency pair, and payUrl. Use before calling invoice.pay to confirm the invoice is still OPEN.
| Name | Type | Req | Description |
|---|---|---|---|
| invoiceId | string | yes | Invoice UUID returned by invoice.create |
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | – | – |
| currency | string | – | – |
| expiresAt | string | – | – |
| id | string | – | – |
| payUrl | string | – | – |
| status | string | – | – |
No examples provided.
invoice.pay ~110
Pay an agent-to-agent invoice by ID. Retrieves the invoice, runs settlement via POST /settle, and marks the invoice PAID on success. In sandbox mode returns a simulated receipt; in live mode returns execution parameters for on-chain completion.
| Name | Type | Req | Description |
|---|---|---|---|
| invoiceId | string | yes | Invoice UUID to pay |
| recipientAddress | string | – | Payee wallet address (required if not set in invoice) |
| sandbox | boolean | – | True for sandbox simulation. Default: true — set false only for live execution. |
| Name | Type | Req | Description |
|---|---|---|---|
| invoiceId | string | – | – |
| settlement | object | – | Full settlement result from POST /settle |
No examples provided.
ledger.session ~78
Get the aggregated payment graph for a multi-agent session. Returns total USD moved, transaction count, and a chronological list of all payments made during the session. Use for cost accounting, audit, or to show a human what an agent run spent.
| Name | Type | Req | Description |
|---|---|---|---|
| session_id | string | yes | Session or task ID — the same ID used in receipt.create calls |
No output schema declared.
No examples provided.