DPX — Institutional Cross-Border Settlement

{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Human-readable name for this agent.'}, 'mandate': {'type': 'object', 'properties': {'esgFloor': {'type': 'number', 'description': 'Minimum counterparty ESG score (0 = no floor).'}, 'expiresAt': {'type': 'number', 'description': 'Unix timestamp for mandate expiry.'}, 'dailyCapUsd': {'type': 'number', 'description': 'Max USD per calendar day (UTC).'}, 'currencyPairs': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. ["USD|EUR"] (empty = any).'}, 'maxNotionalUsd': {'type': 'number', 'description': 'Max USD per single settlement.'}, 'counterpartyWhitelist': {'type': 'array', 'items': {'type': 'string'}, 'description': 'LEIs or wallet addresses (empty = any).'}}, 'description': 'Optional AP2-compatible spend mandate (REGISTERED/VERIFIED only). Caps are clamped to tier limits for REGISTERED agents.'}, 'ownerLei': {'type': 'string', 'description': '20-char GLEIF LEI. Providing a valid active LEI instantly grants VERIFIED tier — no documents. Get your LEI at gleif.org.'}, 'framework': {'type': 'string', 'description': 'Agent framework: "claude", "gpt-4o", "gemini", "custom", etc.'}, 'protocols': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Supported protocols: ["x402", "ap2", "mcp", "a2a"].'}, 'publicKey': {'type': 'string', 'description': 'Optional public key for credential signature verification.'}, 'ownerEmail': {'type': 'string', 'description': 'Contact email. Required for REGISTERED tier ($25K/day cap). Self-attested, not verified.'}, 'ownerEntity': {'type': 'string', 'description': 'Organization or person that owns/operates this agent. Required for REGISTERED tier.'}}}

{'type': 'object', 'properties': {'agentId': {'type': 'string', 'description': 'Unique agent identifier (agt_...). Store this.'}, 'kyaLevel': {'enum': ['ANONYMOUS', 'REGISTERED', 'VERIFIED'], 'type': 'string'}, 'kyaScore': {'type': 'number', 'description': 'Trust score 0–100.'}, 'tierCaps': {'type': 'object', 'description': 'maxNotionalUsd and dailyCapUsd effective for this agent.'}, 'tierNote': {'type': 'string', 'description': 'Explanation of tier and how to upgrade.'}, 'leiVerified': {'type': 'boolean', 'description': 'true if LEI was confirmed via GLEIF API.'}, 'leiEntityName': {'type': 'string', 'description': 'Legal name from GLEIF record (VERIFIED only).'}}}

{'type': 'object', 'required': ['agentId'], 'properties': {'agentId': {'type': 'string', 'description': 'Agent ID from agent.kya_register (agt_...).'}}}

{'type': 'object', 'properties': {'mandate': {'type': 'object', 'description': 'Active mandate if present, null if expired.'}, 'kyaLevel': {'type': 'string'}, 'kyaScore': {'type': 'number'}, 'verified': {'type': 'boolean'}, 'credential': {'type': 'object', 'description': 'agentId, issuedAt, expiresAt, mandateId, attestation (kyaLevel, ownerVerified, mandateActive, fatfCompliant, dailyCapUsd, maxNotionalUsd), signature'}}}

{'type': 'object', 'required': ['agentId', 'maxNotionalUsd', 'dailyCapUsd'], 'properties': {'agentId': {'type': 'string', 'description': 'Agent ID from agent.kya_register.'}, 'esgFloor': {'type': 'number', 'description': 'Min counterparty ESG score (0 = no floor).'}, 'issuedBy': {'type': 'string', 'description': 'Organization issuing this mandate.'}, 'expiresAt': {'type': 'number', 'description': 'Unix timestamp for mandate expiry.'}, 'dailyCapUsd': {'type': 'number', 'description': 'Max USD per calendar day (UTC).'}, 'currencyPairs': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Allowed pairs e.g. ["USD|EUR"]. Empty = any pair.'}, 'maxNotionalUsd': {'type': 'number', 'description': 'Max USD per single settlement.'}, 'counterpartyWhitelist': {'type': 'array', 'items': {'type': 'string'}, 'description': 'LEIs or wallet addresses. Empty = any counterparty.'}}}

{'type': 'object', 'properties': {'agentId': {'type': 'string'}, 'mandate': {'type': 'object', 'description': 'Full mandate object.'}, 'mandateId': {'type': 'string', 'description': 'Unique mandate ID (mnd_...).'}, 'ap2Compatible': {'type': 'boolean'}, 'effectiveCaps': {'type': 'object', 'description': 'Actual caps after tier clamping.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'fees': {'type': 'object', 'properties': {'totalPct': {'type': 'number'}, 'esgFeePct': {'type': 'number'}, 'baseRatePct': {'type': 'number'}}}, 'esgScore': {'type': 'number', 'description': 'Protocol ESG composite score 0–100'}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 analytics timestamp'}, 'oracleHealth': {'type': 'object', 'description': 'Health status per oracle data source', 'additionalProperties': True}, 'stabilityScore': {'type': 'number', 'description': 'Current oracle stability score 0–100'}, 'settlementReady': {'type': 'boolean', 'description': 'True if conditions are suitable for settlement'}}}

{'type': 'object', 'required': ['settlements'], 'properties': {'settlements': {'type': 'array', 'items': {'type': 'object', 'required': ['amount', 'sourceCurrency', 'destinationCurrency', 'recipientAddress'], 'properties': {'token': {'type': 'string'}, 'amount': {'type': 'number'}, 'sandbox': {'type': 'boolean'}, 'sourceCurrency': {'type': 'string'}, 'recipientAddress': {'type': 'string'}, 'destinationCurrency': {'type': 'string'}}}, 'maxItems': 50, 'description': 'Array of settlement request objects (same schema as the settle tool)'}}}

{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'data': {'type': 'object', 'additionalProperties': True}, 'index': {'type': 'number'}, 'status': {'type': 'number'}}}}, 'summary': {'type': 'object', 'properties': {'total': {'type': 'number'}, 'failed': {'type': 'number'}, 'succeeded': {'type': 'number'}}}}}

{'type': 'object', 'required': ['positions'], 'properties': {'positions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of net positions. Each: { corridor: "USD-BRL", netAmountUsd: 2300000, recipientAddress?: "0x..." }'}, 'settlementDate': {'type': 'string', 'description': 'Settlement date ISO string (defaults to today UTC). E.g. "2026-08-09".'}}}

{'type': 'object', 'required': ['positions'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'true = test mode, no on-chain execution. Default true — set false only for live execution.'}, 'positions': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of net positions. Each: { corridor: "USD-BRL", netAmountUsd: 2300000, recipientAddress: "0x..." }. recipientAddress is required for every position.'}}}

{'type': 'object', 'required': ['entity'], 'properties': {'entity': {'type': 'string', 'description': 'Wallet address, LEI, or name of the counterparty to screen.'}, 'purpose': {'type': 'string', 'description': 'Payment purpose — used for behavioural context. Optional.'}, 'amountUsd': {'type': 'number', 'description': 'Transaction amount — used for velocity profiling. Optional.'}}}

{'type': 'object', 'properties': {'decision': {'type': 'string', 'description': 'CLEAR / REVIEW / BLOCK'}, 'narrative': {'type': 'string', 'description': 'Structured compliance narrative for audit record.'}, 'confidence': {'type': 'number', 'description': 'Decision confidence 0–1.'}, 'behavioural': {'type': 'object', 'description': 'Velocity flags, counterparty network risk, anomaly signals.'}, 'sanctionHits': {'type': 'array', 'description': 'Matched sanctions list entries with list name and match score.'}}}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Full name to screen (e.g. "Mario Draghi").'}, 'country': {'type': 'string', 'description': 'ISO-2 country code to narrow the search (e.g. "IT"). Optional.'}}}

{'type': 'object', 'properties': {'matched': {'type': 'boolean'}, 'matches': {'type': 'array', 'description': 'Per match: caption, datasets, position, nationality, birthDate, relatedEntities, riskLevel, matchScore'}, 'overallRisk': {'enum': ['HIGH', 'MEDIUM', 'LOW', 'NONE'], 'type': 'string'}, 'totalMatches': {'type': 'number'}, 'fatfCompliance': {'type': 'object', 'description': 'EDD required flag, FATF R.12/13 attestation, note'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'inEffect': {'type': 'array', 'description': 'Currently active requirements, most recent first'}, 'upcoming': {'type': 'array', 'description': 'Events not yet in effect, sorted by effective date ascending'}, 'dpxAlignment': {'type': 'object', 'description': 'Per-framework mapping to DPX endpoints that satisfy each obligation'}}}

{'type': 'object', 'required': ['entities'], 'properties': {'entities': {'type': 'array', 'items': {'type': 'string'}, 'description': 'LEIs, wallet addresses, or company names. Max 50.'}, 'reportDate': {'type': 'string', 'description': 'ISO date for the report reference period (default: today).'}}}

{'type': 'object', 'properties': {'paiTable': {'type': 'array', 'description': 'SFDR Annex I table rows — indicator, value, unit, data source, coverage.'}, 'synthesis': {'type': 'string', 'description': 'Narrative for the PAI statement.'}, 'portfolioScore': {'type': 'number', 'description': 'Aggregate PAI composite score 0–100.'}}}

{'type': 'object', 'required': ['entity'], 'properties': {'entity': {'type': 'string', 'description': 'LEI or wallet address of the entity to screen.'}, 'articleTarget': {'enum': ['6', '8', '9'], 'type': 'string', 'description': 'Target SFDR article classification to assess against. Default: "8".'}}}

{'type': 'object', 'properties': {'dnsh': {'type': 'object', 'description': 'Do No Significant Harm assessment across 6 environmental objectives.'}, 'paiFlags': {'type': 'array', 'description': '18 mandatory PAI indicators with flag, value, threshold, and pass/fail.'}, 'synthesis': {'type': 'string', 'description': 'Plain-language SFDR compliance narrative.'}, 'classification': {'type': 'string', 'description': 'Article 6 / 8 / 9 classification result.'}}}

{'type': 'object', 'required': ['lei'], 'properties': {'lei': {'type': 'string', 'description': '20-character GLEIF LEI of the entity to trace (e.g. "2594007XIACKNMUAW223").'}, 'deep': {'type': 'boolean', 'description': 'Set true to attempt 3-level traversal including intermediate nodes. Default false (direct + ultimate parent only).'}}}

{'type': 'object', 'properties': {'chain': {'type': 'array', 'description': 'Per-node: level, role, lei, entityName, country, leiStatus, sanctions (matched, score, datasets), riskFlag'}, 'fatfR16': {'type': 'object', 'description': 'FATF R.16 beneficial ownership compliance attestation'}, 'riskFlags': {'type': 'array', 'description': 'Nodes with sanctions hits or lapsed LEIs'}, 'chainDepth': {'type': 'number'}, 'overallStatus': {'enum': ['CLEAR', 'REVIEW_REQUIRED', 'BLOCKED'], 'type': 'string'}, 'ultimateBeneficialOwner': {'type': 'object', 'description': 'lei, entityName, country, leiStatus of the UBO'}}}

{'type': 'object', 'required': ['entity'], 'properties': {'entity': {'type': 'string', 'description': 'LEI, wallet address, or company name of the vendor.'}, 'amountUsd': {'type': 'number', 'description': 'Payment amount in USD — scales the risk threshold (larger payments trigger higher scrutiny). Optional.'}}}

{'type': 'object', 'properties': {'flags': {'type': 'array', 'description': 'Active risk flags with severity and source.'}, 'esgScore': {'type': 'number', 'description': 'ESG composite 0–100.'}, 'riskTier': {'type': 'string', 'description': 'LOW / MEDIUM / HIGH / CRITICAL'}, 'synthesis': {'type': 'string', 'description': 'Plain-language vendor risk narrative.'}, 'recommendation': {'type': 'string', 'description': 'PROCEED / PROCEED_WITH_MONITORING / HOLD / BLOCK'}, 'complianceScore': {'type': 'number', 'description': 'AML/sanctions/PEP composite 0–100.'}}}

{'type': 'object', 'required': ['walletAddress'], 'properties': {'expectedLei': {'type': 'string', 'description': 'Expected LEI for exact-match verification. Optional.'}, 'expectedName': {'type': 'string', 'description': 'Expected legal entity name for name-match verification. Optional.'}, 'walletAddress': {'type': 'string', 'description': 'Payee wallet address to verify.'}}}

{'type': 'object', 'properties': {'verified': {'type': 'boolean', 'description': 'True if payee identity confirmed.'}, 'confidence': {'type': 'number', 'description': 'Match confidence 0–1.'}, 'attestation': {'type': 'string', 'description': 'Signed verification receipt for audit.'}, 'identityFields': {'type': 'object', 'description': 'Confirmed fields: lei, entityName, jurisdiction, esgTier.'}}}

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'description': 'Description of the task — e.g. "summarize a financial document", "write Python code", "translate from French", "reason through a math problem".'}, 'speed': {'type': 'boolean', 'description': 'true = prefer fastest model over most capable. Default false.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'required': ['task'], 'properties': {'task': {'type': 'string', 'description': 'Plain-language description of what the model should do. Used for model selection.'}, 'messages': {'type': 'array', 'description': 'Optional. Full message array in OpenAI format [{role, content}]. If omitted, task is sent as a user message.'}, 'preferSpeed': {'type': 'boolean', 'description': 'true = use the fastest available free model regardless of task type. Default false.'}}}

{'type': 'object', 'required': ['screen_context', 'amount', 'recipient_address', 'purpose'], 'properties': {'amount': {'type': 'number', 'description': 'Payment amount in USD as shown on screen'}, 'purpose': {'type': 'string', 'description': 'Payment purpose — e.g. vendor-invoice, contractor-payment, subscription, procurement'}, 'sandbox': {'type': 'boolean', 'description': 'Set false for live execution. Default: true'}, 'screen_context': {'type': 'string', 'description': 'Describe what is visible on screen — the payment form, vendor name, invoice number, or UI context. Used for audit trail.'}, 'counterparty_name': {'type': 'string', 'description': 'Vendor or payee name as shown on screen'}, 'recipient_address': {'type': 'string', 'description': 'Recipient wallet address (0x...). If only bank/email visible, use settlement.nl instead.'}}}

{'type': 'object', 'properties': {'feeUsd': {'type': 'number'}, 'netUsd': {'type': 'number'}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}, 'txHash': {'type': 'string'}, 'decision': {'enum': ['EXECUTED', 'ABORTED', 'HOLD', 'BLOCKED'], 'type': 'string'}, 'aiDecision': {'type': 'string'}, 'aiConfidence': {'type': 'number'}, 'settlementId': {'type': 'string'}}}

{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'description': 'Optional keyword filter across term, definition, and category (e.g. "collateral", "governance").'}}}

{'type': 'object', 'properties': {'count': {'type': 'number'}, 'label': {'type': 'string'}, 'records': {'type': 'array', 'description': 'Per term: id, term, definition, category, source'}}}

{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'description': 'Optional keyword filter across title, organization, summary, and category (e.g. "mBridge", "reserve").'}}}

{'type': 'object', 'properties': {'count': {'type': 'number'}, 'label': {'type': 'string'}, 'records': {'type': 'array', 'description': 'Per paper: id, title, author, organization, date, category, summary, key_findings, source'}}}

{'type': 'object', 'required': [], 'properties': {'window': {'enum': ['7d', '30d'], 'type': 'string', 'description': 'Time window for metrics. "7d" = last 7 days, "30d" = last 30 days. Default: 30d.'}}}

{'type': 'object', 'properties': {'window': {'type': 'string'}, 'peakDay': {'type': 'object'}, 'summary': {'type': 'string'}, 'services': {'type': 'array'}, 'errorRate': {'type': 'string'}, 'weeklyTrend': {'type': 'array'}, 'dailyAverage': {'type': 'number'}, 'totalRequests': {'type': 'number'}}}

{'type': 'object', 'required': [], 'properties': {'leis': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of LEIs to screen (fastest path — no GLEIF resolution needed).'}, 'names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of company names to screen (resolved via GLEIF — slower, allows ≤3s per name).'}}}

{'type': 'object', 'properties': {'total': {'type': 'number'}, 'failed': {'type': 'number'}, 'results': {'type': 'array', 'description': 'Entities sorted by composite score descending. Each item includes lei, entityName, score object, or an error note.'}, 'succeeded': {'type': 'number'}}}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Company name, domain, or ticker to look up (e.g. "Apple Inc", "siemens.com", "MSFT")'}, 'country': {'type': 'string', 'description': 'ISO-2 country code to narrow results (e.g. "US", "DE"). Optional but improves match accuracy.'}, 'narrate': {'type': 'boolean', 'description': 'Set true to include a 2–3 sentence plain-English compliance narrative generated by the AI synthesis layer.'}}}

{'type': 'object', 'properties': {'found': {'type': 'boolean'}, 'score': {'type': 'object', 'description': 'Full ESG score object with composite, environmental, social, governance, feeTier, feeSurcharge, sources, coverage'}, 'resolved': {'type': 'object', 'properties': {'lei': {'type': 'string'}, 'country': {'type': 'string'}, 'leiStatus': {'type': 'string'}, 'entityName': {'type': 'string'}}}, 'narration': {'type': 'string', 'description': 'Plain-language compliance narrative (only when narrate=true)'}}}

{'type': 'object', 'required': [], 'properties': {'leis': {'type': 'array', 'items': {'type': 'string'}, 'description': 'LEIs to score (fastest — no name resolution).'}, 'label': {'type': 'string', 'description': 'Optional label for this portfolio (e.g. "Q3 2026 Counterparties").'}, 'names': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Company names to score (GLEIF-resolved).'}}}

{'type': 'object', 'properties': {'label': {'type': 'string'}, 'entities': {'type': 'object', 'properties': {'total': {'type': 'number'}, 'failed': {'type': 'number'}, 'scored': {'type': 'number'}}}, 'portfolio': {'type': 'object', 'description': 'composite, environmental, social, governance, tier, avgFeeSurcharge, totalFeeImpactBps'}, 'compliance': {'type': 'object', 'description': 'micaArticle72, highRiskCount, sfdr flags'}, 'distribution': {'type': 'object', 'description': 'byTier counts, min, max, median'}, 'topPerformers': {'type': 'array'}, 'worstOffenders': {'type': 'array', 'description': 'Bottom 10% entities with weakest pillar identified'}}}

{'type': 'object', 'required': [], 'properties': {'address': {'type': 'string', 'description': 'Wallet address (0x...) to score. Omit for protocol default.'}}}

{'type': 'object', 'properties': {'tier': {'type': 'string', 'description': 'ESG tier label'}, 'feePct': {'type': 'number', 'description': 'ESG fee percentage applied at settlement'}, 'social': {'type': 'number', 'description': 'Social score 0–100'}, 'address': {'type': 'string', 'description': 'Scored wallet address or "default"'}, 'sources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Data sources used'}, 'esgScore': {'type': 'number', 'description': 'Composite ESG score 0–100'}, 'updatedAt': {'type': 'string', 'description': 'ISO 8601 last update timestamp'}, 'governance': {'type': 'number', 'description': 'Governance score 0–100'}, 'environmental': {'type': 'number', 'description': 'Environmental score 0–100'}}}

{'type': 'object', 'required': ['entity'], 'properties': {'depth': {'type': 'number', 'description': 'Supply chain depth to trace (1 = direct suppliers, 2 = tier-2). Default 1. Max 2.'}, 'entity': {'type': 'string', 'description': 'LEI or wallet address of the focal company.'}}}

{'type': 'object', 'properties': {'tiers': {'type': 'array', 'description': 'Per-tier: nodes, avgEsgScore, highRiskNodes, sfdrPaiFlags.'}, 'synthesis': {'type': 'string', 'description': 'Plain-language supply chain ESG narrative.'}, 'scope3Estimate': {'type': 'object', 'description': 'PCAF Scope 3 Category 1 estimate — attributed emissions.'}, 'supplyChainScore': {'type': 'number', 'description': 'Aggregate supply chain ESG composite 0–100.'}}}

{'type': 'object', 'required': ['lei'], 'properties': {'lei': {'type': 'string', 'description': '20-character GLEIF LEI.'}, 'days': {'type': 'number', 'description': 'Lookback window in days (7–365). Default 90.'}}}

{'type': 'object', 'properties': {'lei': {'type': 'string'}, 'days': {'type': 'number'}, 'delta': {'type': 'number', 'description': 'Score change over the window (positive = improving)'}, 'trend': {'enum': ['IMPROVING', 'STABLE', 'DETERIORATING'], 'type': 'string'}, 'current': {'type': 'number'}, 'history': {'type': 'array'}, 'baseline': {'type': 'number'}, 'dataPoints': {'type': 'number'}}}

{'type': 'object', 'required': ['lei', 'webhookUrl'], 'properties': {'lei': {'type': 'string', 'description': '20-character GLEIF LEI of the entity to monitor.'}, 'webhookUrl': {'type': 'string', 'description': 'HTTPS URL to POST score change alerts to. Must be HTTPS.'}, 'thresholdPoints': {'type': 'number', 'description': 'Fire webhook if composite score changes by ≥ N points. Default 5. Minimum 1.'}}}

{'type': 'object', 'properties': {'lei': {'type': 'string'}, 'watchId': {'type': 'string', 'description': 'UUID — use to check status (GET /esg/watch/:id) or cancel (DELETE /esg/watch/:id)'}, 'createdAt': {'type': 'string'}, 'entityName': {'type': 'string'}, 'baselineTier': {'type': 'string'}, 'baselineScore': {'type': 'number', 'description': 'Composite score at registration (used as first comparison point)'}}}

{'type': 'object', 'required': ['amountUsd'], 'properties': {'hasFx': {'type': 'boolean', 'description': 'Cross-currency? Adds 0.40% FX fee.'}, 'esgScore': {'type': 'number', 'description': 'ESG score 0–100'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD'}}}

{'type': 'object', 'properties': {'dpx': {'type': 'object', 'properties': {'rate': {'type': 'string'}, 'feeUsd': {'type': 'number'}}}, 'note': {'type': 'string', 'description': 'Context note on comparison methodology'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount compared'}, 'comparison': {'type': 'object', 'description': 'Per-competitor comparison keyed by competitor ID', 'additionalProperties': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rate': {'type': 'string'}, 'feeUsd': {'type': 'number'}, 'dpxCheaper': {'type': 'boolean'}, 'dpxSavings': {'type': 'number'}}}}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'fees': {'type': 'object', 'properties': {'fx': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'description': {'type': 'string'}}}, 'esg': {'type': 'object', 'properties': {'max': {'type': 'number'}, 'min': {'type': 'number'}}}, 'core': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'description': {'type': 'string'}}}, 'license': {'type': 'object', 'properties': {'pct': {'type': 'number'}}}}, 'description': 'Fee component definitions'}, 'tiers': {'type': 'object', 'description': 'Volume discount tiers', 'additionalProperties': True}, 'examples': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Fee calculation examples'}, 'benchmarks': {'type': 'object', 'description': 'Competitor fee benchmarks', 'additionalProperties': True}}}

{'type': 'object', 'required': ['amountUsd'], 'properties': {'hasFx': {'type': 'boolean', 'description': 'Cross-currency settlement?'}, 'esgScore': {'type': 'number', 'description': 'ESG score 0–100'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD'}}}

{'type': 'object', 'properties': {'delta': {'type': 'number', 'description': 'Absolute difference in basis points'}, 'feesMatch': {'type': 'boolean', 'description': 'True if off-chain quote matches on-chain contract'}, 'onChainFee': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'offChainFee': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'recommendation': {'type': 'string', 'description': 'PROCEED | INVESTIGATE'}}}

{'type': 'object', 'required': ['amount'], 'properties': {'to': {'type': 'string', 'description': 'Destination currency code (default: USD)'}, 'lei': {'type': 'string', 'description': 'Counterparty LEI for enhanced compliance check (optional)'}, 'from': {'type': 'string', 'description': 'Source currency code (default: USD)'}, 'amount': {'type': 'number', 'description': 'Settlement amount in source currency'}, 'address': {'type': 'string', 'description': 'Counterparty wallet address for compliance screen (optional but recommended)'}}}

{'type': 'object', 'properties': {'ready': {'type': 'boolean', 'description': 'True when decision is PROCEED'}, 'token': {'type': 'string', 'description': 'Recommended stablecoin (USDC, EURC, or USDT)'}, 'oracle': {'type': 'object', 'additionalProperties': True}, 'decision': {'type': 'string', 'description': 'PROCEED | HOLD | BLOCKED'}, 'compliance': {'type': 'object', 'additionalProperties': True}, 'settleBody': {'type': 'object', 'description': 'Ready to POST to /settle (null if BLOCKED or HOLD)', 'additionalProperties': True}, 'ttlSeconds': {'type': 'number'}, 'estimatedNetUsd': {'type': 'number', 'description': 'Estimated net received after all fees'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'calendar': {'type': 'array', 'description': 'Seasonal events sorted by urgency — active events first'}, 'currentMonth': {'type': 'number', 'description': 'Current UTC month (1–12) for reference'}}}

{'type': 'object', 'required': ['symbol'], 'properties': {'fresh': {'type': 'boolean', 'default': False, 'description': 'true = bypass 4h cache and recompute live signals'}, 'symbol': {'enum': ['WHEAT', 'CORN', 'SOYB', 'COFFEE', 'COCOA', 'COTTON', 'SUGAR', 'WTI', 'NG', 'COPPER', 'LUMBER'], 'type': 'string', 'description': 'Commodity symbol'}}}

{'type': 'object', 'properties': {'name': {'type': 'string'}, 'signal': {'enum': ['STRONGLY_BEARISH', 'BEARISH', 'NEUTRAL', 'BULLISH', 'STRONGLY_BULLISH'], 'type': 'string'}, 'symbol': {'type': 'string'}, 'regions': {'type': 'array', 'description': 'Per production-region climate scores and drought/temperature readings'}, 'horizons': {'type': 'object', 'description': '30d / 60d / 90d — each has signal, confidence, basis'}, 'reasoning': {'type': 'string', 'description': 'Plain-language synthesis of climate signals and price implications'}, 'stressors': {'type': 'array', 'description': 'Active climate stressors with severity, region, price impact estimate, probability'}, 'confidence': {'type': 'number', 'description': 'Signal confidence 0–1'}, 'climateScore': {'type': 'number', 'description': 'Supply constraint pressure 0–100; >65 = elevated bullish pressure'}, 'currentPrice': {'type': 'object', 'description': 'Latest FRED price reference (value, unit, date)'}, 'forecastedAt': {'type': 'string'}, 'recommendation': {'enum': ['REDUCE', 'UNDERWEIGHT', 'HOLD', 'MONITOR', 'BUILD'], 'type': 'string'}, 'inGrowingSeason': {'type': 'boolean', 'description': 'true = stressors in peak transmission window — act faster'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'summary': {'type': 'string', 'description': 'Plain-language summary of which markets are most stressed.'}, 'symbols': {'type': 'array', 'description': 'Per-symbol: symbol, signal (RED/YELLOW/GREEN), urgency, primaryDriver, score.'}}}

{'type': 'object', 'required': ['positions'], 'properties': {'positions': {'type': 'array', 'items': {'type': 'object', 'required': ['symbol', 'weight'], 'properties': {'symbol': {'enum': ['WHEAT', 'CORN', 'SOYB', 'COFFEE', 'COCOA', 'COTTON', 'SUGAR', 'WTI', 'NG', 'COPPER', 'LUMBER'], 'type': 'string'}, 'weight': {'type': 'number', 'description': 'Portfolio weight — any positive number; normalized to sum to 1.0'}}}, 'maxItems': 20, 'description': 'Portfolio positions with symbol and weight'}}}

{'type': 'object', 'properties': {'summary': {'type': 'string'}, 'positions': {'type': 'array', 'description': 'Per-position signal and climate score'}, 'dominantRisk': {'type': 'string', 'description': 'Most climate-stressed position'}, 'hedgeCandidates': {'type': 'array', 'description': 'Symbols with climateScore ≤ 35 — potential climate hedges'}, 'stressedPositions': {'type': 'array', 'description': 'Symbols with climateScore ≥ 65'}, 'portfolioClimateScore': {'type': 'number', 'description': 'Weighted aggregate climate stress 0–100'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'regions': {'type': 'array', 'description': 'Regions sorted by climate risk score, with affected commodities and risk level'}, 'updatedAt': {'type': 'string'}}}

{'type': 'object', 'properties': {'symbols': {'type': 'array', 'items': {'enum': ['WHEAT', 'CORN', 'SOYB', 'COFFEE', 'COCOA', 'COTTON', 'SUGAR', 'WTI', 'NG', 'COPPER', 'LUMBER'], 'type': 'string'}, 'description': 'Symbols to analyze — omit for all 11'}, 'scenario': {'enum': ['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'], 'type': 'string', 'description': 'Built-in scenario ID — or omit and provide stressorOverrides'}, 'stressorOverrides': {'type': 'object', 'properties': {'frostMultiplier': {'type': 'number'}, 'stormMultiplier': {'type': 'number'}, 'droughtMultiplier': {'type': 'number'}, 'wildfireMultiplier': {'type': 'number'}, 'temperatureMultiplier': {'type': 'number'}}, 'description': 'Custom multipliers if not using a named scenario (1.0 = no change)'}}}

{'type': 'object', 'properties': {'results': {'type': 'array', 'description': 'Per-commodity signal, climateScore, recommendation, topStressor, reasoning'}, 'scenario': {'type': 'string'}, 'description': {'type': 'string'}, 'portfolioImpact': {'type': 'object', 'description': 'mostImpacted, leastImpacted, averageClimateScore'}}}

{'type': 'object', 'required': ['webhookUrl', 'symbols'], 'properties': {'alertOn': {'enum': ['signal_change', 'confidence_drop', 'climate_stress'], 'type': 'string', 'description': 'Trigger type. signal_change = any BULLISH/BEARISH/NEUTRAL flip. confidence_drop = confidence falls below threshold. climate_stress = climateScore crosses level. Default: signal_change.'}, 'symbols': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Commodity symbols to monitor. E.g. ["WHEAT", "WTI"]. Use ["*"] for all 11.'}, 'threshold': {'type': 'number', 'description': 'For confidence_drop: minimum confidence floor (0–1). For climate_stress: score level (0–100). Not used for signal_change.'}, 'webhookUrl': {'type': 'string', 'description': 'HTTPS URL to receive POST alerts.'}}}

{'type': 'object', 'properties': {'alertOn': {'type': 'string'}, 'symbols': {'type': 'array'}, 'webhookUrl': {'type': 'string'}, 'subscriptionId': {'type': 'string', 'description': 'Subscription ID for updates and cancellation.'}}}

{'type': 'object', 'required': ['portfolio'], 'properties': {'horizon': {'enum': ['30d', '60d', '90d'], 'type': 'string', 'description': 'Forecast horizon for risk assessment. Default 90d.'}, 'portfolio': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Array of {symbol: "WHEAT", positionUsd: 500000}. Symbols: WHEAT · CORN · SOYB · COFFEE · COCOA · COTTON · SUGAR · WTI · NG · COPPER · LUMBER.'}}}

{'type': 'object', 'properties': {'disclosure': {'type': 'string', 'description': 'Draft TCFD disclosure narrative for the portfolio.'}, 'physicalRisk': {'type': 'object', 'description': 'Acute and chronic physical risk scores per commodity, mapped to TCFD categories.'}, 'portfolioScore': {'type': 'number', 'description': 'Aggregate TCFD physical risk score 0–100.'}, 'transitionRisk': {'type': 'object', 'description': 'Policy, technology, market, and reputation transition risk signals.'}}}

{'type': 'object', 'required': [], 'properties': {'from': {'type': 'string', 'description': 'Optional: filter to corridors starting from this currency (e.g. USD)'}}}

{'type': 'object', 'properties': {'summary': {'type': 'object', 'description': 'Count by tier: OPTIMAL / FAVORABLE / CAUTION / ELEVATED_RISK / ADVERSE'}, 'corridors': {'type': 'array', 'description': 'Corridors sorted best-first with score, tier, vol, regulatory flags'}, 'corridorCount': {'type': 'number'}}}

{'type': 'object', 'required': ['from', 'to', 'amount'], 'properties': {'to': {'type': 'string', 'description': 'Target currency ISO 4217 (e.g. BRL)'}, 'lei': {'type': 'string', 'description': 'Optional counterparty LEI for ESG-adjusted fee tier'}, 'from': {'type': 'string', 'description': 'Source currency ISO 4217 (e.g. USD)'}, 'amount': {'type': 'number', 'description': 'Amount to send'}, 'amountCurrency': {'type': 'string', 'description': 'Currency of the amount (defaults to from)'}}}

{'type': 'object', 'properties': {'railFees': {'type': 'object', 'description': 'All-in fee breakdown in USD'}, 'settlement': {'type': 'object', 'description': 'Sent and received amounts with live FX rate'}, 'costCertainty': {'type': 'object', 'description': '48h volatility, uncertainty in USD, received range in target currency'}, 'corridorIntelligence': {'type': 'object', 'description': 'Corridor stability score, regulatory flags, cascade level'}, 'executionRecommendation': {'type': 'object', 'description': 'SETTLE_NOW / DELAY_24H / DELAY_48H with best execution window UTC'}}}

{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Target currency ISO 4217 code (e.g. BRL)'}, 'from': {'type': 'string', 'description': 'Source currency ISO 4217 code (e.g. USD)'}}}

{'type': 'object', 'properties': {'ask': {'type': 'number'}, 'bid': {'type': 'number'}, 'mid': {'type': 'number', 'description': 'Mid-market rate (from → to)'}, 'pair': {'type': 'string'}, 'spreadPct': {'type': 'number', 'description': 'Implied interbank spread %'}, 'updatedAt': {'type': 'string'}, 'corridorFlags': {'type': 'array', 'description': 'Regulatory flags for this corridor'}, 'dailyVolatilityPct': {'type': 'number', 'description': 'Estimated daily FX volatility %'}}}

{'type': 'object', 'required': ['paymentInstruction'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'If true, oracle and compliance run live but no on-chain execution. Default true.'}, 'oauthToken': {'type': 'string', 'description': "Client's Kyriba OAuth bearer token. Never stored by DPX."}, 'paymentInstruction': {'type': 'object', 'description': 'Kyriba SPI payment instruction object — amount, currency, counterparty, valueDate.'}}}

{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'AUTHORIZED / SANDBOX / HELD / REVIEW / FAILED'}, 'execution': {'type': 'object', 'description': 'On-chain execution params (sender-funded — client calls approve() + settle()).'}, 'kyribaRef': {'type': 'string', 'description': 'Kyriba-format confirmation reference.'}, 'settlementId': {'type': 'string', 'description': 'DPX settlement ID.'}}}

{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'verificationId returned by integration.verify.'}}}

{'type': 'object', 'properties': {'id': {'type': 'string'}, 'status': {'enum': ['pending', 'verified', 'expired'], 'type': 'string', 'description': 'Current verification state.'}, 'txHash': {'type': 'string', 'description': 'Transaction hash of the $0.01 payment. Present when verified.'}, 'message': {'type': 'string'}, 'explorer': {'type': 'string', 'description': 'Basescan URL for the verification transaction.'}, 'verifiedAt': {'type': 'string', 'description': 'ISO timestamp of on-chain confirmation. Present when status is "verified".'}, 'walletAddress': {'type': 'string'}}}

{'type': 'object', 'required': ['originatorAddress', 'beneficiaryAddress', 'amountUsd'], 'properties': {'purpose': {'type': 'string', 'description': 'Payment purpose code.'}, 'amountUsd': {'type': 'number', 'description': 'Transfer amount in USD.'}, 'originatorLei': {'type': 'string', 'description': 'Originator LEI. Optional.'}, 'beneficiaryLei': {'type': 'string', 'description': 'Beneficiary LEI. Optional.'}, 'originatorName': {'type': 'string', 'description': 'Legal name of originator entity. Optional if LEI provided.'}, 'beneficiaryName': {'type': 'string', 'description': 'Legal name of beneficiary entity. Optional if LEI provided.'}, 'originatorAddress': {'type': 'string', 'description': 'Originator wallet address.'}, 'beneficiaryAddress': {'type': 'string', 'description': 'Beneficiary wallet address.'}}}

{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'RECORDED / TRANSMITTED / PENDING_ACK'}, 'attestation': {'type': 'string', 'description': 'Signed compliance attestation.'}, 'travelRuleId': {'type': 'string', 'description': 'FATF R16 Travel Rule record ID.'}}}

{'type': 'object', 'required': ['walletAddress'], 'properties': {'apiKey': {'type': 'string', 'description': 'Optional: the DPX API key being registered for this integration. Stored as a hash — never logged in plaintext.'}, 'walletAddress': {'type': 'string', 'description': 'The client wallet address (0x...) that will send the $0.01 verification payment.'}}}

{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'Always "pending" on creation.'}, 'payment': {'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'DPX treasury address to send USDC to.'}, 'amount': {'type': 'string', 'description': 'Amount in USDC (0.01).'}, 'network': {'type': 'string', 'description': 'base-mainnet'}}}, 'polling': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'timeoutAt': {'type': 'string'}, 'intervalSeconds': {'type': 'number'}}}, 'expiresAt': {'type': 'string', 'description': 'ISO timestamp — verification window closes after 24 hours.'}, 'verificationId': {'type': 'string', 'description': 'Session ID — use with integration.status to poll for payment confirmation.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'topRisks': {'type': 'array', 'description': 'Top 3 risks for next 48h: event, probability, impact, corridorsAffected.'}, 'synthesis': {'type': 'string', 'description': 'Full AI narrative.'}, 'corridorAdvice': {'type': 'object', 'description': 'Per major corridor: SETTLE_NOW / DELAY / AVOID + rationale.'}, 'executionWindow': {'type': 'object', 'description': 'Best 4h window in next 48h: startUtc, endUtc, compositeScore, rationale.'}, 'settlementAdvice': {'type': 'string', 'description': 'Go / No-go / Conditional with conditions.'}}}

{'type': 'object', 'required': ['origin', 'magnitude'], 'properties': {'origin': {'type': 'string', 'description': 'Origin node ID from the primary cascade (e.g. "geo.conflict", "climate.drought").'}, 'eventType': {'type': 'string', 'description': 'Description of the primary event.'}, 'magnitude': {'type': 'number', 'description': 'Primary shock magnitude 1–100.'}, 'elapsedHours': {'type': 'number', 'description': 'Hours elapsed since the primary event. Default 24.'}, 'horizonHours': {'type': 'number', 'description': 'Forward horizon to model in hours. Default 4320 (6 months).'}}}

{'type': 'object', 'properties': {'wave1': {'type': 'object', 'description': 'Immediate (0–72h): rebound, amplified, structural nodes.'}, 'wave2': {'type': 'object', 'description': 'Policy response phase (1–4 weeks).'}, 'wave3': {'type': 'object', 'description': 'Structural lock-in (1–6 months).'}, 'synthesis': {'type': 'string'}}}

{'type': 'object', 'required': ['originNode'], 'properties': {'magnitude': {'type': 'number', 'description': 'Shock severity 1–10. Default 5.'}, 'originNode': {'type': 'string', 'description': 'Originating system node. Climate: drought, flood, carbon_price, wildfire, sea_level, heatwave. Geopolitical: sanctions, conflict, tariffs, regime_change, election, port_blockade. Economic: rate_decision, inflation, sovereign_debt, banking_stress, currency_crisis, recession. Commodity: oil, gas, grain, rare_earth, copper, water, fertilizer.'}, 'elapsedHours': {'type': 'number', 'description': 'Hours since event origin — positions the propagation wave front. Default 0.'}}}

{'type': 'object', 'properties': {'nodeMap': {'type': 'object', 'description': 'Full 25-node state after propagation.'}, 'synthesis': {'type': 'string', 'description': 'AI briefing on highest-impact transmission paths and concentrated risk.'}, 'cascadeChain': {'type': 'array', 'description': 'Time-ordered nodes hit: node, lag_hours, attenuatedMagnitude, transmissionPath.'}}}

{'type': 'object', 'required': [], 'properties': {'signals': {'type': 'array', 'items': {'enum': ['climate', 'climate-pulse', 'earth-systems'], 'type': 'string'}, 'description': 'Subset of signals to return. Omit for all three.'}}}

{'type': 'object', 'properties': {'climate': {'type': 'object', 'description': 'agriculturalZones, precipitationShift, foodInflationSignal, migrationPressure, synthesis.'}, 'climatePulse': {'type': 'object', 'description': 'regions, temperatureAnomaly, droughtIndex, heatwaveRisk, cropStressSignal.'}, 'earthSystems': {'type': 'object', 'description': 'earthHealthIndex, tippingPoints (9), proximityScores, catastropheRisk, synthesis.'}}}

{'type': 'object', 'required': [], 'properties': {'format': {'enum': ['json', 'report'], 'type': 'string', 'description': 'json = machine-readable risk register (default). report = executive summary narrative via intelligence.synthesis endpoint.'}}}

{'type': 'object', 'properties': {'outlook': {'type': 'object', 'description': '30d, 60d, 90d macro regime probability.'}, 'synthesis': {'type': 'string', 'description': 'Full AI synthesis narrative.'}, 'riskRegister': {'type': 'array', 'description': 'Ranked active risks: domain, severity, confidence, signals, outlook.'}, 'compositeScore': {'type': 'number', 'description': 'Single 0–100 global macro risk score.'}, 'corridorGuidance': {'type': 'object', 'description': 'Per-corridor settlement recommendation based on composite signal.'}}}

{'type': 'object', 'required': [], 'properties': {'origin': {'type': 'string', 'description': 'Origin node ID. Call intelligence.contagion with listNodes:true to discover valid IDs.'}, 'listNodes': {'type': 'boolean', 'description': 'If true, returns all valid origin node IDs instead of running a simulation.'}, 'magnitude': {'type': 'number', 'description': 'Initial shock magnitude 1–100.'}}}

{'type': 'object', 'properties': {'systemR': {'type': 'number', 'description': 'System-level R value. ≥1.0 means spreading.'}, 'spreadMap': {'type': 'array', 'description': 'Per-epoch infection state across all nodes.'}, 'synthesis': {'type': 'string'}, 'containment': {'type': 'object', 'description': 'Forecast of when/if containment is achieved.'}, 'superspreaders': {'type': 'array', 'description': 'Nodes with highest R contribution.'}}}

{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'description': 'Wallet address or LEI of the entity/portfolio to report on.'}, 'signals': {'type': 'array', 'items': {'enum': ['sfdr', 'financed-emissions', 'taxonomy', 'tnfd'], 'type': 'string'}, 'description': 'Subset of reports to generate. Omit for all four.'}}}

{'type': 'object', 'properties': {'sfdr': {'type': 'object', 'description': 'SFDR PAI indicators table — 18 mandatory + 2 optional climate indicators.'}, 'tnfdReport': {'type': 'object', 'description': 'TNFD LEAP — locate (dependencies/impacts), evaluate (materiality), assess (scenarios), prepare (metrics).'}, 'financedEmissions': {'type': 'object', 'description': 'PCAF Scope 3 Cat 15 — attributed emissions, data quality score, CSRD flag.'}, 'taxonomyAlignment': {'type': 'object', 'description': 'EU Taxonomy — aligned %, per-objective DNSH assessment, eligibility map.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'countries': {'type': 'array', 'description': 'Per-country: gbvRiskScore, opportunityScore, LFPR gap, WBL index, GDP per capita, transmission mechanisms.'}, 'synthesis': {'type': 'string'}, 'regionalSummary': {'type': 'object'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'instability': {'type': 'object', 'description': 'Per-region (US/China/Russia/EU): stabilityScore, regimeRisk, keyRisks, synthesis.'}, 'macroStress': {'type': 'object', 'description': 'regime, score 0–100, creditSpreads, yieldCurve, signals, fxLeadSignal, synthesis.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'waterRisk': {'type': 'object', 'description': 'regions (6), stressScore, sectorExposure, tnfdAlignment, synthesis.'}, 'biodiversity': {'type': 'object', 'description': 'regions (8), iucnSignals, sectorDependency, sectorImpact, sfdrPai7, synthesis.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'politicalRisk': {'type': 'object', 'description': 'Per-region: regimeStability, policyRisk, sanctionsExposure, corridorImpact, synthesis.'}, 'transitionRisk': {'type': 'object', 'description': 'carbonPriceExposure, strandedAssetRisk, policyVelocity, sectorImpacts, synthesis.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'synthesis': {'type': 'string'}, 'dangerZoneMatch': {'type': 'object', 'description': 'Similarity to historical crisis resonance patterns.'}, 'resonanceClusters': {'type': 'array', 'description': 'Groups of 3+ signals in mutual resonance.'}, 'amplificationFactor': {'type': 'number', 'description': 'Constructive interference gain across dominant cluster.'}, 'systemResonanceScore': {'type': 'number', 'description': '0–100. Higher = more dangerous in-phase alignment.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'sovereignDebt': {'type': 'object', 'description': 'perCountry: debtGdpRatio, yieldDynamic, defaultRisk, contagionRisk. systemicScore, synthesis.'}, 'currencyStress': {'type': 'object', 'description': 'dollarRegime, g10Scores, emScores, capitalFlowDirection, corridorImpact, synthesis.'}}}

{'type': 'object', 'required': ['webhookUrl', 'threshold'], 'properties': {'label': {'type': 'string', 'description': 'Optional label for your own tracking.'}, 'signal': {'enum': ['stability', 'cascade', 'macro_stress', 'climate', 'fx', 'any'], 'type': 'string', 'description': 'Signal to monitor. Default: stability.'}, 'direction': {'enum': ['above', 'below'], 'type': 'string', 'description': 'Fire when signal goes above or below threshold. Default: above.'}, 'threshold': {'type': 'number', 'description': 'Score value (0–100) that triggers the webhook.'}, 'webhookUrl': {'type': 'string', 'description': 'HTTPS URL to POST alerts to.'}}}

{'type': 'object', 'properties': {'signal': {'type': 'string'}, 'deleteUrl': {'type': 'string'}, 'direction': {'type': 'string'}, 'statusUrl': {'type': 'string'}, 'threshold': {'type': 'number'}, 'currentScore': {'type': 'number', 'description': 'Signal score at registration time'}, 'subscriptionId': {'type': 'string'}}}

{'type': 'object', 'required': ['subscriptionId'], 'properties': {'subscriptionId': {'type': 'string', 'description': 'UUID returned by intelligence.subscribe.'}}}

{'type': 'object', 'properties': {'deleted': {'type': 'boolean'}, 'subscriptionId': {'type': 'string'}}}

{'type': 'object', 'required': ['subscriptionId'], 'properties': {'subscriptionId': {'type': 'string', 'description': 'UUID returned by intelligence.subscribe.'}}}

{'type': 'object', 'properties': {'signal': {'type': 'string'}, 'direction': {'type': 'string'}, 'lastScore': {'type': 'number'}, 'threshold': {'type': 'number'}, 'lastFiredAt': {'type': 'string'}, 'lastCheckedAt': {'type': 'string'}, 'subscriptionId': {'type': 'string'}, 'totalAlertsFired': {'type': 'number'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'supplyChain': {'type': 'object', 'description': 'pressureIndex, regime, chokepoints (6), tradeFlowSignals, settlementImpact, synthesis.'}, 'energyTransition': {'type': 'object', 'description': 'renewableShare, fossilDemandCurve, gridCarbonIntensity (US/EU/global), transitionVelocity, synthesis.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'synthesis': {'type': 'string', 'description': 'AI briefing on the most dangerous structural accumulations.'}, 'faultLines': {'type': 'array', 'description': 'Per-node: domain, label, stress, accumulationRate, yearsToRupture, tippingThreshold.'}, 'systemStress': {'type': 'number', 'description': 'Composite tectonic stress 0–100.'}, 'ruptureSequence': {'type': 'array', 'description': 'Ordered fault lines by proximity to rupture.'}}}

{'type': 'object', 'required': ['amount'], 'properties': {'amount': {'type': 'number', 'description': 'Invoice amount in source currency'}, 'currency': {'type': 'string', 'description': 'Source currency code (default: USD)'}, 'ttlSeconds': {'type': 'number', 'description': 'Invoice TTL in seconds (default: 86400 = 24h)'}, 'callbackUrl': {'type': 'string', 'description': 'URL to notify when invoice is paid'}, 'description': {'type': 'string', 'description': 'Human-readable payment description'}, 'recipientAddress': {'type': 'string', 'description': 'Payee wallet address (can also be provided at pay time)'}, 'destinationCurrency': {'type': 'string', 'description': 'Destination currency (default: same as currency)'}}}

{'type': 'object', 'properties': {'payUrl': {'type': 'string', 'description': 'Direct URL to pay this invoice'}, 'status': {'type': 'string', 'description': 'OPEN | PAID | EXPIRED'}, 'expiresAt': {'type': 'string'}, 'invoiceId': {'type': 'string', 'description': 'UUID — pass to invoice.get or invoice.pay'}}}

{'type': 'object', 'required': ['invoiceId'], 'properties': {'invoiceId': {'type': 'string', 'description': 'Invoice UUID returned by invoice.create'}}}

{'type': 'object', 'properties': {'id': {'type': 'string'}, 'amount': {'type': 'number'}, 'payUrl': {'type': 'string'}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expiresAt': {'type': 'string'}}}

{'type': 'object', 'required': ['invoiceId'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'True for sandbox simulation. Default: true — set false only for live execution.'}, 'invoiceId': {'type': 'string', 'description': 'Invoice UUID to pay'}, 'recipientAddress': {'type': 'string', 'description': 'Payee wallet address (required if not set in invoice)'}}}

{'type': 'object', 'properties': {'invoiceId': {'type': 'string'}, 'settlement': {'type': 'object', 'description': 'Full settlement result from POST /settle', 'additionalProperties': True}}}

{'type': 'object', 'required': ['session_id'], 'properties': {'session_id': {'type': 'string', 'description': 'Session or task ID — the same ID used in receipt.create calls'}}}

{'type': 'object', 'required': [], 'properties': {'origin': {'type': 'string', 'description': 'Origin node ID. Call market.cascade with listNodes:true to discover valid IDs (e.g. "geo.conflict", "climate.drought", "commodity.oil", "macro.rate_decision").'}, 'eventType': {'type': 'string', 'description': 'Free-text description of the specific event (e.g. "Russia-Ukraine escalation", "Sahel drought season", "Fed emergency 75bps hike").'}, 'listNodes': {'type': 'boolean', 'description': 'If true, returns all valid origin node IDs and descriptions instead of running a cascade. Use this first to discover valid origin values.'}, 'magnitude': {'type': 'number', 'description': 'Shock magnitude 1–100. 100 = maximum plausible shock for this event type. 40–60 = significant but not extreme.'}, 'horizonHours': {'type': 'number', 'description': 'Forward time horizon in hours (1–720). Default: 168 (1 week). Use 24 for immediate cascade, 720 for full 30-day view.'}}}

{'type': 'object', 'properties': {'origin': {'type': 'object', 'description': 'Origin node metadata.'}, 'cascade': {'type': 'array', 'description': 'Time-ordered propagation chain — each entry has node, magnitude, arrivalHours, via path, and mechanism.'}, 'eventType': {'type': 'string', 'description': 'Event description provided.'}, 'synthesis': {'type': 'string', 'description': 'AI intelligence briefing on transmission paths, concentrated risk, feedback loops, and forward signals.'}, 'computedAt': {'type': 'string', 'description': 'ISO timestamp of computation.'}, 'horizonHours': {'type': 'number', 'description': 'Time horizon modeled.'}, 'inputMagnitude': {'type': 'number', 'description': 'Clamped input magnitude.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'dxy': {'type': 'object', 'description': 'DXY value, trend, regime, and settlement impact summary.'}, 'corridors': {'type': 'array', 'description': 'Per-pair risk, spot rate, advice, and settlement cost.'}, 'overallRisk': {'type': 'string', 'description': 'FAVORABLE / NORMAL / MODERATE / HIGH / CRITICAL'}, 'bestCorridors': {'type': 'array', 'description': 'Pairs with NORMAL or FAVORABLE risk — settle now.'}, 'worstCorridors': {'type': 'array', 'description': 'Pairs with HIGH or CRITICAL risk — delay or hedge.'}, 'executiveSummary': {'type': 'string', 'description': 'Plain-language summary of FX settlement conditions.'}, 'recommendedActions': {'type': 'array', 'description': 'Actionable guidance for treasury teams.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'regime': {'type': 'string', 'description': 'STABLE / MODERATE / ELEVATED / SEVERE_DISRUPTION'}, 'keyRoutes': {'type': 'array', 'description': 'Per-route disruption status and stress score.'}, 'synthesis': {'type': 'string', 'description': 'Narrative briefing on freight conditions and implications.'}, 'energyCost': {'type': 'object', 'description': 'Brent crude, diesel price, marine fuel proxy.'}, 'freightModes': {'type': 'array', 'description': 'Per-mode (ocean/air/truck/rail) cost index and stress signal.'}, 'compositeScore': {'type': 'number', 'description': 'Composite stress score 0–100 (higher = more stress).'}, 'settlementRelevance': {'type': 'object', 'description': 'Invoice delay risk, trade finance stress, affected corridors.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'count': {'type': 'number', 'description': 'Number of accounts returned'}, 'total': {'type': 'number', 'description': 'Total balance across all accounts in USD'}, 'accounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Mercury account ID — use with mercury.transactions and mercury.send'}, 'kind': {'type': 'string', 'description': 'Account type: checking, savings, etc.'}, 'name': {'type': 'string', 'description': 'Account name'}, 'currency': {'type': 'string', 'description': 'Currency code (USD)'}, 'currentBalance': {'type': 'number', 'description': 'Current balance (in dollars)'}, 'availableBalance': {'type': 'number', 'description': 'Available balance in USD'}}}}, 'environment': {'type': 'string', 'description': 'sandbox or production'}}}

{'type': 'object', 'required': ['accountId', 'amount', 'recipientId', 'recipientName'], 'properties': {'note': {'type': 'string', 'description': 'Payment memo / note (optional).'}, 'amount': {'type': 'number', 'description': 'Payment amount in USD.'}, 'purpose': {'type': 'string', 'description': 'Payment purpose category (optional — required by Mercury for domesticWire, recommended for ACH). E.g. "Vendor", "Contractor", "Expenses".'}, 'accountId': {'type': 'string', 'description': 'Source Mercury account ID (from mercury.accounts).'}, 'autoExecute': {'type': 'boolean', 'description': 'If true and compliance returns APPROVED, immediately sends the ACH payment. Default false — screen first, execute separately.'}, 'recipientId': {'type': 'string', 'description': 'Mercury saved recipient ID (from mercury.send / POST /mercury/recipients).'}, 'externalMemo': {'type': 'string', 'description': 'External memo / reference visible to recipient (optional).'}, 'recipientName': {'type': 'string', 'description': 'Legal name of the recipient entity or individual — used for compliance screening.'}, 'idempotencyKey': {'type': 'string', 'description': 'Idempotency key for safe retries. Auto-generated if omitted.'}}}

{'type': 'object', 'properties': {'tier': {'type': 'string', 'description': 'Compliance tier — FAST_PATH, STANDARD, ENHANCED, or HOLD.'}, '_next': {'type': 'string', 'description': 'Guidance on next action.'}, 'reason': {'type': 'string', 'description': 'Human-readable decision summary.'}, 'decision': {'enum': ['APPROVED', 'FLAGGED', 'BLOCKED'], 'type': 'string', 'description': 'Compliance decision.'}, 'executed': {'type': 'boolean', 'description': 'True if autoExecute:true and ACH was sent.'}, 'mercuryId': {'type': 'string', 'description': 'Mercury transaction ID (present when executed).'}, 'authorized': {'type': 'boolean', 'description': 'True if compliance approved the payment.'}, 'compliance': {'type': 'object', 'description': 'Full compliance oracle response including framework attestations.', 'additionalProperties': True}, 'requiresReview': {'type': 'boolean', 'description': 'True when decision is FLAGGED — manual review required.'}}}

{'type': 'object', 'required': ['accountId', 'amount'], 'properties': {'note': {'type': 'string', 'description': 'Payment memo / description.'}, 'amount': {'type': 'number', 'description': 'Payment amount in USD (or destination currency if specified).'}, 'sandbox': {'type': 'boolean', 'description': 'Dry run — returns what would be sent without executing. Default: true. Set false to execute.'}, 'bankCity': {'type': 'string', 'description': 'Beneficiary bank city.'}, 'bankName': {'type': 'string', 'description': 'Beneficiary bank name (e.g. "Barclays Bank UK PLC").'}, 'currency': {'type': 'string', 'description': 'Destination currency for internationalWire (e.g. "GBP", "EUR"). Default USD.'}, 'dpxRoute': {'type': 'boolean', 'description': 'If true, appends dpx:<wallet> to the memo — triggers DPX on-chain USDC settlement via the Mercury webhook. Use this to settle the stablecoin leg of a cross-border payment.'}, 'accountId': {'type': 'string', 'description': 'Source Mercury account ID (from mercury.accounts).'}, 'swiftCode': {'type': 'string', 'description': 'BIC/SWIFT code of beneficiary bank (required for internationalWire without recipientId). E.g. "BARCGB22" for Barclays UK.'}, 'bankAddress': {'type': 'string', 'description': 'Beneficiary bank street address.'}, 'bankCountry': {'type': 'string', 'description': 'Beneficiary bank country — ISO 3166-1 alpha-2 (e.g. "GB", "DE", "SG").'}, 'recipientId': {'type': 'string', 'description': 'Mercury saved recipient ID for internationalWire. Use this if the recipient is already saved in Mercury — skips inline bank detail fields.'}, 'accountNumber': {'type': 'string', 'description': 'Recipient account number (required for ach/wire/check). Also used for IBAN on internationalWire.'}, 'paymentMethod': {'enum': ['ach', 'wire', 'rtp', 'internationalWire', 'check'], 'type': 'string', 'description': 'Payment rail. rtp = Real-Time Payment (instant, US domestic). internationalWire = cross-border (1–3 days). Default: ach.'}, 'recipientCity': {'type': 'string', 'description': 'Beneficiary city.'}, 'recipientName': {'type': 'string', 'description': 'Recipient legal name (required for ach/wire/rtp/check).'}, 'routingNumber': {'type': 'string', 'description': 'Recipient routing number (required for ach/wire/check).'}, 'recipientEmail': {'type': 'string', 'description': 'Recipient email (optional — for payment notification).'}, 'recipientAddress': {'type': 'string', 'description': 'Beneficiary street address.'}, 'recipientCountry': {'type': 'string', 'description': 'Beneficiary country — ISO 3166-1 alpha-2.'}, 'recipientPostalCode': {'type': 'string', 'description': 'Beneficiary postal code.'}}}

{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Mercury transaction ID (present when sandbox:false and executed)'}, 'note': {'type': 'string', 'description': 'Payment memo as sent'}, 'amount': {'type': 'number', 'description': 'Amount in USD'}, 'status': {'type': 'string', 'description': 'Transaction status from Mercury'}, 'sandbox': {'type': 'boolean', 'description': 'True if this was a dry run'}, 'dpxTagged': {'type': 'boolean', 'description': 'Whether the DPX routing tag was appended'}, 'simulation': {'type': 'object', 'description': 'Dry-run summary (present when sandbox:true)', 'additionalProperties': True}}}

{'type': 'object', 'required': ['accountId'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'If true, marks analysis as sandbox mode — Mercury balance may not reflect live state.'}, 'accountId': {'type': 'string', 'description': 'Mercury account ID to analyze (from mercury.accounts).'}, 'thresholdUsd': {'type': 'number', 'description': 'Minimum USD balance to always keep in Mercury as a reserve. Sweepable = available balance minus this amount. Default: $50,000.'}, 'riskTolerance': {'enum': ['conservative', 'moderate', 'aggressive'], 'type': 'string', 'description': 'Risk tolerance for yield deployment. Conservative requires APY > 5%. Default: moderate.'}, 'settlementDeadlineUtc': {'type': 'string', 'description': 'ISO 8601 UTC timestamp of when funds must be back in Mercury (e.g. "2026-06-28T18:00:00Z"). Defaults to 7 days from now. Drives the yield window calculation.'}}}

{'type': 'object', 'properties': {'account': {'type': 'object', 'description': 'Mercury account summary with available balance, reserve threshold, and sweepable amount.', 'additionalProperties': True}, 'execution': {'type': 'object', 'description': 'Step-by-step execution instructions (present when recommendation is PROCEED).', 'additionalProperties': True}, 'yieldAnalysis': {'type': 'object', 'description': 'Yield routing analysis: instrument, APY, expected net yield, window, and recommendation (PROCEED | HOLD).', 'additionalProperties': True}, 'risk_disclosure': {'type': 'string', 'description': 'Mandatory risk disclosure — client must acknowledge before acting.'}}}

{'type': 'object', 'required': ['accountId'], 'properties': {'limit': {'type': 'number', 'description': 'Number of transactions to return (default 20, max 500).'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0).'}, 'accountId': {'type': 'string', 'description': 'Mercury account ID (from mercury.accounts).'}}}

{'type': 'object', 'properties': {'total': {'type': 'number', 'description': 'Total number of transactions on this account'}, 'accountId': {'type': 'string'}, 'transactions': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Mercury transaction ID'}, 'note': {'type': 'string', 'description': 'Payment memo / note field'}, 'amount': {'type': 'number', 'description': 'Amount in USD (negative = outgoing, positive = incoming)'}, 'status': {'type': 'string', 'description': 'pending | sent | failed | cancelled'}, 'createdAt': {'type': 'string', 'description': 'ISO 8601 creation timestamp'}, 'dpxTagged': {'type': 'boolean', 'description': 'True if memo contains dpx: routing tag'}, 'counterpartyName': {'type': 'string', 'description': 'Counterparty name'}}}}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'score': {'type': 'number', 'description': 'Chaos index 0–100 (higher = more chaotic).'}, 'trend': {'type': 'string', 'description': 'IMPROVING / STABLE / DETERIORATING'}, 'layers': {'type': 'array', 'description': 'Per-layer contribution: signal, score, weight, direction.'}, 'regime': {'type': 'string', 'description': 'CALM / ELEVATED / VOLATILE / HIGH / CRITICAL'}, 'keyDrivers': {'type': 'array', 'description': 'Top 3 factors currently driving the score.'}}}

{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'description': 'Company name to resolve via GLEIF if LEI is unknown (e.g. "Siemens AG").'}, 'lei': {'type': 'string', 'description': '20-character GLEIF LEI. Provide this for fastest response.'}, 'country': {'type': 'string', 'description': 'ISO-2 country code for World Bank WGI lookup (e.g. "DE", "US"). Optional but improves score accuracy.'}}}

{'type': 'object', 'properties': {'lei': {'type': 'string'}, 'tier': {'enum': ['STRONG', 'ADEQUATE', 'MODERATE', 'WEAK', 'POOR'], 'type': 'string'}, 'country': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'scoredAt': {'type': 'string'}, 'composite': {'type': 'number', 'description': 'Governance score 0–100'}, 'components': {'type': 'object', 'description': 'Per-source breakdown: gleif (LEI status, renewal) and worldbank (WGI indicators)'}, 'entityName': {'type': 'string'}, 'mikaCompliant': {'type': 'boolean', 'description': 'True if composite ≥ 60 (MiCA Article 72 threshold)'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'nodes': {'type': 'object', 'additionalProperties': True}, 'regime': {'type': 'string', 'description': 'Network regime classification.'}, 'threadHealth': {'type': 'object', 'additionalProperties': True}, 'networkHealth': {'type': 'number', 'description': 'Composite network vitality score 0–100.'}, 'fruitingBodyRisk': {'type': 'object', 'additionalProperties': True}, 'networkNarrative': {'type': 'string'}}}

{'type': 'object', 'required': [], 'properties': {'rails': {'type': 'array', 'items': {'type': 'string'}, 'description': "Specific rails to check: 'PIX', 'SEPA', 'FedACH', 'CHAPS', 'UPI', 'PromptPay'. Omit for all."}, 'region': {'type': 'string', 'description': "Filter by region: 'latam', 'europe', 'us', 'asia', 'uk'."}}}

{'type': 'object', 'properties': {'rails': {'type': 'object', 'description': 'Per-rail status map', 'additionalProperties': True}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 timestamp'}, 'healthScore': {'type': 'number', 'description': 'Composite rail health score 0–100'}, 'recommendation': {'type': 'string', 'description': 'Settlement recommendation based on rail health'}}}

{'type': 'object', 'required': ['counterparty', 'amountUsd'], 'properties': {'currency': {'type': 'string', 'description': 'Source currency (default: USD).'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD.'}, 'counterparty': {'type': 'string', 'description': 'Payee wallet address.'}}}

{'type': 'object', 'properties': {'gates': {'type': 'object', 'description': 'oracle: {status, score}, compliance: {tier, flags}, sfdr: {paiFlags}.'}, 'verdict': {'type': 'string', 'description': 'PROCEED / CAUTION / HOLD'}, 'rationale': {'type': 'string', 'description': 'Plain-language reason for verdict.'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'status': {'enum': ['STABLE', 'CAUTION', 'UNSTABLE'], 'type': 'string', 'description': 'Current stability status'}, 'outlook': {'type': 'string', 'description': 'Short-term stability outlook'}, 'reasoning': {'type': 'string', 'description': 'AI reasoning for current status'}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 assessment timestamp'}, 'pegDeviation': {'type': 'number', 'description': 'USDC peg deviation in basis points'}, 'recommendation': {'type': 'string', 'description': 'PROCEED | CAUTION | HOLD'}, 'stabilityScore': {'type': 'number', 'description': 'Oracle stability score 0–100'}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'tier': {'type': 'string', 'description': 'Oracle tier classification'}, 'score': {'type': 'number', 'description': 'Composite oracle score 0–100'}, 'alerts': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Active oracle alerts'}, 'status': {'type': 'string', 'description': 'STABLE | CAUTION | UNSTABLE'}, 'signals': {'type': 'object', 'properties': {'fx': {'type': 'number'}, 'macro': {'type': 'number'}, 'basket': {'type': 'number'}, 'climate': {'type': 'number'}, 'usdHealth': {'type': 'number'}, 'yieldCurve': {'type': 'number'}, 'commodities': {'type': 'number'}, 'geopolitical': {'type': 'number'}, 'infrastructure': {'type': 'number'}}, 'description': 'Individual signal scores for all 11 oracle layers'}, 'briefing': {'type': 'string', 'description': 'AI intelligence briefing text'}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 oracle run timestamp'}, 'chaosRegime': {'type': 'boolean', 'description': 'True if extreme market conditions detected'}}}

{'type': 'object', 'required': ['agent_id', 'amount_usd'], 'properties': {'purpose': {'type': 'string', 'description': 'Payment purpose string'}, 'agent_id': {'type': 'string', 'description': 'Agent identifier — must match the agent_id used in policy.create'}, 'recipient': {'type': 'string', 'description': 'Recipient wallet address'}, 'amount_usd': {'type': 'number', 'description': 'Proposed payment amount in USD'}, 'session_id': {'type': 'string', 'description': 'Task or session grouping ID for ledger tracking.'}, 'to_currency': {'type': 'string', 'description': 'Destination currency code (e.g. EUR, GBP)'}, 'counterparty': {'type': 'string', 'description': 'Counterparty name or LEI'}, 'delegation_id': {'type': 'string', 'description': 'If acting under a delegation from a parent agent, provide the delegation ID.'}, 'oracle_status': {'type': 'string', 'description': 'Current oracle status — STABLE, CAUTION, or UNSTABLE. Get from get_reliability.'}}}

{'type': 'object', 'required': ['agent_id', 'name'], 'properties': {'name': {'type': 'string', 'description': 'Human-readable policy name'}, 'agent_id': {'type': 'string', 'description': 'Stable identifier for the agent or org (wallet address, session prefix, org slug, etc.)'}, 'max_per_tx': {'type': 'number', 'description': 'USD ceiling per single transaction. Payments above this are BLOCKED.'}, 'max_per_day': {'type': 'number', 'description': 'USD rolling daily ceiling. Payments that would exceed this are HOLDed.'}, 'blocked_regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'ISO 3166-1 alpha-2 country codes to block.'}, 'allowed_purposes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'If set, only payments with a purpose in this list are allowed.'}, 'require_hold_above': {'type': 'number', 'description': 'Route to HOLD queue for human review if amount exceeds this threshold.'}, 'require_oracle_stable': {'type': 'boolean', 'description': 'If true, HOLD on CAUTION as well as UNSTABLE oracle status.'}, 'blocked_counterparties': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Wallet addresses or LEIs to block.'}}}

{'type': 'object', 'required': ['parent_agent_id', 'child_agent_id'], 'properties': {'max_total': {'type': 'number', 'description': 'Lifetime spending ceiling for this delegation'}, 'policy_id': {'type': 'string', 'description': 'Policy ID to inherit (optional — inherits parent policy if omitted)'}, 'expires_at': {'type': 'number', 'description': 'Unix timestamp (ms) when this delegation expires. Omit for no expiry.'}, 'max_per_tx': {'type': 'number', 'description': 'Maximum USD per transaction for the sub-agent'}, 'child_agent_id': {'type': 'string', 'description': 'The sub-agent receiving delegated authority'}, 'parent_agent_id': {'type': 'string', 'description': 'The authorising (parent) agent ID'}}}

{'type': 'object', 'required': [], 'properties': {'section': {'enum': ['all', 'overview', 'product', 'traction', 'market', 'financials', 'compliance', 'raise', 'founder', 'risks'], 'type': 'string', 'description': "Which section to return. Default 'all' returns the complete memo."}}}

{'type': 'object', 'properties': {'_meta': {'type': 'object', 'description': 'Memo metadata', 'additionalProperties': True}, 'raise': {'type': 'object', 'description': 'Raise details', 'additionalProperties': True}, 'risks': {'type': 'object', 'description': 'Key risks', 'additionalProperties': True}, 'market': {'type': 'object', 'description': 'Market context', 'additionalProperties': True}, 'founder': {'type': 'object', 'description': 'Founder background', 'additionalProperties': True}, 'product': {'type': 'object', 'description': 'Product and technology', 'additionalProperties': True}, 'overview': {'type': 'object', 'description': 'Company overview', 'additionalProperties': True}, 'traction': {'type': 'object', 'description': 'Traction and metrics', 'additionalProperties': True}, 'compliance': {'type': 'object', 'description': 'Compliance posture', 'additionalProperties': True}, 'financials': {'type': 'object', 'description': 'Financial model', 'additionalProperties': True}}}

{'type': 'object', 'required': [], 'properties': {}}

{'type': 'object', 'properties': {'agent': {'type': 'object', 'description': 'Settlement Agent manifest: name, version, status', 'additionalProperties': True}, 'oracle': {'type': 'object', 'description': 'Oracle manifest: name, version, assets, endpoints', 'additionalProperties': True}}}

{'type': 'object', 'required': ['tenant_id', 'amount'], 'properties': {'amount': {'type': 'string', 'description': 'Card spending cap (e.g. "10000.00").'}, 'currency': {'type': 'string', 'description': 'Currency code (default USD).'}, 'reference': {'type': 'string', 'description': 'Your internal reference ID.'}, 'tenant_id': {'type': 'string', 'description': 'Tenant ID of the connected Ramp account.'}, 'display_name': {'type': 'string', 'description': 'Card label visible in Ramp dashboard.'}, 'merchant_scope': {'type': 'string', 'description': 'Intended merchant name (informational).'}}}

{'type': 'object', 'properties': {'amount': {'type': 'string'}, 'taskId': {'type': 'string', 'description': 'Poll GET /ramp/agent-card/:taskId for card PAN/CVV.'}, 'currency': {'type': 'string'}, 'reference': {'type': 'string'}, 'statusUrl': {'type': 'string'}}}

{'type': 'object', 'required': ['counterpartyName', 'amount'], 'properties': {'amount': {'type': 'number', 'description': 'Payment amount in units of currency.'}, 'currency': {'type': 'string', 'description': 'ISO 4217 currency code. Defaults to "USD".'}, 'paymentType': {'enum': ['vendor_payment', 'payroll', 'intercompany', 'other'], 'type': 'string', 'description': 'Payment type — payroll automatically triggers PEP screen.'}, 'isIndividual': {'type': 'boolean', 'description': 'true if counterparty is an individual (triggers PEP screen). Defaults to false.'}, 'sourceCountry': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 source country. Defaults to "US".'}, 'counterpartyLei': {'type': 'string', 'description': 'Optional GLEIF LEI — enables UBO chain check and satisfies FATF R.16 originator identification.'}, 'counterpartyName': {'type': 'string', 'description': 'Legal name of the payment counterparty.'}, 'counterpartyCountry': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 destination country (e.g. "DE", "NG", "IR").'}}}

{'type': 'object', 'properties': {'checks': {'type': 'object', 'description': 'fatfCountry, amountFlags, sanctions, pep, uboChain check details.'}, '_action': {'type': 'string', 'description': 'Recommended action for the agent.'}, 'fatfR16': {'type': 'object', 'description': 'FATF R.16 satisfied status and basis.'}, 'reasons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Specific reasons for the decision.'}, 'decision': {'enum': ['APPROVED', 'FLAGGED', 'BLOCKED'], 'type': 'string', 'description': 'Compliance decision.'}, 'riskScore': {'type': 'number', 'description': 'Risk score 0–100.'}, 'humanRequired': {'type': 'boolean', 'description': 'true only for FLAGGED — APPROVED payments proceed automatically.'}}}

{'type': 'object', 'required': ['tenant_id'], 'properties': {'tenant_id': {'type': 'string', 'description': 'Your internal tenant or customer ID — returned in the callback so you can match the connection.'}}}

{'type': 'object', 'properties': {'scopes': {'type': 'string', 'description': 'Requested OAuth scopes.'}, 'tenant_id': {'type': 'string'}, 'authorize_url': {'type': 'string', 'description': 'Redirect the user to this URL to authorize DPX on their Ramp account.'}}}

{'type': 'object', 'required': ['tenant_id', 'amount', 'currency', 'creditor_wallet', 'creditor_name'], 'properties': {'amount': {'type': 'string', 'description': 'Payment amount (e.g. "50000.00").'}, 'currency': {'type': 'string', 'description': 'Source currency: USD or EUR.'}, 'reference': {'type': 'string', 'description': 'Your internal payment reference.'}, 'tenant_id': {'type': 'string', 'description': 'Tenant ID of the connected Ramp account.'}, 'callback_url': {'type': 'string', 'description': 'Webhook URL for pacs.002 delivery.'}, 'creditor_lei': {'type': 'string', 'description': 'Recipient LEI for GLEIF VoP (optional).'}, 'creditor_name': {'type': 'string', 'description': 'Recipient name.'}, 'merchant_scope': {'type': 'string', 'description': 'Merchant name for Agent Card scope.'}, 'creditor_wallet': {'type': 'string', 'description': 'Recipient on-chain wallet address (0x...).'}, 'settlement_asset': {'type': 'string', 'description': 'Settlement asset: USDC (default) or EURC.'}}}

{'type': 'object', 'properties': {'status': {'enum': ['SETTLED', 'PENDING', 'BLOCKED', 'FAILED'], 'type': 'string'}, 'iso20022': {'type': 'object', 'description': 'pacs.002 status object.'}, 'agentCard': {'type': 'object'}, 'compliance': {'type': 'object', 'description': 'FATF R16 + SFDR PAI indicators.'}, 'settlement': {'type': 'object'}, 'dpxPaymentId': {'type': 'string'}}}

{'type': 'object', 'required': ['tenant_id'], 'properties': {'page_size': {'type': 'number', 'description': 'Number of bills to analyse (default 100, max 500).'}, 'tenant_id': {'type': 'string', 'description': 'Tenant ID of the connected Ramp account.'}}}

{'type': 'object', 'properties': {'crossBorder': {'type': 'object', 'description': 'Wire and international bill totals.'}, 'dpxOpportunity': {'type': 'object', 'description': 'Estimated annual savings and DPX fees.'}, 'topVendorsBySpend': {'type': 'array', 'description': 'Top 10 vendors by total payment volume.'}}}

{'type': 'object', 'required': ['agent_id', 'amount_usd'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'True if this was a sandbox settlement'}, 'tx_hash': {'type': 'string', 'description': 'On-chain transaction hash (if live)'}, 'agent_id': {'type': 'string', 'description': 'Agent that executed the payment'}, 'policy_id': {'type': 'string', 'description': 'Policy ID that governed this payment'}, 'recipient': {'type': 'string', 'description': 'Recipient wallet address'}, 'amount_usd': {'type': 'number', 'description': 'Amount paid in USD'}, 'session_id': {'type': 'string', 'description': 'Task or session ID for grouping (use the same ID for all payments in one agent run)'}, 'to_currency': {'type': 'string', 'description': 'Destination currency (default: USD)'}, 'counterparty': {'type': 'string', 'description': 'Counterparty name'}, 'task_context': {'type': 'string', 'description': 'Plain-text description of what task triggered this payment'}, 'delegation_id': {'type': 'string', 'description': 'Delegation ID if acting under delegated authority'}, 'from_currency': {'type': 'string', 'description': 'Source currency (default: USD)'}, 'oracle_status': {'type': 'string', 'description': 'Oracle status at time of payment (STABLE / CAUTION / UNSTABLE)'}, 'settlement_id': {'type': 'string', 'description': 'Settlement ID returned by the settle tool'}, 'compliance_decision': {'type': 'string', 'description': 'Compliance decision at time of payment (PROCEED / HOLD / BLOCKED)'}}}

{'type': 'object', 'required': [], 'properties': {'apiKey': {'type': 'string', 'description': 'DPX Reports API key. Alternatively, set Authorization: Bearer <key> in the calling context.'}}}

{'type': 'object', 'required': [], 'properties': {'lei': {'type': 'string', 'description': 'GLEIF LEI of the entity to screen.'}, 'name': {'type': 'string', 'description': 'Entity name to screen (if no LEI). One of lei or name required.'}, 'apiKey': {'type': 'string', 'description': 'DPX Reports API key.'}}}

{'type': 'object', 'required': [], 'properties': {'lei': {'type': 'string', 'description': 'Optional GLEIF LEI for SFDR PAI report.'}, 'apiKey': {'type': 'string', 'description': 'DPX Reports API key.'}, 'address': {'type': 'string', 'description': 'Wallet address or on-chain entity address to score.'}}}

{'type': 'object', 'required': [], 'properties': {'apiKey': {'type': 'string', 'description': 'DPX Reports API key.'}}}

{'type': 'object', 'required': [], 'properties': {'apiKey': {'type': 'string', 'description': 'DPX Reports API key.'}, 'period': {'type': 'string', 'description': 'ISO month (YYYY-MM). Defaults to current month.'}}}

{'type': 'object', 'required': ['amount', 'from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Destination currency code (USD, EUR, GBP, etc.)'}, 'from': {'type': 'string', 'description': 'Source currency code (USD, EUR, GBP, BRL, etc.)'}, 'amount': {'type': 'number', 'description': 'Settlement amount in source currency'}}}

{'type': 'object', 'properties': {'options': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'number'}, 'token': {'type': 'string'}, 'rationale': {'type': 'string'}, 'settleBody': {'type': 'object', 'additionalProperties': True}, 'tokenAddress': {'type': 'string'}, 'isCrossCurrency': {'type': 'boolean'}}}}, 'ttlSeconds': {'type': 'number'}, 'generatedAt': {'type': 'string'}, 'routingAdvice': {'type': 'object', 'properties': {'rationale': {'type': 'string'}, 'recommendation': {'type': 'string', 'description': 'Top-ranked stablecoin (USDC, EURC, or USDT)'}, 'oracleStabilityScore': {'type': 'number', 'description': 'Current oracle stability score 0–100'}}}, 'settleEndpoint': {'type': 'string'}}}

{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': 'Max results to return (default 3, max 5).'}, 'query': {'type': 'string', 'description': 'Keywords to search — e.g. "how to settle", "esg fee formula", "butterfly cascade", "mercury send", "compliance screen".'}}}

{'type': 'object', 'required': ['amount', 'sourceCurrency', 'destinationCurrency', 'recipientAddress'], 'properties': {'amount': {'type': 'number', 'description': 'Amount in source currency units'}, 'purpose': {'type': 'string', 'description': 'Payment purpose: intercompany, vendor-payment, payroll, treasury'}, 'quoteId': {'type': 'string', 'description': 'Pre-fetched quoteId from get_quote (optional — agent fetches live if omitted)'}, 'sandbox': {'type': 'boolean', 'description': 'Sandbox mode — real calculations, no on-chain execution. Default: true.'}, 'esgScore': {'type': 'number', 'description': 'ESG score override 0–100 (testing only)'}, 'referenceId': {'type': 'string', 'description': 'External reference ID (invoice number, TMS ID, etc.)'}, 'sourceCurrency': {'type': 'string', 'description': 'Source currency: USD, EUR, GBP, USDC, EURC'}, 'recipientAddress': {'type': 'string', 'description': 'On-chain recipient wallet address (0x...)'}, 'destinationCurrency': {'type': 'string', 'description': 'Destination currency: USD, EUR, GBP, USDC, EURC'}}}

{'type': 'object', 'properties': {'result': {'type': 'object', 'properties': {'status': {'enum': ['executed', 'sandbox', 'held', 'failed'], 'type': 'string'}, 'txHash': {'type': 'string', 'description': 'On-chain transaction hash (if executed)'}, 'feesTotal': {'type': 'number', 'description': 'Total fees in USD'}, 'netAmount': {'type': 'number', 'description': 'Net amount delivered after fees'}, 'reasoning': {'type': 'string', 'description': 'AI reasoning for settlement decision'}, 'timestamp': {'type': 'string', 'description': 'ISO 8601 settlement timestamp'}, 'oracleScore': {'type': 'number', 'description': 'Oracle score at time of settlement'}, 'oracleStatus': {'type': 'string', 'description': 'Oracle status at time of settlement'}, 'settlementId': {'type': 'string', 'description': 'Unique settlement ID (dpx_...)'}}}, 'summary': {'type': 'string', 'description': 'Human-readable settlement outcome summary'}, 'httpStatus': {'type': 'number', 'description': 'HTTP status from Settlement Agent'}}}

{'type': 'object', 'required': ['pain001Xml'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'Pass through to settlement.execute as sandbox mode. Default true.'}, 'pain001Xml': {'type': 'string', 'description': 'Raw pain.001 XML string.'}, 'validateOnly': {'type': 'boolean', 'description': 'If true, parse and validate without returning a settle body. Default false.'}}}

{'type': 'object', 'properties': {'payments': {'type': 'array', 'description': 'Parsed payment instructions with amount, currency, creditor, debtor.'}, 'settleBody': {'type': 'object', 'description': 'Structured body ready for settlement.execute. Null if validateOnly=true.'}, 'validationErrors': {'type': 'array', 'description': 'Schema or business-rule validation errors, if any.'}}}

{'type': 'object', 'required': ['instruction', 'recipientAddress'], 'properties': {'sandbox': {'type': 'boolean', 'description': 'Set false for live execution. Default: true'}, 'instruction': {'type': 'string', 'description': "Plain-English payment instruction, e.g. 'Pay Acme GmbH $25,000 USD for invoice #INV-2026-0042'"}, 'recipientAddress': {'type': 'string', 'description': 'Recipient wallet address (0x...)'}}}

{'type': 'object', 'properties': {'status': {'type': 'string'}, 'txHash': {'type': 'string'}, 'feesTotal': {'type': 'number'}, 'netAmount': {'type': 'number'}, 'aiDecision': {'type': 'string'}, 'aiConfidence': {'type': 'number'}, 'settlementId': {'type': 'string'}}}

{'type': 'object', 'required': ['amountUsd'], 'properties': {'lei': {'type': 'string', 'description': 'Counterparty LEI — triggers automatic ESG lookup if esgScore is not provided.'}, 'hasFx': {'type': 'boolean', 'description': 'True if source and destination currencies differ (adds 0.40% FX fee).'}, 'esgScore': {'type': 'number', 'description': 'Counterparty ESG score 0–100. If omitted and lei or counterpartyName is provided, the ESG Oracle is queried automatically.'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD.'}, 'counterpartyName': {'type': 'string', 'description': 'Counterparty company name — used for ESG auto-lookup if lei is not provided.'}, 'monthlyVolumeUsd': {'type': 'number', 'description': 'Monthly volume for discount tier. $1M+ = Institutional (20% off). $10M+ = Sovereign (30% off).'}}}

{'type': 'object', 'properties': {'fees': {'type': 'object', 'properties': {'fx': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'esg': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'core': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'total': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}, 'license': {'type': 'object', 'properties': {'pct': {'type': 'number'}, 'usd': {'type': 'number'}}}}}, 'tier': {'type': 'string', 'description': 'Volume tier: Standard | Growth | Institutional | Sovereign'}, 'quoteId': {'type': 'string', 'description': 'Binding quote ID, valid 300 seconds'}, 'amountUsd': {'type': 'number', 'description': 'Input settlement amount in USD'}, 'expiresAt': {'type': 'string', 'description': 'ISO 8601 expiry timestamp'}, 'reasoning': {'type': 'string', 'description': 'AI reasoning for fee calculation'}, 'oracleScore': {'type': 'number', 'description': 'Oracle confidence 0–100'}, 'netAmountUsd': {'type': 'number', 'description': 'Net amount after all fees'}, 'oracleStatus': {'type': 'string', 'description': 'STABLE | CAUTION | UNSTABLE'}}}

{'type': 'object', 'required': ['settlementId'], 'properties': {'settlementId': {'type': 'string', 'description': 'Settlement ID from the settlement.execute tool (format: dpx_...)'}}}

{'type': 'object', 'properties': {'httpStatus': {'type': 'number', 'description': 'HTTP status from Settlement Agent'}, 'settlement': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'status': {'enum': ['executed', 'sandbox', 'held', 'failed', 'pending'], 'type': 'string'}, 'txHash': {'type': 'string'}, 'esgScore': {'type': 'number'}, 'feesTotal': {'type': 'number'}, 'netAmount': {'type': 'number'}, 'reasoning': {'type': 'string'}, 'timestamp': {'type': 'string'}, 'oracleStatus': {'type': 'string'}, 'settlementId': {'type': 'string'}, 'sourceCurrency': {'type': 'string'}, 'destinationCurrency': {'type': 'string'}}}}}

{'type': 'object', 'required': ['amountUsd'], 'properties': {'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD.'}, 'sourceCurrency': {'type': 'string', 'description': 'Source currency (default: USD).'}, 'destinationCurrency': {'type': 'string', 'description': 'Destination currency (default: USD).'}}}

{'type': 'object', 'properties': {'brief': {'type': 'string', 'description': 'Plain-language settlement brief.'}, 'oracle': {'type': 'object', 'description': 'status, score, reasoning.'}, 'compliance': {'type': 'object', 'description': 'tier, flags, amlStatus.'}, 'stablecoin': {'type': 'string', 'description': 'Recommended stablecoin for this settlement.'}, 'feeEstimate': {'type': 'object', 'description': 'totalBps, grossUsd, netUsd, intelligenceFee.'}}}

{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'HTTPS endpoint to receive settlement.completed events'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Event types (default: ["settlement.completed"])'}}}

{'type': 'object', 'properties': {'events': {'type': 'array', 'items': {'type': 'string'}}, 'webhookSecret': {'type': 'string', 'description': 'HMAC secret — returned once, store immediately'}, 'subscriptionId': {'type': 'string'}}}

{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Destination currency ISO-4217 code (e.g. "BRL", "MXN", "SGD").'}, 'from': {'type': 'string', 'description': 'Source currency ISO-4217 code (e.g. "USD", "EUR", "GBP").'}}}

{'type': 'object', 'properties': {'corridor': {'type': 'object', 'description': 'score (0–100), tier, recommendation (SETTLE_NOW/DELAY_24H/DELAY_48H), regulatoryFlags, corridorNotes'}, 'components': {'type': 'object', 'description': 'globalOracleScore, corridorAdjustment, cascadePenalty, liquidityScore, weekendPenalty'}, 'marketContext': {'type': 'object', 'description': 'cascadeLevel, globalOutlook, currentUtcHour, isWeekend'}}}

{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Destination currency ISO-4217 (e.g. "BRL").'}, 'lei': {'type': 'string', 'description': 'Optional 20-char GLEIF LEI of counterparty — fetches live ESG tier to apply counterparty risk penalty.'}, 'from': {'type': 'string', 'description': 'Source currency ISO-4217 (e.g. "USD").'}, 'amount': {'type': 'number', 'description': 'Settlement amount (default 1,000,000). Used for large-amount guidance ≥$5M.'}, 'currency': {'type': 'string', 'description': 'Currency of the amount (defaults to from).'}}}

{'type': 'object', 'properties': {'windows': {'type': 'array', 'description': '18 × 4-hour slots: startUtc, endUtc, compositeScore, tier, components, recommendation, rationale'}, 'marketContext': {'type': 'object', 'description': 'globalOracleScore, corridorAdjustment, cascadeLevel, globalOutlook, regulatoryFlags'}, 'recommendation': {'type': 'object', 'description': 'bestWindow (ISO datetime), bestScore, optimalCount, goodCount, summary, largeAmountNote'}}}

{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'Destination currency ISO-4217 (e.g. "EUR", "BRL", "AED").'}, 'from': {'type': 'string', 'description': 'Source currency ISO-4217 (e.g. "USD").'}, 'amountUsd': {'type': 'number', 'description': 'Settlement amount in USD (used for liquidity tier and large-amount warnings).'}}}

{'type': 'object', 'properties': {'routes': {'type': 'array', 'description': 'Ranked stablecoin options — each with symbol, liquidityTier, regulatoryFlags, warnings, blocked status, notes'}, 'evaluatedAt': {'type': 'string', 'description': 'ISO timestamp'}, 'recommendation': {'type': 'object', 'description': 'symbol, chain, reason, micaCompliant, geniusActCompliant'}}}

{'type': 'object', 'required': ['uetr'], 'properties': {'uetr': {'type': 'string', 'description': 'RFC 4122 UUID UETR assigned at payment initiation, e.g. "97ed4827-7b6f-4491-a06f-b548d5a7512d".'}}}

{'type': 'object', 'properties': {'uetr': {'type': 'string', 'description': 'The UETR provided.'}, 'pacs002': {'type': 'object', 'description': 'Full ISO 20022 pacs.002 payload for gpi Tracker submission.', 'additionalProperties': True}, 'gpiStatus': {'type': 'string', 'description': 'ACCP | PDNG | RJCT'}, 'dpxPaymentId': {'type': 'string', 'description': 'DPX internal payment ID.'}}}

{'type': 'object', 'required': ['amountUsdc', 'settlementDeadlineUtc'], 'properties': {'dryRun': {'type': 'boolean', 'description': 'If true, returns analysis without any on-chain queries. Useful for planning. Default: false.'}, 'amountUsdc': {'type': 'number', 'description': 'Settlement amount in USDC. Minimum $50,000 for yield routing to be viable after gas costs.'}, 'riskTolerance': {'enum': ['conservative', 'moderate'], 'type': 'string', 'description': 'conservative = sUSDS only (T-bill / RWA backed, instant exit). moderate = sUSDS with higher slippage tolerance (up to 0.15%). Default: conservative.'}, 'settlementDeadlineUtc': {'type': 'string', 'description': 'ISO 8601 UTC timestamp of when USDC must be ready for settlement (e.g. "2026-06-15T20:00:00Z"). The tool will recommend exiting 30 minutes before this.'}}}

{'type': 'object', 'properties': {'exitBy': {'type': 'string', 'description': 'Recommended exit timestamp (30 min before deadline).'}, 'notViable': {'type': 'boolean', 'description': 'True if net yield is negative (gas exceeds expected yield).'}, 'instrument': {'type': 'string', 'description': 'Recommended instrument (currently always sUSDS).'}, 'windowHours': {'type': 'number', 'description': 'Available window in hours (deadline minus now minus 30-min buffer).'}, 'netYieldUsdc': {'type': 'number', 'description': 'Expected yield minus gas costs.'}, 'currentApyPct': {'type': 'number', 'description': 'Current Sky Savings Rate APY (live, from Sky Protocol).'}, 'amountReserved': {'type': 'number', 'description': 'Amount kept in USDC regardless (10% floor).'}, 'amountRoutable': {'type': 'number', 'description': 'Amount to deploy (90% of input, USDC). 10% stays in USDC.'}, 'recommendation': {'enum': ['ROUTE', 'HOLD', 'INSUFFICIENT_WINDOW'], 'type': 'string', 'description': 'ROUTE (deploy float), HOLD (stay in USDC), or INSUFFICIENT_WINDOW.'}, 'gasEstimateUsdc': {'type': 'number', 'description': 'Estimated Base L2 gas cost for entry + exit in USDC.'}, 'risk_disclosure': {'type': 'object', 'properties': {'summary': {'type': 'string'}, 'peg_risk': {'type': 'string'}, 'liability': {'type': 'string'}, 'bridge_risk': {'type': 'string'}, 'liquidity_risk': {'type': 'string'}, 'regulatory_note': {'type': 'string'}, 'smart_contract_risk': {'type': 'string'}, 'acknowledgement_required': {'type': 'boolean'}}, 'description': 'MUST be surfaced to the client before any action is taken.'}, 'estimatedSlippage': {'type': 'number', 'description': 'Estimated DEX slippage for USDC→USDS→USDC round trip (%).'}, 'expectedYieldUsdc': {'type': 'number', 'description': 'Expected yield for this window at current APY.'}, 'instrument_detail': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'chain': {'type': 'string'}, 'issuer': {'type': 'string'}, 'backing': {'type': 'string'}, 'us_persons': {'type': 'string'}, 'audit_status': {'type': 'string'}, 'depeg_history': {'type': 'string'}, 'exit_mechanism': {'type': 'string'}}, 'description': 'Background on the recommended instrument.'}, 'slippageGuardTripped': {'type': 'boolean', 'description': 'True if slippage > 0.1% — recommendation will be HOLD.'}}, 'description': 'Yield routing analysis. Check recommendation field before acting.'}