> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pods.finance/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Welcome to Pods API - Your DeFi Aggregation Platform

Pods API is a comprehensive DeFi aggregation platform that enables seamless cross-chain and same-chain transactions for yield strategies, token swaps, and DeFi protocol integrations.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/getting-started/quickstart">
    Add yield to your app in 5 minutes
  </Card>

  <Card title="Why Pods" icon="lightbulb" href="/getting-started/why-pods">
    The case for using Pods vs building in-house
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Explore our comprehensive API documentation
  </Card>

  <Card title="Guides" icon="book-open" href="/guides/yield/check-protocol-info">
    Step-by-step tutorials for common use cases
  </Card>

  <Card title="Code Examples" icon="terminal" href="/examples/javascript/strategy-deposit">
    Copy-paste ready code examples with ethers.js and viem
  </Card>

  <Card title="Widget Integration" icon="book-open" href="/widget-integration">
    Customer-ready EarnWidget and SwapWidget integration guides
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion title="Cross-Chain Swaps" icon="bridge">
    Execute token swaps across different blockchain networks with automatic bridge routing and transaction monitoring.

    * Supported chains: Ethereum, Base, Optimism, Arbitrum, Solana, Polygon, Gnosis, Bitcoin
    * Multiple bridge providers: Relay, LiFi, Mayan, CCTP, TeleSwap
    * Quote status and execution tracking for cross-chain execution
    * Webhook notifications for status updates
  </Accordion>

  <Accordion title="Same-Chain Swaps" icon="arrows-rotate">
    Optimal routing for swaps within the same blockchain network.

    * Best price aggregation across DEXs
    * Gas-optimized routes
    * Sub-5 minute quote validity
    * Support for ERC-20 and native tokens
  </Accordion>

  <Accordion title="Yield Strategies" icon="chart-line">
    Access to multiple DeFi lending and staking protocols.

    * Protocols: Aave, Morpho, Lido, Compound, and more
    * Automated APY tracking
    * Easy deposit and withdrawal
    * Portfolio position monitoring
  </Accordion>

  <Accordion title="Wallet Tracking" icon="wallet">
    Monitor DeFi positions and yields across multiple protocols.

    * Real-time balance updates
    * Earnings tracking
    * Multi-protocol aggregation
    * Historical transaction data
  </Accordion>
</AccordionGroup>

## What Can You Build?

<CardGroup cols={2}>
  <Card title="DeFi Aggregator" icon="layer-group">
    Build a frontend that aggregates multiple DeFi protocols and provides users with the best yield opportunities.
  </Card>

  <Card title="In-App Yield" icon="vault">
    Offer top DeFi strategies directly in your wallet or application.
  </Card>

  <Card title="Cross-Chain Bridge" icon="bridge-circle-check">
    Integrate cross-chain swaps into your wallet or application.
  </Card>

  <Card title="Portfolio Dashboard" icon="chart-mixed">
    Track user positions across multiple chains and protocols in one place.
  </Card>
</CardGroup>

## Supported Networks

<CardGroup cols={3}>
  <Card title="Ethereum" icon="ethereum">
    Swaps and yield strategies
  </Card>

  <Card title="Base" icon="https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/base.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=756b940eb5231e1cc1e73f57ce2404f2" width="1280" height="1280" data-path="images/networks/base.svg">
    Swaps and yield strategies
  </Card>

  <Card title="Optimism" icon="https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/optimism.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=ebc2c01e20f0ea367f9f3a01ff78d388" width="500" height="500" data-path="images/networks/optimism.svg">
    Swaps and yield strategies
  </Card>

  <Card title="Arbitrum" icon="https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/arbitrum.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=64fe30eadfd3165f4cf0a26a65a3983c" width="2500" height="2500" data-path="images/networks/arbitrum.svg">
    Swaps and yield strategies
  </Card>

  <Card title="Solana" icon="https://mintcdn.com/pods-322144f0/Gg0nLDDM2P07rs2j/images/networks/solana.svg?fit=max&auto=format&n=Gg0nLDDM2P07rs2j&q=85&s=6877e57fdb7a0750b73dfd45cd0a20d2" width="398" height="312" data-path="images/networks/solana.svg">
    Swaps and yield strategies
  </Card>

  <Card title="Polygon" icon="https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/polygon.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=f07eb2cb5771381174b2457ccc35f430" width="178" height="161" data-path="images/networks/polygon.svg">
    Cross-chain bridge support
  </Card>

  <Card title="Gnosis" icon="https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/gnosis.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=1d3db921f11b6e2fcc8abf98a3f60539" width="428" height="428" data-path="images/networks/gnosis.svg">
    Cross-chain bridge support
  </Card>

  <Card title="Bitcoin" icon="https://mintcdn.com/pods-322144f0/Gg0nLDDM2P07rs2j/images/networks/bitcoin.svg?fit=max&auto=format&n=Gg0nLDDM2P07rs2j&q=85&s=a99da267f35c620d61f14be441ddec86" width="4091" height="4092" data-path="images/networks/bitcoin.svg">
    Cross-chain bridge support
  </Card>
</CardGroup>

## Quick Example

Here's a simple same-chain swap in just a few lines:

```javascript theme={null}
import axios from 'axios'

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

// 1. Get quote
const { data: { quote } } = await pods.get('/v2/swap/quote', {
  params: {
    originChain: 'ethereum',
    destinationChain: 'ethereum',
    tokenIn: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48', // USDC
    tokenOut: '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2', // WETH
    amountIn: '1000000000' // 1000 USDC
  }
})

// 2. Generate bytecode
const { data: bytecode } = await pods.post('/v2/swap/bytecode', {
  quoteId: quote.quoteId,
  originAddress: walletAddress,
  destinationAddress: walletAddress,
  ...(quote.rawQuote && { rawQuote: quote.rawQuote })
})

// 3. Execute transaction (using your wallet)
await wallet.sendTransaction(bytecode.transactionData[0])
```

## Next Steps

<Steps>
  <Step title="Get API Key">
    Sign up and get your API key from the [Pods Dashboard](https://www.pods.finance/plg/select-plan)
  </Step>

  <Step title="Follow Quickstart">
    Complete your [first API call](/getting-started/quickstart) in 5 minutes
  </Step>

  <Step title="Explore Guides">
    Learn about [swaps](/guides/swaps/get-quote) and [yield strategies](/guides/yield/check-protocol-info)
  </Step>

  <Step title="Integrate">
    Use our [code examples](/examples/javascript/same-chain-swap) to integrate into your app
  </Step>
</Steps>

## Support & Community

<CardGroup cols={3}>
  <Card title="Documentation" icon="book" href="/api-reference/introduction">
    Comprehensive API documentation
  </Card>

  <Card title="Discord" icon="discord" href="https://discord.gg/pods">
    Join our community
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/pods-finance/deframe-api">
    View examples and contribute
  </Card>
</CardGroup>

<Info>
  **Need help?** Reach out to our support team at [support@pods.finance](mailto:support@pods.finance)
</Info>