Opportunities

Changed on

Get the storingId(s) backing an opportunity, grouped by root campaign. Returns one tree per root campaign matching the requested statuses (default LIVE; past root campaigns are excluded). Each node lists its own storingIds, with sub-campaigns nested under subCampaigns. Sub-campaigns of a matching root are not status-filtered. The same storingId may appear in more than one tree. Stateless campaigns return an empty storingIds array.

get/v4/opportunities/{id}/storing-ids

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/{id}/storing-ids
  • Auth: apiKey (a scheme the document does not define)

Path parameters

idstring required

Opportunity ID (path-only). Two accepted forms: (1) internal numeric hash, ≤20 digits (e.g. 7673870997270712040), or (2) composite {chainId}-{type}-{identifier} (e.g. 1-ERC20LOGPROCESSOR-0x35Cbe8542E70fa2f7F9cDF129F19e593F4b4f560). The composite form is path-only — query filters (?id=, ?opportunityId=) only accept the numeric form. NOT a campaign ID. See ID types.

Query parameters

campaignStatusstring

Comma-separated statuses to include at the root campaign level (LIVE, PAST, SOON). Default LIVE excludes ended root campaigns. Sub-campaigns under a kept root are not status-filtered.

Response

Response for status 200

campaignIdstring required

Onchain campaign id

storingIdsstring[] required

Indexing storingId(s) owned by this campaign only (not children's).

Changes

  • dbc25d192689Revision changes
    • breaking

      the // response's property type changed from no type to object for status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status

    • info

      added the required property /// to the response with the status