Earnings

When a player spends Spawnites in your game, part of what those Spawnites brought in becomes your earning. An account that earned nothing reads zeros.

What a spent Spawnite earns

A player buys Spawnites in packs. Each pack remembers what it brought in after the payment provider’s fee and the sales tax, its net. A spend draws the player’s oldest Spawnites first, and each Spawnite carries its pack’s net per Spawnite. The earnings of a spend are the following:

The creator earns 70 percent of the net the spent Spawnites carry.
An influencer whose referral code is on the player’s account earns the platform’s 5 percent referral from the platform’s share. The creator still earns 70 percent.

What a Spawnite earns depends on where the player bought it, because each channel keeps a different fee. A pack of 1,000 Spawnites that nets $9.00 earns a creator 63 cents for every 100 Spawnites spent; one that nets $6.99, after an app store’s 30 percent, earns 48.9 cents. The 30-day average per Spawnite shows what your Spawnites earned of late, so you never read a pack.

Pending, available, reversed and paid

Each earning goes through the following stages:

Pending. An earning is pending until 60 days after the calendar month of its spend ends, in UTC, as When you are paid says, so a refund or a chargeback in those days takes it back before it is paid.
Available. After that date, the next monthly payout pays it, once what is available reaches $200. The platform can freeze a game’s earnings while it reviews the game; no payout pays a frozen game’s earnings until the freeze lifts.
Reversed. A refund of a pack, a chargeback of a pack, or a product support returns takes back the earnings on the Spawnites it undoes. The earning stays as it was, and a reversal of the same amount stands beside it, with its reason. A reversal of an earning still pending becomes available on that earning’s date, so the two cancel out; a reversal of an earning already paid is available at once.
Paid. A payout that paid an earning carries it.

Payouts

A payout pays what is available: the earnings past their date, less the reversals, that no earlier payout paid. Each payout lists the earnings and reversals it paid, so its amount reads row by row. The payout’s fee, which the payment rail charges, comes out of the payout, so your statement shows your earnings and what reached you as two amounts. A reversal after a payout can take what is available below zero, and the next payout nets it against new earnings first.

Reading your earnings

spawnite earnings

It prints each role you earned in, a creator’s and an influencer’s apart:

The totals pending, available, reversed and paid, and the part of them the platform froze.
What was paid out: the payouts’ total, the fees they paid, and what reached you, with a payout being paid when one is. Then what is available to the next payout.
The next date earnings become available, and how much does by the end of that day. A frozen game’s earnings are left out of it until the freeze lifts.
The last 30 days: what the spends of those days earned, the Spawnites they drew, and the average per 100 Spawnites. A spend a reversal undid counts for neither.
The same totals for each game, most owed first. A game that was removed shows as a removed game.
The newest 20 reversals, newest first, each with its day, its game, the amount and its reason. A page reads at most 1,000 of your earnings, so a page can show fewer reversals, or none, and still print the command for the next.

Amounts print in dollars, cut down to the cent. With --json, the command prints the same fields in micro-dollars, millionths of a dollar, as the platform keeps them.

The command takes the following options:

Option	What it does
`--role <role>`	Prints one role, `creator` or `influencer`.
`--cursor <cursor>`	Prints the next page of a role’s reversals. It needs `--role`. The last line of a page with more prints the full command.

An agent calls the MCP’s earnings tool, which returns the same lines and takes role and cursor the same way. Each account reads only its own earnings.