Add Yield to Your App in 5 Minutes

This quickstart walks you through integrating a DeFi yield strategy into your application. You’ll browse available strategies, generate deposit transaction data, and execute it with your user’s wallet.

API Key

Get your API key at Pods

Wallet

Have an Ethereum/Polygon wallet address and sufficient USDC balance

Ensure your wallet has sufficient USDC on Polygon and MATIC for gas fees.

Create a .env file:

PODS_API_KEY=your-api-key
WALLET_ADDRESS=0x...
PRIVATE_KEY=0x...
POLYGON_RPC_URL=https://polygon-rpc.com

Never commit your .env file to version control. Add it to .gitignore.

Step 1: Browse Available Strategies

List all available yield strategies to find one for your use case.

JavaScript

import axios from 'axios'

const walletAddress = process.env.WALLET_ADDRESS // Your wallet address

const pods = axios.create({
  baseURL: 'https://api.pods.finance',
  headers: { 'x-api-key': process.env.PODS_API_KEY }
})

const { data: strategies } = await pods.get('/strategies')

strategies.data.forEach(s => {
  console.log(`${s.id} — ${s.protocol} on ${s.network} — APY: ${(s.apy * 100).toFixed(2)}%`)
})

Example Response

{
  "data": [
    {
      "id": "Aave-USDC-polygon",
      "protocol": "Aave",
      "assetName": "USDC",
      "network": "polygon",
      "asset": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
      "assetDecimals": 6,
      "apy": 0.0482,
      "paused": false,
      "fee": "0",
      "availableActions": ["lend", "withdraw"]
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 5,
    "totalPages": 1,
    "hasMore": false
  }
}

Use id (e.g. Aave-USDC-polygon) as the strategy identifier in the next steps.

Step 2: Generate Deposit Bytecode

Request ready-to-execute transaction data for depositing into the strategy.

JavaScript

const { data: result } = await pods.get('/strategies/aave-usdc-polygon/bytecode', {
  params: {
    action: 'lend',
    amount: '10000000', // 10 USDC (6 decimals)
    wallet: walletAddress
  }
})

console.log('Transactions to execute:', result.bytecode.length)
console.log('ID:', result.id)

cURL

curl -X GET "https://api.pods.finance/strategies/aave-usdc-polygon/bytecode" \
  -H "x-api-key: $PODS_API_KEY" \
  -G \
  --data-urlencode "action=lend" \
  --data-urlencode "amount=10000000" \
  --data-urlencode "wallet=$WALLET_ADDRESS"

Example Response

{
  "feeCharged": "0",
  "chainIdIn": 137,
  "chainIdOut": 137,
  "id": "65f3a1c8e9b2d4f8a7c1d2e3",
  "crossChain": {
    "isCrossChain": false,
    "chainIdIn": 137,
    "chainIdOut": 137
  },
  "quote": null,
  "bytecode": [
    {
      "to": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
      "data": "0x095ea7b3...",
      "value": "0",
      "chainId": "137"
    },
    {
      "to": "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
      "data": "0x617ba037...",
      "value": "0",
      "chainId": "137"
    }
  ]
}

The response may contain multiple legs (e.g. token approval + deposit). Execute all legs on the same chainId in one atomic transaction — not as separate sends. See Executing Bytecode.

Step 3: Execute Transactions

Do not loop over bytecode and call sendTransaction for each item. Batch every leg into a single transaction. For EOAs, use EIP-7702. For smart accounts, request output=userOperation. See Executing Bytecode.

EOA (recommended): use the EIP-7702 example — it maps result.bytecode into one executeBatch type-4 transaction. Smart account: add output=userOperation to the bytecode request and submit the returned userOperation via your bundler. See Smart Account Deposit.

JavaScript

// EOA path — see examples/javascript/strategy-deposit-eip7702.js for the full flow
const { data: result } = await pods.get('/strategies/aave-usdc-polygon/bytecode', {
  params: {
    action: 'lend',
    amount: '10000000',
    wallet: walletAddress
  }
})

// Batch result.bytecode into ONE transaction (EIP-7702 executeBatch or your AA batch).
// Do not: for (const tx of result.bytecode) { await sendTransaction(tx) }
console.log('Legs to batch:', result.bytecode.length)

Step 4: Check Your Position

After depositing, use the /wallets endpoint to check the current position and profit for your strategy.

JavaScript

const { data: wallet } = await pods.get(`/wallets/${walletAddress}`)

wallet.positions.forEach(p => {
  console.log(`Strategy: ${p.strategy.protocol} ${p.strategy.assetName} on ${p.strategy.network}`)
  console.log(`  Current Position: ${p.spotPosition.currentPosition.humanized} ${p.spotPosition.currentPosition.symbol}`)
  console.log(`  Principal: ${p.spotPosition.principal.humanized} ${p.spotPosition.principal.symbol}`)
  console.log(`  Profit: ${p.spotPosition.profit.humanized} ${p.spotPosition.profit.symbol}`)
  console.log(`  APY (gross): ${(p.spotPosition.apy * 100).toFixed(2)}%`) // gross protocol APY, before performance/markup fees
})

console.log(`Total Balance (USD): $${wallet.summary.totalUnderlyingBalanceUSD}`)

cURL

curl -X GET "https://api.pods.finance/wallets/$WALLET_ADDRESS" \
  -H "x-api-key: $PODS_API_KEY"

Example Response

{
  "positions": [
    {
      "spotPosition": {
        "currentPosition": {
          "value": "10048700",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "profit": {
          "value": "48700",
          "decimals": 6,
          "humanized": "0.0487",
          "symbol": "USDC"
        },
        "principal": {
          "value": "10000000",
          "decimals": 6,
          "humanized": "10.00",
          "symbol": "USDC"
        },
        "underlyingBalanceUSD": 10.05,
        "apy": 0.0482 // gross APY — before performance and markup fees
      },
      "strategy": {
        "id": "Aave-USDC-polygon",
        "assetName": "USDC",
        "protocol": "Aave",
        "network": "polygon",
        "asset": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
        "assetDecimals": 6
      }
    }
  ],
  "summary": {
    "totalUnderlyingBalanceUSD": 10.05
  }
}

Call this endpoint periodically to track how your user’s position grows over time.

Next Steps

Executing Bytecode

Atomic batching and output format for your wallet stack

Check Positions

Verify the deposit and monitor your user’s yield position

Withdraw

Generate withdrawal transaction data

All Yield Guides

Browse strategies, deposit, check positions, and withdraw

Add Swaps

Also integrate token swaps into your app

Overview

Guides

Integrations

Agents

Add Yield to Your App in 5 Minutes

API Key

Wallet

Step 1: Browse Available Strategies

Step 2: Generate Deposit Bytecode

Step 3: Execute Transactions

Step 4: Check Your Position

Next Steps

Executing Bytecode

Check Positions

Withdraw

All Yield Guides

Add Swaps

API Key

Wallet

​Step 1: Browse Available Strategies

​Step 2: Generate Deposit Bytecode

​Step 3: Execute Transactions

​Step 4: Check Your Position

​Next Steps

Executing Bytecode

Check Positions

Withdraw

All Yield Guides

Add Swaps

Step 1: Browse Available Strategies

Step 2: Generate Deposit Bytecode

Step 3: Execute Transactions

Step 4: Check Your Position

Next Steps