Before you build
What you need
- Access to Circle StableFX and the matching test or live API credential.
- The selected Arc network, its supported source token and a compatible wallet.
- Test USDC and suitable permissions for a testnet run.
Sequence
Do it in this order
Check availability
Confirm StableFX App access on your Aomi environment and your Circle account. Do not substitute App visibility for Circle RFQ eligibility.
Quote and accept
Discover the App’s live tool schemas. Use stablefx_quote for an indicative quote and stablefx_accept_quote for a fresh tradable quote.
Review wallet signing
The App validates the Arc network, token and Permit2 domain and spender before it routes Circle’s typed signing request. The signer controls authorization.
Trade, fund, and check status
stablefx_create_trade, stablefx_prepare_funding and stablefx_fund_trade are separate from stablefx_trade_status. Report the quote, the funding and the settlement as separate states.
What to show a reviewer
Use a Circle-authorized test environment to capture a full quote-to-settlement lifecycle. Do not show an illustrative UI as a completed institutional FX trade.
Keep this boundary clear
A credential is required at tool-call time. The public stewardfx site describes an illustrative flow with access pending; it is not proof of a completed StableFX transaction.
Where to go next
Keep the first action small. If you need custom tools, start from the Aomi App guide rather than inventing an API call.