---
title: "GET /v4/protocols/"
method: GET
path: "/v4/protocols/"
tags: ["Protocols"]
---

# GET /v4/protocols/

`GET /v4/protocols/`

List protocols supported and integrated by Merkl. Use query parameters to filter by chain ID, tags, or other criteria.

## Query parameters

- `page` union — 0-indexed page number
  - string, numeric
  - number — 0-indexed page number
- `items` union — Number of items returned by page
  - string, numeric
  - number — Number of items returned by page
- `id` string — Filter by **protocol slug** (e.g. `aave`, `morpho`, `uniswap`). NOT a numeric ID. See [ID types](/integrate-merkl/id-types).
- `test` boolean — Includes protocols that have only test opportunities
- `ids` string[] — Filter by multiple **protocol slugs** (e.g. `aave`, `morpho`).
- `name` string — Search protocols by name
- `tags` string[] — Filter by tags
- `opportunityTag` string — Filter by underlying tag opportunities
- `opportunityChain` union — Filter by underlying opportunity chains
  - string, numeric
  - number — Filter by underlying opportunity chains
- `status` unknown
- `tokenTypes` union[] — Filter campaigns counted in `numberOfLiveCampaigns` and `dailyRewards` by reward token type. Default: no filter.
  - union
    - string
    - string
    - string
- `excludeSubCampaigns` boolean — Exclude sub-campaigns from the campaigns counted in `numberOfLiveCampaigns` and `dailyRewards`. Default: false.

## Response `200`

Response for status 200

- object[]
  - `id` string, required
  - `name` string, required
  - `icon` string, required
  - `tags` string[], required
  - `description` string, required
  - `url` string, required
  - `dailyRewards` number
  - `numberOfLiveCampaigns` number
  - `opportunityLiveTags` string[]
  - `banner` string, required
  - `opportunityBannerLight` string, required
  - `opportunityBannerDark` string, required
  - `trustData` object, required
    - `slug` string, required
    - `category` string, required
    - `audits` string, required
    - `audit_links` string[], required
    - `audit_note` string, required
    - `github` string[], required
    - `twitter` string, required
    - `listedAt` number, required
    - `parentProtocol` string, required
    - `tvl` number
    - `hacks` object[]
      - `date` number, required
      - `name` string, required
      - `amountUSD` number, required
      - `technique` string, required
      - `source` string, required
    - `syncedAt` number, required

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) · [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/merkl/merkl-api/revisions/a7e5b9f6fb5f/schema)