get

/v4/rewards/rank

Returns the rank of a user in a campaign leaderboard, based on reward amount. Returns an empty array if the rank is not yet available.

Query parameters

chainIdnumber | string

required

Distribution chain ID (numeric, e.g. 1 for Ethereum). See ID types.

campaignIdstring

required

On-chain campaign ID (32-byte hex hash, e.g. 0x93cf385c...). NOT the internal Campaign.id. See ID types.

userAddressstring

required

Wallet address to look up rank for.

hideboolean

If true, excludes creator and admin from ranking (adjusts rank accordingly).

get

https://api.merkl.xyz/v4/rewards/rank?chainId=&campaignId=&userAddress=

Merkl API

curl -X GET "https://api.merkl.xyz/v4/rewards/rank?chainId=1&campaignId=0xa61805d510cfeb7efc2bde8615eae414bb861b520b77c87ace9cfb7dd61789aa&userAddress=0xd93814273b33DD33B32cD345225CfB65DEB048Dd"