Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.circle.com/llms.txt

Use this file to discover all available pages before exploring further.

Create a taker trade in the StableFX Console by requesting a quote, connecting your wallet, locking the exchange rate, and signing the trade. Use this workflow when you want to execute a trade through the console UI without integrating with the StableFX API directly.

​
Prerequisites

Before you begin:
  • You have an active StableFX account with Taker access.
  • You have connected an EVM-compatible wallet to Arc (testnet or mainnet).
  • You have a sufficient token balance for the trade amount plus collateral.
  • You have granted Permit2 contract approval for the token you are selling. See Grant USDC allowance to Permit2.

​
Open the trade form

You can start a new trade from multiple entry points:
  • Home page: Click Trade in the trade card.
  • Overview page: Click New Trade in the toolbar.
  • Trades page: Click New Trade in the top-right corner.
The trade form opens in a side panel on the right.

​
Configure the trade

​
Select currencies

Choose the From and To currencies using the dropdowns. One side of every pair must be USDC. Supported pairs include:
  • USDC / EURC
  • EURC / USDC
Additional currency pairs (such as USDC/MXNB and USDC/AUDF) may be available depending on your account configuration and the current StableFX network.

​
Enter the amount

Enter an amount in either the From or To field—not both. The console fetches a reference quote and auto-fills the other side based on the current exchange rate.
  • Amounts support up to 6 decimal places.
  • There is a minimum trade amount enforced by the API. If your amount is too low, the console displays an error.
  • The quote refreshes automatically every 3 seconds while the form is open.

​
Choose a settlement tenor

Select how quickly the trade should settle:
TenorSettlement windowDescription
Instant30 minutesBoth parties must fund in 30 minutes of trade creation.
Hourly1 hourSettlement deadline is 1 hour after trade creation.
Daily24 hoursSettlement deadline is 24 hours after trade creation.
Shorter tenors reduce counterparty risk but require faster funding. instant is a good default for your first trade.

​
Review the rate

The Quote Rate Card at the bottom of the form shows the current exchange rate. This is a reference rate—the final rate is locked when you create the trade in the confirmation step.

​
Connect your wallet

Click Continue to proceed to wallet selection. If you haven’t connected a wallet yet, see Connect your wallet to the StableFX Console for step-by-step instructions. The console uses Dynamic.xyz for wallet connection and supports any EVM-compatible wallet. Once connected, verify that the displayed wallet address is correct and click Continue.
Your connected wallet must have:
  • Sufficient balance for the trade amount plus collateral (risk buffer).
  • An active Permit2 approval for the token you are selling. The console prompts you to approve if needed.

​
Lock the rate and create the trade

The confirmation panel shows a live tradable quote with the exact terms of the trade:
  • Rate: The current exchange rate, refreshing every 3 seconds.
  • From / To amounts: The exact token amounts for both sides.
  • Fee: The trading fee, denominated in the “to” currency.
  • Collateral: The risk buffer amount held temporarily to cover potential non-settlement (denominated in the “from” currency), if applicable. See Risk Buffers.
  • Settlement tenor: The selected settlement window.
  • Expiration: When the quote expires.
When you are ready:
  1. Click Lock Rate & Continue.
  2. If this is your first trade with this token, your wallet prompts you to approve the Permit2 contract (a one-time ERC-20 approval).
  3. Your wallet then prompts you to sign EIP-712 typed data. This signature authorizes the trade at the displayed rate. Review the details in your wallet and confirm.
The console submits the signed trade and displays the result:
  • Success: The trade is created with status pending_settlement. You can proceed to fund the trade.
  • Failure: If the quote expired or another error occurred, the console displays an error message. You can retry with a new quote.

​
Alternative: manual signature

If you prefer to sign the typed data outside the console (for example, using a hardware wallet or a custom signing tool):
  1. In the confirmation panel, click Sign manually to view the raw EIP-712 typed data.
  2. Copy the typed data and sign it with your preferred tool.
  3. Paste the resulting signature back into the console and submit.

​
See also