Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.avnu.fi/llms.txt

Use this file to discover all available pages before exploring further.

Earn revenue on every swap by adding integrator fees. Fees are specified in basis points and sent directly to your recipient address on-chain.

​
Parameters

​
integratorFees
bigint
required
Fee in basis points as bigint (10n = 0.1%, 100n = 1%)
​
integratorFeeRecipient
string
required
Address to receive fee payments
​
integratorName
string
required
Your protocol/platform identifier (for analytics)

​
SDK Example

import { getQuotes, executeSwap } from '@avnu/avnu-sdk';
import { parseUnits } from 'ethers';

const quotes = await getQuotes({
  sellTokenAddress: ethAddress,
  buyTokenAddress: usdcAddress,
  sellAmount: parseUnits('1', 18),
  takerAddress: account.address,
  integratorFees: 10n, // 0.1% (10 bps)
  integratorFeeRecipient: '0xYourFeeRecipientAddress',
  integratorName: 'YourProtocolName',
});

// Execute swap with fees
const result = await executeSwap({
  provider: account,
  quote: quotes[0],
  slippage: 0.001,
});

console.log('Swap executed:', result.transactionHash);

​
How It Works

Fee Calculation:
  • Fees are specified in basis points (bps)
  • Transferred directly to your recipient address on-chain
Fee Token Selection: The contract automatically selects the best token to collect fees using an on-chain priority mechanism. Stablecoins are preferred, followed by major assets (ETH, wstETH, WBTC, STRK, etc.).
The fee token is selected automatically based on the swap route - you don’t need to specify it.

​
Best Practices

Setting your integrator name helps with:
  • Analytics and volume tracking
  • Support and troubleshooting
  • Potential partnership opportunities

Swap Guide

Back to main swap documentation

API Reference

View complete API parameters