# GET /v4/opportunities/

_Merkl API_

**Retrieve Multiple Opportunities**
<p>This endpoint enables you to search for opportunities by providing specific criteria through query parameters.</p>

#### Request Examples

##### List opportunities by protocol name
```bash
curl "https://api.merkl.xyz/v4/opportunities?name=Euler"
```

Returns all opportunities associated with the Euler protocol, including aggregate metrics.

##### Filter by tag
```bash
curl "https://api.merkl.xyz/v4/opportunities?tags=zksync"
```

Returns opportunities tagged with "zksync" across all supported protocols.

### Query parameters

- `page` (string | number)
- `items` (string | number)
- `name` (string)
- `search` (string)
- `campaignId` (string)
- `creatorSlug` (string)
- `chainId` (RegExp)
- `action` (string)
- `tokenTypes` (array)
- `point` (boolean)
- `type` (string)
- `creatorAddress` (string)
- `tags` (string)
- `test` (boolean)
- `minimumTvl` (number)
- `maximumTvl` (number)
- `minimumApr` (number)
- `maximumApr` (number)
- `minimumDailyRewards` (number)
- `maximumDailyRewards` (number)
- `minimumCreatedAt` (number)
- `maximumCreatedAt` (number)
- `status` (RegExp)
- `identifier` (string)
- `id` (string)
- `campaigns` (boolean)
- `tokens` (string)
- `stablecoin` (boolean)
- `rewardTokenSymbol` (string)
- `sort` (RegExp)
- `order` (RegExp)
- `distributionTypes` (array)
- `mainProtocolId` (string)
- `programSlugs` (string)
- `chainName` (RegExp)
- `excludeSubCampaigns` (boolean)
- `explorerAddress` (string)
- `withInvalids` (boolean)
- `campaignTypes` (RegExp)

## Responses

- **200** Response for status 200

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/opportunities/" \
  -H "x-api-key: YOUR_API_KEY"
```