Trading and Earn

Find a trading pair and build an exact swap or bridge quote request

Resolve token symbols on both networks, convert a display amount to base units and take the resulting request to a live quote provider.

Workflow

  1. Choose the pair and direction

    Use spotPairSearch for trades on one network. For cross-chain transfers, use bridgeRouteSearch with both networks and both tokens. The same symbol can belong to different tokens on each chain. Follow nextOffset through matching catalogue pages and open the canonical pair or route to check its direction.

  2. Convert the amount for the source asset

    The example starts with 1.25 USDC on Ethereum and asks for USDC on Base. marketQuotePlan accepts the amount in display units and a slippage limit in basis points. If either symbol has multiple candidates, check their contract addresses, then repeat the request with the exact addresses. For native USDC with six decimals, 1.25 becomes 1250000 base units.

  3. Request the live quote

    When state is ready, call nextCall.tool with nextCall.arguments. An EVM swap requires sourceWallet before the plan can return a quote call. Check the amount, expected output, minimum received, expiry and fee in the live quote. Before preparing a direct bridge transfer, supply the source wallet and destination recipient to the quote tool and review the new result. Keep the returned quote ID with the original workspace.

Build a quote request for 1.25 USDC from Ethereum to Base

curl -fsS "https://www.bitpont.com/api/v1/agent/research/quote-plan" \
  -H 'Content-Type: application/json' \
  -d '{"sourceChain":"evm:1","destinationChain":"evm:8453","from":"USDC","to":"USDC","amount":"1.25","slippageBps":50}'

Tools in this guide

Open tool explorer

Related links