Solve API Quick Start

tip

Request your Solve API key to start your integration via Sprinter Solve Request or contacting support@sprinter.tech

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; // the amount of token that you want exchange in their decimals denomination
const TOKEN_IN_ADDRESS; // token_in_address
const TOKEN_OUT_ADDRESS; // token_out_addres - tokens that you want to receieve
const SLIPPAGE; // the slipapge that you want to allow for the swap ( 0.5 - 2%)
const TARGET_DURATION;

const fetchRoute = async () => {
  const response = await fetch(
    "https://swaps.sprinter.tech/mainnet/v2/route?amount_in=[AMOUNT_IN]&token_in=[TOKEN_IN_ADDRESS]&token_out=[TOKEN_OUT_ADDRESS]&slippage=[SLIPPAGE]&target_duration_ms=[TARGET_DURATION]",
    {
      method: "GET",
      headers: {
        "X-API-Key": "your_api_key_here",
      },
    },
  );

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

3. Send transaction using swap_call_data

Once you've received a valid route from /v2/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/v2/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, // usually the router or intent execution contract
  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. Start with /quote to quickly evaluate whether a fill is profitable.

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

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

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

5. Handling Rate Limits - If you hit 429s, give it a moment and retry using retry_after value. You can request higher limits via support@sprinter.tech.