card.positions
Plan treasury settlement for a crypto card program. Accepts net positions per corridor (e.g. USD-BRL: $2.3M, USD-EUR: €450K) and returns an optimal settlement plan — which corridors to settle now vs. hold, which stablecoin to use per corridor, and estimated all-in fee. No settlement is executed. Call this before card.settle to review the plan. Free.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| positions | Yes | Array of net positions. Each: { corridor: "USD-BRL", netAmountUsd: 2300000, recipientAddress?: "0x..." } | |
| settlementDate | No | Settlement date ISO string (defaults to today UTC). E.g. "2026-08-09". |