Step 1: Get a Quote

The /v1/quote endpoint analyzes your transaction, finds optimal routes, calculates fees, and returns a payload for signing. The first step is choosing the right mode for your users.

Choose Your Mode

EOA

MetaMask, Rabby, TrustFor standard wallets. Requires fundingTokens.

Smart Account

Nexus, ERC-4337Simplest setup. Native gas abstraction.

EIP-7702

Privy, Dynamic, TurnkeyFor embedded wallets with 7702 support.

Quick Comparison

Feature	EOA	Smart Account	EIP-7702
Wallet support	All wallets	Smart accounts only	Embedded wallets
`fundingTokens`	Required	Not needed	Not needed
Signatures	1 per token	Always 1	Always 1
Gas payment	Same-chain only	Any chain	Any chain
First-time setup	None	Account deploy	Authorization

Basic Structure

All quote requests share this structure:

const quote = await fetch('https://api.biconomy.io/v1/quote', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    mode: 'smart-account',        // or 'eoa', 'eoa-7702'
    ownerAddress: '0x...',
    composeFlows: [{              // Your operations
      type: '/instructions/intent-simple',
      data: { /* swap params */ }
    }],
    feeToken: { /* optional */ }  // Omit for sponsored (gasless)
  })
}).then(r => r.json());

Understanding composeFlows

The composeFlows array defines what you want to do:

intent-simple
build
intent

Token swaps (same-chain or cross-chain):

{
  type: '/instructions/intent-simple',
  data: {
    srcChainId: 8453,
    dstChainId: 10,
    srcToken: '0x833589...',
    dstToken: '0x94b008...',
    amount: '100000000',
    slippage: 0.01
  }
}

Custom contract calls:

{
  type: '/instructions/build',
  data: {
    chainId: 8453,
    to: '0xContractAddress',
    functionSignature: 'function deposit(uint256 amount)',
    args: ['1000000000']
  }
}

Complex multi-token operations:

{
  type: '/instructions/intent',
  data: {
    slippage: 0.01,
    inputPositions: [{ chainToken: {...}, amount: '...' }],
    targetPositions: [{ chainToken: {...}, weight: 1.0 }]
  }
}

Response Structure

{
  "ownerAddress": "0x...",
  "fee": {
    "amount": "50000",
    "token": "0x...",
    "chainId": 8453
  },
  "quoteType": "simple",
  "payloadToSign": [{ /* sign this */ }],
  "returnedData": [{
    "outputAmount": "99500000",
    "minOutputAmount": "98505000",
    "route": { "summary": "lifi => across" }
  }]
}

Field	Description
`fee`	Gas cost in the specified token
`quoteType`	How to sign: `simple`, `permit`, or `onchain`
`payloadToSign`	Data user needs to sign
`returnedData`	Expected outputs and routing info

Validate Before Signing

Always check the quote before asking user to sign:

// Check fee is reasonable
const feeUsd = Number(quote.fee.amount) / 1e6;
if (feeUsd > 1.00) {
  throw new Error(`Fee too high: $${feeUsd}`);
}

// Check output meets minimum
const minOutput = quote.returnedData[0]?.minOutputAmount;
console.log(`User will receive at least ${minOutput}`);

Next Steps

EOA Mode

For MetaMask, Rabby, Trust users

Smart Account Mode

For Nexus smart account users

EIP-7702 Mode

For Privy, Dynamic, Turnkey users

Sign Payload →

After getting your quote

Welcome

ERC-8211 Smart Batching

Supertransaction API

AbstractJS SDK

Choose Your Mode

EOA

Smart Account

EIP-7702

Quick Comparison

Basic Structure

Understanding composeFlows

Response Structure

Validate Before Signing

Next Steps

EOA Mode

Smart Account Mode

EIP-7702 Mode

Sign Payload →

​Choose Your Mode

EOA

Smart Account

EIP-7702

​Quick Comparison

​Basic Structure

​Understanding composeFlows

​Response Structure

​Validate Before Signing

​Next Steps

EOA Mode

Smart Account Mode

EIP-7702 Mode

Sign Payload →

Choose Your Mode

Quick Comparison

Basic Structure

Understanding composeFlows

Response Structure

Validate Before Signing

Next Steps