sender is present, receive transaction data your wallet can sign.
Use This When
| Need | Use |
|---|---|
| Price a swap before the user signs | GET /api/v1/quote with amountIn or amountOut |
| Build transaction data for a wallet flow | Add sender to the quote request |
| Check token decimals and minimum input | GET /api/v1/pair-config before quoting |
| Detect a same-token arbitrage cycle | Set from and to to the same token |
Do Not Use This When
| Need | Use instead |
|---|---|
| You need account, nonce, or transaction status data | Gateway |
| You already signed the transaction and only need propagation | Relayer broadcast |
You need Stellar routes or a Stellar TransactionEnvelope | Stellar Aggregator |
Base URL
Flow
Validate the pair
Call
/api/v1/pair-config to confirm supported: true, read token decimals, and check minAmountIn.Quote the route
Call
/api/v1/quote with exactly one amount field: amountIn for forward quotes or amountOut for reverse quotes.Request transaction data
Pass
sender when the user is ready to sign. The response can include a full transaction object and encoded txData.Limits
| Action | Limit or behavior |
|---|---|
| Any request | 100 requests per second per IP |
| Quote freshness | Quotes use the latest pool snapshot available to the service |
| Liquidity sources | xExchange, AshSwap, JEX, OneDex |
| Transaction data | Do not reuse txData across quote requests |
| Amount format | Use integer strings in the token’s smallest unit |
Endpoints
| Endpoint | Method | Job |
|---|---|---|
/api/v1/quote | GET | Quote a route and optionally return transaction data |
/api/v1/pair-config | GET | Validate support and return decimal metadata |
/health | GET | Check service health |
Next Steps
Quickstart
Validate a pair, fetch a quote, and inspect the transaction fields.
Quote endpoint
Required params, response fields, errors, and executable examples.
Pair config
Confirm token support, decimals, and minimum input.
Integration guide
Wire quotes into a signing and broadcast flow.

