get

/v4/users/{address}/rewards

Get the rewards associated to a user on a given chain.

Request Examples

Fetch rewards for a user wallet on a specific chain
curl "https://api.merkl.xyz/v4/users/0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb/rewards?chainId=1"

Use the returned proofs to build a claim transaction integrating-user-reward

Retrieve user rewards aggregated by chain. Use query parameters to filter by chain IDs, reward type, and claimability.

Path parameters

addressstring
required

Query parameters

chainIdstring[]
required
reloadChainIdnumber | string
testboolean
claimableOnlyboolean
breakdownPagenumber | stringdefault: 0
typeenum
TOKENPRETGEPOINT
showPrivateboolean

Responses

200
Response for status 200
Schema
object[]
chainobjectChain
idinteger
required
Chain Id
namestring
required
Legible name of the chain
iconstring
required
URL to the icon of the chain
liveCampaignsnumber
required
Number of campaigns currently live on this chain
endOfDisputePeriodnumber
required
explorersobject[]
typeenumETHERSCANBLOCKSCOUTSOLSCAN
urlstring
chainIdnumber
lastClaimsOnchainFetchTimestampstring | null
required
Timestamp of the last claims onchain fetch
rewardsobject[]List of rewards for each token
rootstringMerkle tree root hash for the reward claim
recipientstringAddress of the reward recipient
proofsstring[]Merkle proofs for reward verification
tokenobjectToken information
addressstring
required
Token contract address
chainIdnumber
required
Chain ID where the token exists
symbolstring
required
Token symbol
decimalsnumber
required
Token decimals
breakdownsobject[]Detailed breakdowns of rewards by reason and campaign
reasonstringReason identifier for the reward
amountstringTotal reward amount for this reason
claimedstringAmount already claimed
pendingstringAmount pending claim
campaignIdstringID of the campaign that generated this reward
opportunityIdstringID of the opportunity this breakdown is attributed to
campaignStatusobject
campaignIdstring
required
computedUntilstring | number | string
required
processingStartedstring | number | string
required
statusstring
required
preComputeProcessingStartedstring | number | string
required
preComputeStatusstring
required
delaynumber | string
errorstring
detailsany
claimedbigint | stringTotal amount claimed by the user
amountbigint | stringTotal reward amount
pendingbigint | stringTotal pending reward amount
Example
[
  {
    "chain": {
      "id": 0,
      "name": "string",
      "icon": "string",
      "liveCampaigns": 0,
      "endOfDisputePeriod": 0,
      "explorers": [
        {
          "type": null,
          "url": "string",
          "chainId": 0
        }
      ],
      "lastClaimsOnchainFetchTimestamp": "string"
    },
    "rewards": [
      {
        "root": "string",
        "recipient": "string",
        "proofs": [
          "string"
        ],
        "token": {
          "address": "string",
          "chainId": 0,
          "symbol": "string",
          "decimals": 0
        },
        "breakdowns": [
          {
            "reason": null,
            "amount": null,
            "claimed": null,
            "pending": null,
            "campaignId": null,
            "opportunityId": null,
            "campaignStatus": null
          }
        ],
        "claimed": null,
        "amount": null,
        "pending": null
      }
    ]
  }
]
get
https://api.merkl.xyz/v4/users/{address}/rewards
Merkl API
curl -X GET "https://api.merkl.xyz/v4/users/{address}/rewards"
Fill the required path parameter address to send.