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

# Overview

> Discover and query real-time and historical data for DeFi vaults and lending opportunities.

The Opportunities API lets you discover available vaults, query real-time APY and TVL data, and filter opportunities by chain, token, and TVL. This section is focused on data. For executing on-chain transactions against opportunities see the [Earn API](/sdk/earn-api/overview) section.

<CardGroup cols={2}>
  <Card title="Opportunities" icon="magnifying-glass" href="/sdk/opportunities/get-opportunities">
    Query and filter all available yield opportunities.
  </Card>

  <Card title="Historical Data" icon="chart-line" href="/sdk/opportunities/historical">
    Time-series APY, TVL, and share price data. Coming Soon.
  </Card>
</CardGroup>

## What you can do

* Fetch all opportunities scoped to your distributor
* Filter by chain, token, TVL, and deposit mode
* Query APY breakdowns with base and reward split
* Get fee structures per opportunity
* Check deposit capacity and minimum deposit amounts

<Note>
  All opportunity data is scoped to your `distributor_id`. The opportunities returned are configured in your [Turtle Dashboard](https://dashboard.turtle.xyz).
</Note>