Route an intent
route_intentRoute one cross-border payment, given as fields or as one sentence ("USD 25,000 to a supplier in Lagos by 30 November"). From a sentence the guide reads what matters without being told: urgency or the due date sets the deadline and puts speed first, words such as cheapest put cost first, regulated or licensed keeps only providers with a licence on record, and paying drivers, staff or a supplier is noted; intent.understood says what was read, and explicit policy fields override it. Returns every route that can carry it, ordered by the payer's own policy, the route the policy selects on the strongest evidence (payments measured when they landed, then published prices; estimates only if the policy allows), the saving against the payer's own quote, and where to pay. With a due date it also routes across time: pay now, lock a forward while holding tokenised T-bills, convert and park, or hold unhedged, as what each needs today. With remember: true SwapEazi keeps the intent, reprices it daily until due and returns its intent_id. A sentence about idle money ("park $5m USDC, back within 24 hours, non-US, qualified, we have Ondo") returns treasury parking instead: tokenised T-bill funds that fit the amount, eligibility, chain and redemption need, by net yield, with what the accounts already held can do and what a new account is worth. The free verification returns the verdict with names masked; a router key (Bearer rk_...) unlocks them. SwapEazi executes nothing and takes no fee from any provider. Returns a compact view by default (each route with its release window cut to the summary and landing dates); pass detail: "full" for everything.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | ISO 4217 code of the destination currency (what lands), e.g. 'USD'. | |
| from | No | ISO 4217 code of the source currency (what leaves), e.g. 'ZAR'. | |
| have | No | Providers or issuers the payer already has accounts with; the result shows what they can do and what a new account adds. | |
| text | No | The payment in one sentence; used instead of from/to/amount. | |
| amount | No | Amount leaving, in the source currency. | |
| detail | No | compact (default): a short summary that points at the signed full document, sized for a tool result. full: the whole document, which can exceed 100 KB. | |
| policy | No | Optional. The payer's own routing policy; overrides what is read from text. | |
| repeat | No | With remember and due_date: the payment repeats; due_date is the first cycle. Monthly cycles keep the day of month (31st: last day of shorter months). One reminder per cycle, before the last day to release through the selected route. | |
| deliver | No | Amount to deliver on the due date, destination currency. | |
| lock_at | No | With remember: mark the day locking the rate needs this much or less, source currency. | |
| due_date | No | YYYY-MM-DD the money must land; adds routing across time: pay now, forward, convert and park, hold unhedged. | |
| remember | No | Keep the intent and reprice it daily until it lands; returns remembered.intent_id. | |
| repeat_count | No | With repeat: number of cycles, the first included. | |
| repeat_until | No | With repeat: YYYY-MM-DD, last date a cycle may fall on. | |
| nudge_lead_days | No | With repeat: banking days before the release-by date to send the reminder (default 2). | |
| your_quote_landed | No | What the payer's current quote would land, in the destination currency. |