---
title: "GET /v4/opportunities/bins/daily-rewards"
method: GET
path: "/v4/opportunities/bins/daily-rewards"
tags: ["Opportunities"]
---

# GET /v4/opportunities/bins/daily-rewards

`GET /v4/opportunities/bins/daily-rewards`

## Request

- Base URL: `https://api.merkl.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.merkl.xyz/v4/opportunities/bins/daily-rewards`
- Auth: `apiKey` (a scheme the document does not define)

Get the daily rewards distribution of opportunities matching the query, grouped into bins.

## Query parameters

- `page` union: 0-indexed page number
  - string, integer
  - integer: 0-indexed page number
- `items` union: Number of items returned by page
  - string, integer
  - integer: Number of items returned by page
- `name` string: Filter by name
- `search` string: Search amongst multiple values (token, protocols, tags, campaigns)
- `campaignId` string: Filter opportunities linked to a given **on-chain campaign ID** (32-byte hex hash, e.g. `0x93cf385c2a446a7596820601caf25e63bfc4939efa9a89a6f21563b58ee54eb1`). This is `Campaign.campaignId` in responses, NOT the internal `Campaign.id` (numeric hash). Returns `[]` if no campaign matches. See [ID types](/integrate-merkl/id-types).
- `creatorSlug` string: Filter by creator slug
- `chainId` unknown
- `action` string: A comma seprated list actions. Legal values are: POOL, HOLD, DROP, LEND, BORROW, LONG, SHORT, SWAP, INVALID, STAKE
- `tokenTypes` union[]: Filter by token type. Use POINT to include point campaigns and PRETGE to include preTGE campaigns. By default every token is returned.
  - union
    - string
    - string
    - string
- `point` boolean: Include opportunities with point campaigns
- `type` string: A comma separated list of Opportunity type
- `creatorAddress` string: Filter by creator address
- `tags` string: Filter by tag
- `test` boolean: Include opportunities with test campaigns
- `minimumTvl` number: Minimum TVL threshold in USD
- `maximumTvl` number: Maximum TVL threshold in USD
- `minimumApr` number: Minimum APR threshold
- `maximumApr` number: Maximum APR threshold
- `minimumDailyRewards` number: Minimum daily rewards threshold in USD
- `maximumDailyRewards` number: Maximum daily rewards threshold in USD
- `minimumCreatedAt` number: Filter opportunities whose last campaign was created at or after this Unix timestamp (seconds)
- `maximumCreatedAt` number: Filter opportunities whose last campaign was created at or before this Unix timestamp (seconds)
- `status` unknown
- `identifier` string: Filter by opportunity identifier (a.k.a. `mainParameter`). Free-form string, often a pool/vault/market address (e.g. `0x35Cbe8542E70fa2f7F9cDF129F19e593F4b4f560`) or an arbitrary on-chain hash for non-address opportunities. NOT a campaign ID. See [ID types](/integrate-merkl/id-types).
- `id` string: A comma-separated list of **internal opportunity IDs** (`Opportunity.id`, numeric hash). Example: `?id=5877322385708089533,1234567890`. NOT campaign IDs. See [ID types](/integrate-merkl/id-types).
- `campaigns` boolean: Include campaign data. Will slow down the request. Default: false
- `tokens` string: A comma separated list of token symbol. Use to filter by token
- `stablecoin` boolean: Filter opportunities that include at least one stablecoin token
- `rewardTokenSymbol` string: Filter by opportunity that have at least 1 campaigns where the reward token has this symbol
- `sort` unknown
- `order` string: `asc` to sort in ascending order or `desc` to sort in descending order.
- `distributionTypes` union[]
  - union: Filter by reward mechanism. Legal values are: `FIX_REWARD`, `MAX_REWARD`, `DUTCH_AUCTION`, `TOTAL_APR`. Default: no filter
    - string
    - string
    - string
    - string
- `mainProtocolId` string: A comma-separated list of **protocol slugs** (e.g. `aave,morpho,uniswap`). NOT numeric IDs. List slugs at [GET /v4/protocols](#tag/protocols/GET/v4/protocols/). See [ID types](/integrate-merkl/id-types).
- `programSlugs` string: A comma separated list of program ids or slugs. You can get the list of all supported programs by calling [GET /v4/programs](#tag/programs/GET/v4/programs/)
- `chainName` unknown
- `excludeSubCampaigns` boolean: Exclude sub-campaigns from the results. Default: false
- `explorerAddress` string: Filter by **on-chain pool/vault/market address** (20-byte EVM address, e.g. `0x35Cbe8542E70fa2f7F9cDF129F19e593F4b4f560`). Often the most reliable way to look up an opportunity if you only know the underlying contract. See [ID types](/integrate-merkl/id-types).
- `withInvalids` boolean: Include opportunities that have been marked as invalid
- `campaignTypes` unknown

## Response `200`

Response for status 200

- object
  - `data` object[], required
    - `count` number, required
    - `min` number, required
    - `max` number, required

## Changes

- **2026-10-02** `545c27b01dd9`: 2 breaking, 1 warning
  - `query` request parameter `items` list-of-types was narrowed by removing types `number`
  - `query` request parameter `page` list-of-types was narrowed by removing types `number`
  - for the `query` request parameter `page`, the max was set to `1000000.00`

[Operation history](https://skmtc.dev/merkl/apis/merkl-api/changes/v4/opportunities/bins/daily-rewards/get.md)

---

[API](https://skmtc.dev/merkl/apis/merkl-api.md) - [All operations](https://skmtc.dev/merkl/apis/merkl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merkl/apis/merkl-api/revisions/60ffe2c7d887?raw)