Skip to main content
List Stellar tokens, request a swap quote, and verify the prepared TransactionEnvelope before signing.

Prerequisites

1. List Tokens

Read token identifiers and decimals from /api/v1/tokens.
Use decimals to convert human-readable amounts. For example, 100 XLM with 7 decimals is 1000000000.

2. Request A Quote

Quote 100 XLM to USDC on the Soroban execution plane.
Inspect these fields:

3. Request A Prepared Envelope

Pass sender when the user is ready to sign.
The response can include:
When simulate=true, do not run simulateTransaction again on the returned envelope. Refresh sequence number, sign, and submit.

Verify

You have a valid quickstart result when:
  • /api/v1/tokens returns the selected token with degree > 0.
  • /api/v1/quote returns non-zero amountOut.
  • platform matches the execution plane your flow can execute.
  • transaction.envelopeXdr is present when sender is set.
  • simulated is true when your flow depends on server-prepared Soroban resources.

Common Failure

Next Steps