Skip to main content
There are two ways to redeem $TSY for USDC, depending on the amount. Both need the $TSY and the Treasury credits that a deposit recorded, in the depositor’s wallet: Treasury credits explains them.

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 as user, 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.
A 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:
When 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.
A redemption at size settles after Multiliquid’s checks and its transaction’s finality, so it takes longer than an instant redemption. There is no guaranteed completion time.

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.