Creator stats API & widget

Two public surfaces backed by the same data - the keeper's own distribution ledgers:

• GET /embed/:address/stats - a JSON feed of a token's distribution stats.
• degen.zone/embed/:address - an iframe-ready card that renders those stats.

Returns the distribution stats for one token, keyed by its feeModel. The response always carries the token identity and the cadence; the reward and buyback blocks are populated according to which model the token runs (a standard token has both null).

curl -s https://api.degen.zone/v1/embed/0xToken…/stats

Method

GET

Auth

None (public)

Cache

~60s

CORS

All origins

Cadence

~15 min

feeModel

reward · buybackBurn · standard

Money is returned as an asset object everywhere: { raw, amount, symbol, decimals, address } - raw is the exact base-unit string, amount is the whole-unit number for a quick label.

When feeModel is reward, the reward block is populated (and buyback is null):

{
  "feeModel": "reward",
  "reward": {
    "asset":            { "symbol": "IBM", "decimals": 18, "address": "0x…" },
    "totalDistributed": { "amount": 26.28, "raw": "26280000000000000000", "symbol": "IBM", … },
    "toHolders":        { "amount": 26.28, "symbol": "IBM", … },
    "devPaid":          { "amount": 0,     "symbol": "IBM", … },
    "holderPercent":    100,
    "runs":             4,
    "lastAt":           "2026-09-03T09:12:00.000Z",
    "nextEstimatedAt":  "2026-09-03T09:27:00.000Z"
  }
}

• toHolders / devPaid split the total by the creator's reward/dev slider (holderPercent).
• runs is the number of distribution cycles; lastAt / nextEstimatedAt bracket the schedule.

When feeModel is buybackBurn, the buyback block is populated:

{
  "feeModel": "buybackBurn",
  "buyback": {
    "asset":       { "symbol": "USDG", "decimals": 6, "address": "0x…" },
    "totalBurned": { "amount": 1230.0, "raw": "1230000000", "symbol": "USDG", … },
    "devPaid":     { "amount": 307.5,  "symbol": "USDG", … },
    "burnPercent": 80,
    "burns":       37,
    "lastAt":          "2026-09-03T09:12:00.000Z",
    "nextEstimatedAt": "2026-09-03T09:27:00.000Z"
  }
}

• totalBurned is the value bought-and-burned (the burnPercent share of each cycle); devPaid is the creator's non-burned share.
• asset is the pool's quote asset the buyback spends (native ETH or a quote token like USDG).

The same data, rendered as a self-contained card at degen.zone/embed/:address. Drop it into any page with an iframe - it carries its own styling and needs no script:

<iframe
  src="https://degen.zone/embed/0xToken…"
  width="400" height="270"
  style="border:0;border-radius:14px;overflow:hidden"
  loading="lazy" title="degen.zone stats">
</iframe>

The card shows the headline (paid-to-holders or bought-and-burned), the cycle count, and a live "last / next distribution" line that ticks inside the frame. A standard token with no distribution model renders a short neutral state.

Live - the stats endpoint and the widget are live on Robinhood Chain for reward and buyback-and-burn tokens. Standard tokens return a valid response with feeModel: "standard" and both distribution blocks null.