v1

latestOpenAPI 3.0.02026-07-2442138225.7 KB

Discovery

Get yield campaigns

Returns campaign metadata for the given yield opportunity within the API key project scope.

get/v1/yields/{yieldId}/campaigns

Path parameters

yieldIdstring required

Yield integration ID.

Query parameters

offsetnumber

Offset for pagination

limitnumber

Maximum number of items to return

status'draft' | 'active' | 'paused' | 'ended'

Campaign status filter. Defaults to active.

Response

Campaign metadata for the given yield

totalnumber required

Total number of items available

offsetnumber required

Offset of the current page

limitnumber required

Limit of the current page

Example response

{
  "total": 150,
  "limit": 100,
  "items": [
    {
      "rewardRate": {
        "total": 6.5,
        "rateType": "APR",
        "components": [
          {
            "rate": 0.04,
            "rateType": "APR",
            "token": {
              "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6
            },
            "yieldSource": "protocol_incentive",
            "description": "LDO distributed to incentivize stETH adoption via Lido Boost"
          }
        ]
      },
      "apyCeiling": 0.125,
      "qualificationConfig": {
        "threshold": "100",
        "maxIncentivizedTvlToken": "1000000"
      },
      "rewardToken": {
        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6
      }
    }
  ]
}