Skip to main content

Documentation Index

Fetch the complete documentation index at: https://blank.build/docs/llms.txt

Use this file to discover all available pages before exploring further.

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 and staking totals, what’s been distributed, what’s sitting in vaults, what’s pending, distribution 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.
  • distributed_creator / distributed_staking — already paid out.
  • vault_creator / vault_staking — sitting in the on-chain vaults.
  • pending_creator / pending_staking — claimed from Meteora but not yet distributed.
  • 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%).
  • 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. Claims and distributions run automatically through Blank every four hours (see Fee Structure for the full schedule), so integrators don’t have to trigger anything.