Skip to navigation
Agora Public APIEndpointsQuotes

Create Quotes

Quote a conversion between AUSD and USDC or USDT on one chain, in either direction. Requesting a quote moves no funds: it returns the provider’s price and the executionSteps your user’s wallet signs to accept it. The deposit must land onchain by the quote’s expiresAt, 180 seconds after it’s priced. quotes holds one quote per provider that can fill the request, so compare fees and executionSteps before picking one.

Send exactly one of senderAmount or receiverAmount; the other side comes back computed on the quote. One side must be AUSD, both sides must be on the same chain, and USDT is offered on Ethereum only (see Support).

We screen both wallets before quoting, and a request that fails for any reason stores nothing:

  • 400 chain_unsupported: sender and receiver are on different chains.
  • 400 currency_unsupported: the pair doesn’t have AUSD on exactly one side, or the chain doesn’t offer the currency (USDT on Monad).
  • 403 wallet_blocked: the sender or receiver wallet failed screening.
  • 503 service_unavailable: no provider can quote right now. Retry later with a new request.

Next, follow Executing a quote to run executionSteps, then poll transactionId through GET /v0/transactions/{txnId} as described in Tracking execution. Fees explains the fees breakdown.

Authentication

AuthorizationBearer

Session JWT from POST /v0/auth/token, sent as Authorization: Bearer <sessionJwt>.

See Authentication for more details.

Request

One side must be ausd and the other must not. Both sides must be on the same chain. Currencies offered per chain: ethereum (ausd, usdc, usdt), monad (ausd, usdc).

senderobjectRequired
receiverobjectRequired
senderAmountstringOptionalformat: "^\d+(\.\d+)?$"

Fixes the input side. Provide exactly one of senderAmount or receiverAmount; the other is computed on the quote.

receiverAmountstringOptionalformat: "^\d+(\.\d+)?$"

Fixes the output side. Provide exactly one of senderAmount or receiverAmount; the other is computed on the quote.

slippageBpsintegerOptional>=0

Basis points of allowed slippage from the quoted rate. Default and cap are set per chain; values above the cap are clamped rather than rejected. The effective value is echoed on the quote.

Response

OK
quoteslist of objects
One element per provider that returned a route. Never empty on success.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error