Skip to main content

Solve API Quick Start

tip

Request your Solve API key to start your integration via Sprinter Solve Request or contacting [email protected]

Sprinter Solve enables your dApp, aggregator or protocol integration to optimize swap execution via intent fulfillment.

This guide covers:

  1. Recap of the Sprinter Solve Lifecycle
  2. Geting the finalized route and call data execution package
  3. Send transaction using swap_call_data
  4. Sprinter Solve Execution Tips

1. Solve Lifecycle​

2. Geting the finalized route and call data execution package​

Calling the Get Route API returns the finalized route, including call data, gas estimates and token out amounts. Use this executable call data swap_call_data after verifying a quote.

  • Mainnet: https://swaps.sprinter.tech/mainnet
  • Base: https://swaps.sprinter.tech/base
Example Fetch Quote Request Payload
const AMOUNT_IN = "100000000"; // the amount of token you want to exchange, in its smallest unit (as a string)
const TOKEN_IN_ADDRESS = "0x..."; // address of the token you want to sell
const TOKEN_OUT_ADDRESS = "0x..."; // address of the token you want to buy
const SLIPPAGE_BPS = 50; // slippage in basis points (e.g., 50 = 0.5%)
const API_USER = "your_api_user";
const API_PASS = "your_api_pass";

const fetchRoute = async () => {
  const url = `https://swaps.sprinter.tech/mainnet/v1/route?amountIn=${AMOUNT_IN}&tokenIn=${TOKEN_IN_ADDRESS}&tokenOut=${TOKEN_OUT_ADDRESS}&slippageBps=${SLIPPAGE_BPS}`;

  const response = await fetch(url, {
    method: "GET",
    headers: {
      Authorization: "Basic " + btoa(`${API_USER}:${API_PASS}`),
    },
  });

  const data = await response.json();
  return data;
};

3. Send transaction using swap_call_data​

Once you've received a valid route from /v1/route, you'll use the swap_call_data in a transaction to execute the intent on-chain.

Below is a simplified example using ethers.js to send the transaction from a connected signer:

Example Execute Route Payload
import { ethers } from "ethers";

const provider = new ethers.JsonRpcProvider("https://mainnet.base.org"); // or OP/Arbitrum
const signer = new ethers.Wallet("<PRIVATE_KEY>", provider);

const routeResponse = await fetch("https://swaps.sprinter.tech/base/1/route", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "<your_api_key>",
  },
  body: JSON.stringify({
    fromToken: "USDC",
    toToken: "ETH",
    amount: "1000000",
    fromChainId: 8453,
    toChainId: 1,
    intentType: "swap",
  }),
});

const route = await routeResponse.json();

// Send the calldata to the target contract (Sprinter Router or intent receiver)
const tx = await signer.sendTransaction({
  to: route.to, //  the router or intent execution contract eg. 0xbfc4b3546416c5a7fa857bdb31b7701bfc7a42f7 for Sprinter Solve (Mainnet, Base)
  data: route.swap_call_data,
  value: route.value || 0, // only include if route requires native gas
  gasLimit: route.gasEstimate + 50000, // add buffer
});

console.log("Transaction hash:", tx.hash);

4. Sprinter Solve Execution Tips​

  1. Use tools like Tenderly or hardhat to simulate calldata before execution.

  2. Pay attention to slippage - Quotes expire quickly. Re-query /route before execution if delayed.

  3. Use gasEstimate for accurate costing - whilst the Route API provides gas estimates — apply buffer when setting gas limits.

  4. Handling Rate Limits - If you hit 429s, give it a moment and retry using retry_after value. You can request higher limits via [email protected].