Skip to main content
One API call gets your users the best price on Stellar. The Soroswap Aggregator API quotes Soroswap, Aquarius, SushiSwap V3, Comet and the Stellar classic DEX (SDEX), splits the trade across them when that pays, and returns a route your app can execute right away.

Get an API key

Register and generate a key in a minute. The free plan needs no approval.

Quickstart

Your first quote and swap on mainnet in five minutes.

API Reference

Every endpoint, request and response.

Monetize your flow

Set a partner fee on your swaps and get your share in USDC every month.

What you get

  • Best execution across Stellar. Every quote prices the Soroban venues and, when you ask for it, the classic order book. A single trade can split across several pools and hops. See supported venues.
  • Gasless trustline. A user who has never held the output asset, and has no XLM to open a trustline, can still receive it in one swap: a sponsor account you control pays for the trustline. See Gasless Trustline.
  • Revenue on every swap. Configure a partner fee once on your account. It is collected on-chain and settled to you in USDC each month, with a statement per token. See Fees and revenue share.
  • Two ways to execute. Let the API build the transaction for your user to sign, or take the route and execute it from your own Soroban contract. See Quickstart.

How to start

  1. Register and generate an API key (it starts with sk_).
  2. Call POST /quote with the two assets, the amount and the venues you want in protocols.
  3. Call POST /quote/build to get the transaction, have your user sign it, and submit it with POST /send.
The base URL is https://api.soroswap.finance for both mainnet and testnet; pick the network with ?network=. Request limits depend on your plan, see Plans and rate limits.

Building on the AMM instead

If you provide liquidity, or your contract needs to trade directly against Soroswap pools, the Soroswap AMM section documents the pair, factory and router contracts.

Support

Developer questions go to dev@paltalabs.io or the developer channels on Discord. For a large integration or a commercial agreement, see Business Partnerships.

Video walkthrough