Skip to main content
Use the Aggregator to quote MultiversX swaps and, when sender is present, receive transaction data your wallet can sign.

Use This When

NeedUse
Price a swap before the user signsGET /api/v1/quote with amountIn or amountOut
Build transaction data for a wallet flowAdd sender to the quote request
Check token decimals and minimum inputGET /api/v1/pair-config before quoting
Detect a same-token arbitrage cycleSet from and to to the same token

Do Not Use This When

NeedUse instead
You need account, nonce, or transaction status dataGateway
You already signed the transaction and only need propagationRelayer broadcast
You need Stellar routes or a Stellar TransactionEnvelopeStellar Aggregator

Base URL

https://swap.xoxno.com
No API key is required; per-IP rate limits apply.

Flow

1

Validate the pair

Call /api/v1/pair-config to confirm supported: true, read token decimals, and check minAmountIn.
2

Quote the route

Call /api/v1/quote with exactly one amount field: amountIn for forward quotes or amountOut for reverse quotes.
3

Request transaction data

Pass sender when the user is ready to sign. The response can include a full transaction object and encoded txData.
4

Sign and broadcast

Sign the returned transaction with the user’s wallet, then broadcast it through the wallet, Gateway, or Relayer.

Limits

ActionLimit or behavior
Any request100 requests per second per IP
Quote freshnessQuotes use the latest pool snapshot available to the service
Liquidity sourcesxExchange, AshSwap, JEX, OneDex
Transaction dataDo not reuse txData across quote requests
Amount formatUse integer strings in the token’s smallest unit
Token decimals vary by asset. Convert from human-readable amount to smallest unit before quoting, and verify decimals with /api/v1/pair-config.

Endpoints

EndpointMethodJob
/api/v1/quoteGETQuote a route and optionally return transaction data
/api/v1/pair-configGETValidate support and return decimal metadata
/healthGETCheck 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.