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

# List Venues

> GET /v1/venues — Discover yield venues and strategies

<Note>
  **Endpoint:** `GET https://api.rebelfi.io/v1/venues`
</Note>

Retrieve all available venues with their strategies.

### Query Parameters

| Parameter                | Type      | Required | Description                                                                                                                   |
| ------------------------ | --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `blockchain`             | `string`  | No       | Filter by blockchain: `solana`, `polygon`, `ethereum`, or `base`                                                              |
| `token`                  | `string`  | No       | Filter by token symbol (e.g., `USDC`)                                                                                         |
| `supportsGasSponsorship` | `boolean` | No       | When `true`, only returns strategies compatible with gas-sponsored wallets. Venues with no compatible strategies are omitted. |

### Example Request

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.rebelfi.io/v1/venues?blockchain=ethereum&token=USDC" \
    -H "x-api-key: your_api_key"
  ```

  ```typescript SDK theme={null}
  const { venues, count, strategyCount } = await client.venues.list({
    blockchain: 'ethereum',
    token: 'USDC'
  });
  ```
</CodeGroup>

### Example Response

```json theme={null}
{
  "venues": [
    {
      "id": 3,
      "name": "AAVE V3",
      "protocol": "aave-v3",
      "blockchain": "ethereum",
      "iconUrl": "https://cdn.rebelfi.io/venues/aave.svg",
      "status": "active",
      "strategies": [
        {
          "strategyId": 5,
          "name": "USDC Lending",
          "token": "USDC",
          "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "apy": 0.052,
          "tvl": "2500000000000000",
          "minDeposit": "1000000",
          "maxDeposit": null,
          "status": "active",
          "supportsGasSponsorship": false
        }
      ]
    },
    {
      "id": 4,
      "name": "Morpho",
      "protocol": "morpho",
      "blockchain": "ethereum",
      "iconUrl": "https://cdn.rebelfi.io/venues/morpho.svg",
      "status": "active",
      "strategies": [
        {
          "strategyId": 6,
          "name": "USDC Vault",
          "token": "USDC",
          "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "apy": 0.068,
          "tvl": "850000000000000",
          "minDeposit": "1000000",
          "maxDeposit": null,
          "status": "active",
          "supportsGasSponsorship": false
        }
      ]
    },
    {
      "id": 1,
      "name": "Kamino",
      "protocol": "kamino",
      "blockchain": "solana",
      "iconUrl": "https://cdn.rebelfi.io/venues/kamino.svg",
      "status": "active",
      "strategies": [
        {
          "strategyId": 1,
          "name": "USDC Vault",
          "token": "USDC",
          "tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "apy": 0.085,
          "tvl": "125000000000000",
          "minDeposit": "1000000",
          "maxDeposit": "10000000000000",
          "status": "active",
          "supportsGasSponsorship": true
        }
      ]
    }
  ],
  "count": 3,
  "strategyCount": 3
}
```

### Response Fields

| Field           | Type      | Description                        |
| --------------- | --------- | ---------------------------------- |
| `venues`        | `Venue[]` | List of venues                     |
| `count`         | `number`  | Total number of venues             |
| `strategyCount` | `number`  | Total strategies across all venues |

### Venue Object

| Field        | Type         | Description                         |
| ------------ | ------------ | ----------------------------------- |
| `id`         | `number`     | Venue identifier                    |
| `name`       | `string`     | Display name                        |
| `protocol`   | `string`     | Protocol identifier                 |
| `blockchain` | `string`     | Blockchain network                  |
| `iconUrl`    | `string?`    | Venue icon URL                      |
| `status`     | `string`     | `active`, `paused`, or `deprecated` |
| `strategies` | `Strategy[]` | Available strategies                |

### Strategy Object

| Field                    | Type      | Description                                            |
| ------------------------ | --------- | ------------------------------------------------------ |
| `strategyId`             | `number`  | Strategy identifier (use for supply/unwind)            |
| `name`                   | `string`  | Display name                                           |
| `token`                  | `string`  | Token symbol                                           |
| `tokenAddress`           | `string`  | Token contract address                                 |
| `apy`                    | `number`  | Current APY as decimal (0.085 = 8.5%)                  |
| `tvl`                    | `string?` | Total value locked (base units)                        |
| `minDeposit`             | `string?` | Minimum deposit (base units)                           |
| `maxDeposit`             | `string?` | Maximum deposit (base units)                           |
| `status`                 | `string`  | `active` or `paused`                                   |
| `supportsGasSponsorship` | `boolean` | Whether this strategy works with gas-sponsored wallets |