Rewards API

Endpoints for checking and claiming rewards.

GET /api/rewards

Get claimable rewards for an address.

Query Parameters

Parameter	Type	Description
address	string	Wallet address
chainId	number	Chain ID
token	string	(optional) Specific token

Response

json

{
  "rewards": [
    {
      "token": "0x...",
      "tokenSymbol": "TKN",
      "nftCollection": "0x...",
      "collectionName": "Cool NFTs",
      "ownedTokenIds": [1, 42, 100],
      "claimable": "0.05",
      "claimed": "0.10",
      "total": "0.15"
    }
  ],
  "totalClaimable": "0.05",
  "totalClaimed": "0.10"
}

GET /api/total-rewards

Get protocol-wide reward statistics.

Response

json

{
  "totalRewards": "150.5",
  "totalClaimed": "100.2",
  "totalPending": "50.3",
  "last24h": "5.2"
}

POST /api/rewards/claim

Generate claim transaction data.

Request Body

json

{
  "token": "0x...",
  "tokenIds": [1, 42, 100],
  "chainId": 8453
}

Response

json

{
  "to": "0x...",
  "data": "0x...",
  "value": "0",
  "estimatedGas": "150000"
}