v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB

Wallet Actions

Earn incentive claim

Claim incentive rewards for a wallet.

post/v1/wallets/{wallet_id}/earn/ethereum/incentive/claim

Path parameters

wallet_idstring required

ID of the wallet.

Headers

privy-app-idstring required

ID of your Privy app.

privy-authorization-signaturestring

Request authorization signature. If multiple signatures are required, they should be comma separated.

privy-request-expirystring

Request expiry. Value is a Unix timestamp in milliseconds representing the deadline by which the request must be processed.

privy-idempotency-keystring

Idempotency keys ensure API requests are executed only once within a 24-hour window.

Request body

chainstring required

The blockchain network on which to perform the incentive claim. Supported chains include: 'ethereum', 'base', 'arbitrum', 'polygon', 'solana', and more, along with their respective testnets.

Example request

{
  "chain": "base"
}

Response

Earn incentive claim initiated successfully.

chainstring required

EVM chain name (e.g. "base", "ethereum").

created_atstring date-time required

ISO 8601 timestamp of when the wallet action was created.

idstring required

The ID of the wallet action.

status'pending' | 'succeeded' | 'rejected' | 'failed' required

The current status of the wallet action.

type'earn_incentive_claim' required

wallet_idstring required

The ID of the wallet involved in the action.