/v4/campaigns/count

0-indexed page number

Number of items returned by page

Filter by internal campaign ID (Campaign.id, numeric hash, e.g. 13896840291241714382). NOT the on-chain campaignId (hex hash) — use the campaignId query for that. Comma-separated list supported. See ID types.

Filter campaigns created by a user who has a specific tag

Filter campaigns created by a user who is registered as a merkl creator

Filter by compute chain.
You can get the list of all supported chains by calling GET /v4/chains

Search amongst multiple values (token, protocols, tags, campaigns)

Filter by distribution chain.
You can get the list of all supported chains by calling GET /v4/chains

Filter by type of campaign

Filter by type of campaign using an array. The type entry has priority.

Silo, Radiant, Morpho, Dolomite, Compound, Ajna and Euler campaigns have a subtype attribute you can filter on

Filter by on-chain campaign ID (Campaign.campaignId, 32-byte hex hash, e.g. 0x93cf385c2a446a7596820601caf25e63bfc4939efa9a89a6f21563b58ee54eb1). The same on-chain campaignId can exist on several chains; one resource per chain is returned. NOT the internal Campaign.id (numeric hash) — use the id query for that. See ID types.

Filter by multiple on-chain campaign IDs (32-byte hex hashes). The campaignId entry has priority over this one. NOT internal Campaign.id values. See ID types.

Filter by mainParameter (a.k.a. opportunity identifier) — the value used to group campaigns into one opportunity. Can be a pool/vault/market address (e.g. 0x35Cbe854...) or an arbitrary on-chain hash. NOT a campaign or opportunity ID. See ID types.

Filter by reward token symbol (e.g. USDC for campaigns rewarding in USDC)

Filter results by the reward token address. Use in combination with chainId for accuracy

Return campaigns rewarding in test tokens

Filter by token type. Use POINT to include point campaigns and PRETGE to include preTGE campaigns. By default every token is returned.

Return campaigns rewarding in points

Filter by internal opportunity ID (Opportunity.id, numeric hash, e.g. 7673870997270712040). Lookup at GET /v4/opportunities. NOT a campaign ID. See ID types.

Filter by multiple internal opportunity IDs. The opportunityId entry has priority over this one. See ID types.

Comma-separated list of statuses to filter by. Legal values: LIVE, PAST, SOON. When omitted, returns all campaigns regardless of status.

Returns campaigns starting *after* the given unix timestamp

Returns campaigns ending *after* the given unix timestamp

Include opportunity data. Will slow down the request. Default: false

Exclude subcampaigns from the results. Default: false

Get Only Subcampaigns. Default: false

Filter by root internal campaign ID (Campaign.id, numeric hash). Returns only subcampaigns sharing this root. See ID types.

Filter by parent internal campaign ID (Campaign.id, numeric hash). Returns only subcampaigns sharing this parent. See ID types.

Filter by protocol slug (e.g. aave, morpho). NOT a numeric ID. List slugs at GET /v4/protocols.

Filter by compute-pause reason. Returns only campaigns whose pauseCompute matches this exact reason (e.g. paused_high_amount).

When true, include private campaigns the caller (JWT or API key owner) is authorized to see, decoded. When false (default), only public campaigns are returned. Bypasses CDN cache.

Address that owns the campaign lists referenced by campaignLists. Required when campaignLists is set.

Comma-separated list names owned by listOwner (stored in the global campaign-lists config). Returns campaigns whose ID is in *any* of the given lists (union). List names are case-insensitive. Lists are shareable — anyone can query any owner's lists. Example: baseapp,renew.