Skip to main content
GET
Get Earnings
Endpoint: GET https://api.rebelfi.io/v1/allocations/earnings
Get daily earnings history for a wallet.

Query Parameters

Provide exactly one wallet identifier, plus required filters:
ParameterTypeRequiredDefaultDescription
walletAddressstringOne of-Wallet address
walletIdnumberOne of-Wallet ID
userIdstringOne of-External user ID
blockchainstringYes-Blockchain: solana, polygon, ethereum, or base
tokenstringYes-Token symbol (e.g., USDC)
daysnumberNo30Days of history (max 365)
includeBreakdownbooleanNofalseInclude per-venue breakdown

Example Request

Example Response

Response Fields

FieldTypeDescription
walletAddressstringQueried wallet address
blockchainstringBlockchain network
tokenstringToken symbol
periodStartstringStart of period (YYYY-MM-DD)
periodEndstringEnd of period (YYYY-MM-DD)
firstActivityDatestring?First date with data (null if never active)
totalYieldEarnedstringTotal yield in period (base units)
totalYieldEarnedUsdstringTotal yield in USD
historyEarningsDay[]Daily earnings (sparse — only dates with data)
byVenueVenueEarnings[]?Per-venue breakdown (if requested)

EarningsDay Object

FieldTypeDescription
datestringDate (YYYY-MM-DD)
yieldEarnedstringYield earned that day (base units, can be negative)
yieldEarnedUsdstringYield in USD
cumulativeYieldstringCumulative yield from first activity
positionValuestringClosing position value
The history array is sparse — it only contains entries for dates where there was activity or yield. Days without activity are omitted.