Instant redemption
Swap $TSY for USDC with the Swap API. It settles in one transaction, up to the USDC that Treasury custody holds now.
Redemption at size
Sign once for a larger amount. Multiliquid sources the USDC it needs and settles the redemption in one transaction.
Choose instant or at size
Quote the instant swap first, with the depositor’s wallet asuser, because the depositor’s credits set the price. Without user, the quote is indicative, priced as a wallet with no accrued yield would be, not at the depositor’s own price.
200 means the depositor can redeem instantly: amountIn is the $TSY the swap spends, such as 984.589682567186264031 $TSY for 1,000 USDC. $TSY has 18 decimals, and an amount in a response is exact, so it can show all 18. Build and submit it as Swap instantly describes.
Only the Treasury capital provider fills $TSY for USDC. Above what Treasury custody can pay out now, the quote answers NO_QUOTE, and details.providers says how much custody holds. Redeem at size instead:
details.providers names InsufficientCredits instead, the depositor’s credits do not cover the $TSY. A redemption at size needs the same credits: its preparation reports the shortfall in checks.credits, and intake rejects it. CreditsUnavailable means the credits could not be read now, so quote again later.
How a redemption at size works
1
Prepare
Get the redemption with every value filled in, the typed data to sign, the $TSY approval it needs, and checks that show whether it would be accepted now.
2
Approve and sign
The depositor signs the approval, when there is one, and you submit it. Then the depositor signs the typed data.
3
Submit and track
Submit the redemption with its signature, then follow it until the USDC is paid.
What you need
- No API key. The depositor’s signature authorizes the redemption. A key records the redemption under your organization, so you can list your organization’s redemptions later, as Authentication explains.
- $TSY on Ethereum mainnet, the only network redemptions run on, and Treasury credits to cover it, for an instant redemption and for one at size alike. Both come from a deposit.
- A signer for EIP-712 typed data: a wallet, a custody platform, or a contract wallet.
Next steps
Redeem at size
The full flow, from preparation to the USDC payout.
Prepare and sign
The prepared redemption, its checks, and the typed data.
Lifecycle
Intake checks, states, failures, and resubmission.