Quickstart

curl -X POST "https://api.soroswap.finance/quote?network=mainnet" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "assetIn": "CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA",
    "assetOut": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
    "amount": "100000000",
    "tradeType": "EXACT_IN",
    "protocols": ["soroswap", "aqua", "sushi", "comet", "sdex"],
    "slippageBps": 50
  }'

const API = 'https://api.soroswap.finance'
const headers = {
  Authorization: `Bearer ${process.env.SOROSWAP_API_KEY}`,
  'Content-Type': 'application/json',
}

async function post(path, body) {
  const res = await fetch(`${API}${path}?network=mainnet`, {
    method: 'POST',
    headers,
    body: JSON.stringify(body),
  })
  if (!res.ok) throw new Error(`${path} ${res.status}: ${await res.text()}`)
  return res.json()
}

const quote = await post('/quote', {
  assetIn: 'CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA', // XLM
  assetOut: 'CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75', // USDC
  amount: '100000000', // 10 XLM
  tradeType: 'EXACT_IN',
  protocols: ['soroswap', 'aqua', 'sushi', 'comet', 'sdex'],
})

// Send the quote back unchanged. `from` signs; `to` receives (defaults to `from`).
const { xdr } = await post('/quote/build', { quote, from: userAddress, to: userAddress })

const signedXdr = await signWithWallet(xdr) // Freighter, Stellar Wallets Kit, your own signer

const result = await post('/send', { xdr: signedXdr })
console.log(result.txHash, result.success)