Skip to main content
GET
/
v1
/
wallets
/
{wallet_id}
/
earn
/
ethereum
/
incentive
/
claim
Get incentive rewards
curl --request GET \
  --url https://api.privy.io/v1/wallets/{wallet_id}/earn/ethereum/incentive/claim \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'privy-app-id: <privy-app-id>'
{
  "rewards": [
    {
      "token_address": "0x0000000000000000000000000000000000000000",
      "token_symbol": "MORPHO",
      "token_decimals": 18,
      "amount_claimed": "1000000000000000000",
      "amount_unclaimed": "500000000000000000"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.privy.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic Auth header with your app ID as the username and your app secret as the password.

Headers

​
privy-app-id
string
required

ID of your Privy app.

Path Parameters

​
wallet_id
string
required

ID of the wallet.

Query Parameters

​
chain
string
required

Chain name to fetch rewards for (e.g. "base", "ethereum").

Response

200 - application/json

Incentive rewards retrieved successfully.

All incentive rewards for a wallet, with claimed and unclaimed amounts per token.

​
rewards
EarnIncentiveRewardEntry · object[]
required

Reward tokens with their claimed and unclaimed amounts.