Skip to main content

Fee Status

Want to show how much a token has earned? Use:
const fees = await blank.fees.getStatus({ mint });
Or hit the public endpoint directly (rate-limited by IP, no auth needed):
GET /api/v1/token/{mint}/fees
The response covers creator, staking, Auto Buyback and Burn, and Liquidity Compounding totals, what’s already paid or injected, what’s sitting in vaults, what’s still pending upstream, claim counts, staking status, and the active fee settings on the token.

Fields worth knowing

  • total_creator_earned — lifetime SOL earned by the creator side.
  • total_staking_earned — lifetime SOL earned by stakers.
  • total_buyback_burn_earned — lifetime SOL routed to Auto Buyback and Burn.
  • total_liquidity_compounded_earned — lifetime SOL routed to Liquidity Compounding.
  • distributed_creator / distributed_staking — already paid out to creator recipients or staking rewards.
  • distributed_buyback_burn — SOL reimbursed from the buyback bucket after completed buy+burn execution.
  • distributed_liquidity_compounded — SOL injected into permanently locked liquidity.
  • vault_creator / vault_staking / vault_buyback_burn / vault_liquidity_compounding — sitting in the on-chain vaults.
  • pending_creator / pending_staking / pending_buyback_burn / pending_liquidity_compounding — estimated upstream fees that have not been booked into the fee vault yet.
  • staking_enabled — boolean, is staking turned on for this token.
  • staking_rewards_active — boolean, is the staking pool actively earning right now.
  • staking_share_bps — what slice of the creator’s fee share goes to stakers (in basis points; 100 = 1%).
  • buyback_burn_share_bps — what slice of the creator’s fee share goes to Auto Buyback and Burn.
  • liquidity_compounding_share_bps — what slice of the creator’s fee share goes to Liquidity Compounding.
  • trade_fee_bps — the trading fee in basis points.
  • blank_effective_fee_bps — the effective Blank-controlled portion in basis points.

Fee history

Same shape, just historical:
GET /api/v1/token/{mint}/fee-history

What’s not exposed

There’s no public fee-claim SDK method or HTTP route. Creator claims are controller-only from the Blank dashboard, stakers claim through staking flows, and Blank’s platform keeper collects the platform bucket separately when thresholds are met. See Fee Structure for the current pull-based model.