RewardEntry

One reward program on a lending market, one entry per (reward token, source). A borrow-side APR REDUCES the cost of borrowing — dTRINITY dLEND is the extreme case, where the rebate exceeds the interest and the net borrow rate is negative. Rewards are NEVER folded into health-factor or liquidation math: those use the gross rate.

assetstring

Reward token address, lowercased. For a points program (kind: "points") there is no token and this is a synthetic points:<sourceId> key.

symbolstringnullable

Reward token symbol. Denormalized deliberately — reward tokens are routinely absent from the asset table (aMonUSDe, WMON, aHorRwaRLUSD are live examples), so a join would leave them unnamed.

decimalsintegernullable

Token decimals — divide raw amounts by 10 ** decimals.

logoURIstringnullable

URL of the logo image.

depositRatenumber

Reward APR on deposits

variableBorrowRatenumber

Reward APR on variable borrows

stableBorrowRatenumber

Reward APR on stable borrows

kindstringnullable

token | points. Points are NOT priceable and must be shown separately from any headline APR.

claimstringnullable

How the reward is realized, i.e. whether the APR is bankable. accrual — claimable from the protocol on-chain; merkl — off-chain merkle distribution; manual.

sourcestring

LEGACY mechanism tag (merkle, onchain-incentives, native) — it cannot distinguish two programs on the same platform. Prefer sourceId.

sourceIdstringnullable

Stable program identifier, safe to key on: merkl:aave, merkl:euler, merkl:morpho, dtrinity:rebate.

sourceLabelstringnullable

Display string for the program, e.g. Merkl · Aave.

linkstringnullable

Deep link to THIS program — the exact Merkl opportunity page, not a protocol homepage.

endsAtnumbernullable

Unix seconds the program stops paying. An APR with two weeks left is not the same product as a standing rate, so render it.

startsAtnumbernullable

dailyRewardsUsdnumbernullable

Program-wide payout rate in USD/day, as the source reports it.

refs objectnullable

Platform identifiers verbatim — Merkl campaign ids and opportunity type, or the incentives-controller address for an on-chain program. For support and deduplication, not display.

property name*anynullable

Platform identifiers verbatim — Merkl campaign ids and opportunity type, or the incentives-controller address for an on-chain program. For support and deduplication, not display.

RewardEntry

{
  "asset": "string",
  "symbol": "string",
  "decimals": 0,
  "logoURI": "string",
  "depositRate": 0,
  "variableBorrowRate": 0,
  "stableBorrowRate": 0,
  "kind": "string",
  "claim": "string",
  "source": "string",
  "sourceId": "string",
  "sourceLabel": "string",
  "link": "string",
  "endsAt": 0,
  "startsAt": 0,
  "dailyRewardsUsd": 0,
  "refs": {}
}