Get Token Lifetime Fees

In this guide, you’ll learn how to retrieve the total lifetime fees earned by a Solana token using the Bags TypeScript SDK with Node.js. This is useful for tracking token performance and earnings over time.

For SOL fee-share v2, this total measures normal claimer earnings after platform, partner, and deployer deductions. It excludes the separate deployer payout. The dedicated deployer balance endpoint reports currently unclaimed pending and accrued deployer revenue; it is not a lifetime metric. See Deployer Fees for the accounting details.

Prerequisites

Before starting, make sure you have:

Completed our TypeScript and Node.js Setup Guide.
Got your API key from the Bags Developer Portal.
The token mint address you want to analyze.

1. The Token Lifetime Fees Script

Here is a simple script to fetch token lifetime fees. Save this as get-token-lifetime-fees.ts. This script uses the updated SDK API to retrieve lifetime fees for any token and displays them in a user-friendly format.

Endpoint Used Under the Hood

This guide uses:

GET /token-launch/lifetime-fees via sdk.state.getTokenLifetimeFees()

import dotenv from "dotenv";
dotenv.config({ quiet: true });

import { BagsSDK } from "@bagsfm/bags-sdk";
import { LAMPORTS_PER_SOL, PublicKey, Connection } from "@solana/web3.js";

// Initialize SDK
const BAGS_API_KEY = process.env.BAGS_API_KEY;
const SOLANA_RPC_URL = process.env.SOLANA_RPC_URL;

if (!BAGS_API_KEY || !SOLANA_RPC_URL) {
    throw new Error("BAGS_API_KEY and SOLANA_RPC_URL are required");
}

const connection = new Connection(SOLANA_RPC_URL);
const sdk = new BagsSDK(BAGS_API_KEY, connection, "processed");

async function getTokenLifetimeFees(tokenMint: string) {
    const feesLamports = await sdk.state.getTokenLifetimeFees(new PublicKey(tokenMint));

    console.log("💰 Token lifetime fees:", (feesLamports / LAMPORTS_PER_SOL).toLocaleString(), "SOL");
}

getTokenLifetimeFees("CyXBDcVQuHyEDbG661Jf3iHqxyd9wNHhE2SiQdNrBAGS");

2. Run Your Script

To analyze a token’s lifetime fees, edit the getTokenLifetimeFees function call at the bottom of the script with the actual mint address you want to analyze. Then, run the script from your terminal:

npx ts-node get-token-lifetime-fees.ts

What You’ll See

The script will output the total lifetime fees earned by the token in SOL, formatted with proper number localization for easy reading. Example output:

💰 Token lifetime fees: 1,234.567890 SOL

Alternative: Using the Bags CLI

This section requires the Bags CLI. See Install and Set Up the Bags CLI to get started.

Get lifetime fees for a token directly from the terminal:

bags fees lifetime TOKEN_MINT_ADDRESS

To display the result in raw lamports instead of SOL:

bags fees lifetime TOKEN_MINT_ADDRESS --raw

Use Cases

This information is valuable for:

Token Performance Analysis: Track how much revenue a token has generated
Investment Research: Evaluate token success based on fee generation
Portfolio Management: Monitor earnings from tokens you’ve created or invested in
Market Analysis: Compare performance across different tokens

For more advanced token analytics, check out our Get Token Creators guide.

Getting started

CLI

How-to Guides

Core Principles

Robinhood Chain

Robinhood Chain Guides

Robinhood Chain Reference

Prerequisites

1. The Token Lifetime Fees Script

Endpoint Used Under the Hood

2. Run Your Script

What You’ll See

Alternative: Using the Bags CLI

Use Cases

​Prerequisites

​1. The Token Lifetime Fees Script

​Endpoint Used Under the Hood

​2. Run Your Script

​What You’ll See

​Alternative: Using the Bags CLI

​Use Cases

Prerequisites

1. The Token Lifetime Fees Script

Endpoint Used Under the Hood

2. Run Your Script

What You’ll See

Alternative: Using the Bags CLI

Use Cases