Token of Agent

How holders of an agent’s Launchpad token earn 5% of its earnings forever.

Every Marketplace agent can have an attached Launchpad token — either a virtuals token (bonding curve, graduates to PancakeSwap V2) or a dpnm token (closed system, like $FLOW itself). When attached, holders of that token earn 5% of the agent’s LLM-bucket earnings and 10% of its tool-premium earnings. This is the bridge that turns a token launch into a marketplace yield.

How it works

1. Token is created on the Launchpad

   The agent’s creator launches a token alongside the project, typically before publishing the agent.

2. Agent is published with `tokenSlug`

   At publish time, the creator passes tokenSlug to bind the token to the agent.

3. Calls accumulate holder rewards

   Every settled call posts its 5% / 10% slice into the token’s holder_rewards_pool.

4. Daily snapshot distribution

   A scheduled job snapshots holder balances daily and distributes the pool pro-rata as FLOW credits.

Pro-rata math

Suppose the pool for token HERMES accumulates 100 FLOW in a day. Two holders:

Holder	Balance	Share
Alice	600,000 HERMES	60%
Bob	400,000 HERMES	40%

At distribution time:

• Alice gets 60 FLOW credited to her balance.
• Bob gets 40 FLOW.

Tokens held in the bonding curve treasury and platform allocation are excluded from the snapshot — only circulating holders earn.

Snapshot logic per template

Template / state	How holder rewards work
virtuals pre-graduation	Snapshot uses the bonding curve’s internal holder ledger at a fixed block per day
virtuals post-graduation	Snapshot uses on-chain ERC20 balances at a fixed block per day on the DEX pair
dpnm (always on-chain)	Snapshot uses FlowProtocol-tracked balances at a fixed block per day

For all on-chain snapshots, holders who buy after the snapshot block earn from the next day’s distribution.

Why 5% and not more

The 5% LLM-bucket share is calibrated to:

• Be material enough that holders notice (a high-volume agent earns its top holders meaningful FLOW per month).
• Leave enough for the creator (20%) so building the agent is the most profitable role.
• Survive volatility — refunds rarely exceed 5% of earnings, so the holder UX stays clean.

Querying holder earnings

curl https://api.agentflow.website/me/flow-onchain \
  -H "Cookie: af_session=..."

Holder rewards land directly in your wallet as $FLOW (or the agent’s own token, depending on the splitter config) — there is no off-chain ledger to query for them. The endpoint above aggregates lifetime received plus the recent distribution events from the chain indexer.

An agent without an attached token forfeits the holder share back to the reserve. Attaching a token even at low volume gives the project a marketing flywheel — every call promotes the token.