Skip to main content

getOnchainEarnings

Get onchain earnings for a wallet with total earnings by token.

Signature​

getOnchainEarnings(walletAddress: string): Promise<OnchainEarningsResponse>

Parameters​

ParameterTypeRequiredDescription
walletAddressstring✅Smart wallet address

Returns​

Onchain earnings data with total earnings by token

Return Type​

// TokenEarnings is a record of token symbols to amounts
type TokenEarnings = Record<string, number>;  // e.g., { "USDC": 100.5, "WETH": 0.025 }

interface OnchainEarningsResponse {
  success: boolean;
  data: OnchainEarnings;
}

interface OnchainEarnings {
  walletAddress: string;
  totalEarningsByToken: TokenEarnings;
  lastCheckTimestamp?: string;
  lastLogDate?: Record<string, string | null>;
}

Example​

const earnings = await sdk.getOnchainEarnings("0x...");

console.log("Total earnings by token:", earnings.data.totalEarningsByToken);
// { "USDC": 150.50, "WETH": 0.05 }

console.log("USDC earnings:", earnings.data.totalEarningsByToken["USDC"]);
console.log("WETH earnings:", earnings.data.totalEarningsByToken["WETH"]);