Earnings reports
An AI agent can tell you what a wallet earned on GAMA over a period, what was paid out, and what is still waiting to be claimed. It can also report what one token's trading produced. The figures come from the same chain history as the app. Reading them needs no API key and no wallet connection.
What you can ask
Give the agent the wallet or token address you mean. It must not assume the wallet that manages your API key.
- "What did this wallet earn as a creator in the last two days?"
- "How much in holder rewards did this wallet earn last week, token by token?"
- "What has this token produced since it launched?"
Three kinds of earnings
- Creator: the creator's share of a token's trading fees, plus any creator tax, credited to the wallet that was the token's fee recipient when each fee was charged. Creator rights can move, so this is not always the wallet that created the token. See Creator earnings.
- Rewards: holder rewards from reward-mode tokens. See Holder rewards.
- Protocol: fees credited to the recipients of GAMA's protocol share. It is empty if the address received no protocol share.
A report covers one kind at a time.
Periods
The agent can report the last 24 hours, 48 hours, 7 days or 30 days, everything since this release of GAMA began, the last two full days in London time, or any dates you give up to 366 days apart. Without a period it uses the last 48 hours.
Every report states the exact start and end it used and how far back its data goes.
What the figures mean
| Figure | Meaning |
|---|---|
| Earned | What accrued to the wallet in the period, before any charge |
| Paid | What reached the wallet in the period, automatic payouts and claims together |
| Operating charges | The charge kept from automatic payouts, at most 1% of a payment |
| Claimed | Your own claims only |
| Paid automatically | Automatic payouts only |
| Claimable | What is waiting for the wallet at the moment of the report |
Claimed and Paid automatically are the two parts of Paid. Don't add them to it.
A payout can include earnings from before the period, so Paid can be larger than Earned. Claimable is a balance at the time of the report, not income of the period.
One payment can cover credit of more than one kind, or from more than one token: a wallet can hold creator and protocol credit in the same asset and be paid both at once. The report divides that payment, and its operating charge, between them in proportion to the credit each had. The amounts shown per kind and per token are this division of one payment, not separate transfers on the chain.
Each asset's row gives its amounts in that asset's own units. Rows and totals also give ETH and USD at the price when the fee or payment happened, not today's price; a total across several assets has only those two. Claimable is valued at the time of the report. Where a price is missing, the report says the value is unknown. It never shows zero in its place.
Holder rewards accrue in fractions of an asset's smallest indivisible unit, and only whole smallest units can be paid. A rewards report can therefore show a small earned fraction that is not claimable yet. Fractions from different reward tokens cannot be combined to make a payable whole unit.
Token reports
For one token and one period the agent can report its trading volume, number of trades, creator fees, protocol fees and holder rewards. The number of holders and the token's stage are given as they stand at the time of the report, not for the period.
When a report is not ready
- Holder rewards are being prepared. The first rewards report for a wallet is worked out in the background. The agent is told to ask again shortly, and the answer arrives without being started twice.
- The period is too large. A very active wallet over a long period can exceed what one report covers. Ask for a shorter period.
- A token is unavailable. A reward token whose records cannot be checked is listed as unavailable. The report does not count it as zero, and the other tokens still appear.
