Skip to navigation
Updates to the Agora Public API.

This page tracks all additions, changes, and removals to the Agora Public API.

Convert Stablecoins and the Quotes API (Beta)

You can now let your users convert between AUSD and USDC or USDT without leaving your product. Convert Stablecoins is in a closed beta; contact your Agora representative to request access.

The flow is non-custodial. You request a quote, your user’s wallet executes its steps onchain, and you track the conversion through the Transactions API. Funds move directly between your user and the provider filling the quote, never through Agora. The Convert Stablecoins guide covers the model, and the Quickstart walks through one conversion end to end.

betaquotestransactions

Transactions: INBOUND and OUTBOUND legs

Leg direction on GET /v0/transactions/{txnId} is now INBOUND (value arriving) or OUTBOUND (value leaving), replacing FROM_AGORA and TO_AGORA on every transaction type. Update any code that matches on the old values.

transactions

Routes: direction replaces from, and creation is idempotent

  • A route now returns direction (mint-fiat, mint-stablecoin, redeem-fiat, redeem-stablecoin) instead of echoing from, and GET /v0/routes takes a direction filter.
  • The stablecoin wildcard source currency is gone. Mint-from-stablecoin routes name the currency directly (today, usdc).
  • POST /v0/routes is idempotent. A repeat call with the same inputs returns 200 with the existing route instead of 409 route_already_exists, which is now reserved for a route id occupied by a row the call couldn’t read back. See 200, 201, or 409.
routes

Filters on the list endpoints

GET /v0/accounts, GET /v0/routes, and GET /v0/transactions now take filters alongside cursor and limit. Filters combine with AND, multi-value filters take a single comma-separated parameter (?type=mint,redeem), and date ranges use dotted bounds (?initiatedAt.gte=2026-08-01T00:00:00Z&initiatedAt.lt=2026-09-01T00:00:00Z). A filter is never silently dropped: an unknown parameter or an out-of-set value returns 400 parameter_invalid naming the parameter. See Filtering list endpoints.

betaaccountsroutestransactions

Retrieve a single account

GET /v0/accounts/{accountId} returns one account by id, in the same shape its entry in GET /v0/accounts carries. An id from another organization reads as 404 account_not_found, the same as an unknown id.

betaaccountsroutestransactions

Other changes

  • Two new 403 codes on authenticated endpoints: account_not_provisioned (your organization isn’t provisioned for the product the endpoint belongs to) and account_verification_pending (provisioned, verification not yet complete). Both are listed in the Error Reference.
betaaccountsroutestransactions

Self-serve API keys

API keys are no longer issued by Agora on request. Owners and Admins manage them under API keys, in the menu beneath your name in the Agora dashboard: name a key, pick the roles it carries, and copy the secret once at creation. Keys can be paused, resumed, or revoked (revoking is Owner-only), and each change takes effect immediately, including on session JWTs already issued.

betaauthenticationtransactionsroutes

Other changes

  • Transactions: legs can now carry a fee detail type, a manual accounting entry with no rail reference.
  • Routes: binance-smart-chain, core, katana, mantle, and plume are no longer supported destinations. Routes to those chains are omitted from list responses and their deposit instructions are no longer returned. Metrics still cover every chain AUSD is deployed on.
  • Routes: every deposit instruction now carries at least one entry in supportedCurrencies.
betaauthenticationtransactionsroutes

Transactions and account management

The Public API adds a transactions history and endpoints to register and update accounts. All new endpoints are in Beta.

Transactions

  • GET /v0/transactions: list your settled transactions, newest first, with the source and recipient counterparties and the amounts moved on each side. Paginated with cursor / limit.
  • GET /v0/transactions/{txnId}: retrieve a single transaction with its full per-leg breakdown (direction, settlement rail, and rail reference).
betatransactionsaccounts

Authentication, Accounts, and Routes

The Public API gains its first authenticated endpoints, beyond the existing supply metrics. These are in Beta and access is gated: API keys are issued by Agora on request, so reach out to the Agora team to inquire about one. The public metrics endpoints stay open and need no key.

Authentication

  • POST /v0/auth/token — exchange a long-lived API key for a short-lived (15-minute) session JWT, attached as a bearer token on every authenticated request. See the Authentication guide.
betaauthaccountsroutes

Public API Beta launch

Initial Beta release of the Agora Public API. Three unauthenticated endpoints for AUSD supply data:

  • GET /v0/metrics — full per-chain breakdown plus aggregate totals
  • GET /v0/metrics/total-supply — aggregate total supply as a plain-text decimal
  • GET /v0/metrics/circulating-supply — aggregate circulating supply as a plain-text decimal
betametrics