Price a payout from your own balance

post

https://api.sandbox.alfredpay.io/v1/quotes

Prices a conversion from your own stablecoin balance to local currency. Pass the returned id as quoteId on POST /v1/payouts/fiat before expiresAt.

Send fromAmount or toAmount, never both.

toAmount is the exact amount the recipient receives. Alfred calculates the USDC owed and returns it in fromAmount, rounded up. toAmount takes at most two decimals and applies to payouts only, from USDC to local currency.
fromAmount fixes the USDC you spend, and toAmount comes back as what the recipient receives.

A quote lasts about two minutes and can be used once.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Send fromAmount or toAmount, never both.

fromCurrency

string

enum

required

Fourteen members, reconciled to the countries a customer can be onboarded in. USDC and USDT are stablecoins and require chain.

toCurrency

string

enum

required

Fourteen members, reconciled to the countries a customer can be onboarded in. USDC and USDT are stablecoins and require chain.

fromAmount

string

The stablecoin amount to spend.

toAmount

string

^\d+(\.\d{1,8})?$

The exact amount the recipient receives. Payouts only, from USDC to local currency. A fiat amount takes at most two decimals; three to eight return 422 and more than eight return 400.

chain

string

enum

The network of the stablecoin side.

Headers

Idempotency-Key

uuid

required

Required on every state-changing POST, simulators included; the only exempt POST is …/verifications/preflight.
Replay (same key, same body) returns the original response with Idempotent-Replayed: true; same key with a
different body → 409 idempotency_conflict. Keys are UUIDs, scoped to the API key, retained for 24 hours.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Created

400validation_error. The reason is in error.details.issues[].message: Both amounts sent: "provide fromAmount or toAmount, not both" No amount sent: "fromAmount or toAmount is required" toAmount isn't a number, or has more than 8 decimals: "must be a decimal amount with at most 8 fractional digits"

401Missing or invalid credentials.