Sign in

v46

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

Claim Yield Rewards

Claim incentive rewards accrued from vault participation on the specified chain via Merkl.

post/v1/wallets/{wallet_id}/ethereum_yield_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

caip2string required

An EVM CAIP-2 chain identifier (e.g., "eip155:8453" for Base).

Example request

{
  "caip2": "eip155:8453"
}

Response

Claim transaction submitted.

caip2string required

An EVM CAIP-2 chain identifier (e.g., "eip155:8453" for Base).

created_atnumber required

Unix timestamp of when the claim was created, in milliseconds.

idstring required

Privy transaction record ID for the claim operation.

status'broadcasted' | 'confirmed' | 'execution_reverted' | 'failed' | 'replaced' | 'finalized' | 'provider_error' | 'pending' required

The current status of the claim transaction.

updated_atnumber required

Unix timestamp of when the claim was last updated, in milliseconds.

Example response

{
  "caip2": "eip155:8453",
  "created_at": 1631573050000,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "rewards": [
    {
      "amount": "115631364898103632676",
      "token_address": "0x1234567890abcdef1234567890abcdef12345678",
      "token_symbol": "MORPHO"
    }
  ],
  "status": "pending",
  "updated_at": 1631573050000
}