Get Token Creators

In this guide, you’ll learn how to retrieve token launch creators/deployers using the Bags TypeScript SDK with Node.js. This includes provider, display name, wallet address, royalty percentage, and profile image.

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 Creators Script

Here is a comprehensive script to fetch token creator information. Save this as get-token-creators.ts. This script retrieves detailed information about the primary creator and any additional launch participants, including provider, display name, wallet, profile picture, and royalty percentage.

Endpoint Used Under the Hood

This guide uses:

GET /token-launch/creator/v3 via sdk.state.getTokenCreators()

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

import { BagsSDK } from "@bagsfm/bags-sdk";
import { 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 getTokenCreators(tokenMint: string) {
    try {
        console.log(`🔍 Fetching token creators for: ${tokenMint}`);
        
        const creators = await sdk.state.getTokenCreators(new PublicKey(tokenMint));
        
        console.log(`📊 Found ${creators.length} creator(s)/deployer(s)`);

        const primaryCreator = creators.find(c => c.isCreator);

        if (!primaryCreator) {
            throw new Error("❌ No primary creator found for this token!");
        }

        console.log("✨ Primary Creator Details:");
        console.log(`👤 Display Name: ${primaryCreator.providerUsername ?? primaryCreator.username ?? "N/A"}`);
        console.log(`🔗 Provider: ${primaryCreator.provider ?? "unknown"}`);
        console.log(`👛 Wallet: ${primaryCreator.wallet}`);
        console.log(`🎨 Profile Picture: ${primaryCreator.pfp}`);
        console.log(`💰 Royalty: ${primaryCreator.royaltyBps / 100}%`);

        const others = creators.filter(c => !c.isCreator);
        if (others.length > 0) {
            console.log("\n🤝 Other Launch Participants:");
            others.forEach((participant, idx) => {
                console.log(`\n#${idx + 1}`);
                console.log(`👤 Display Name: ${participant.providerUsername ?? participant.username ?? "N/A"}`);
                console.log(`🔗 Provider: ${participant.provider ?? "unknown"}`);
                console.log(`👛 Wallet: ${participant.wallet}`);
                console.log(`🎨 Profile Picture: ${participant.pfp}`);
                console.log(`💰 Royalty: ${participant.royaltyBps / 100}%`);
            });
        } else {
            console.log("\n📝 No additional launch participants found for this token");
        }

        console.log("\n✅ Successfully retrieved token creators!");
    }
    catch (error) {
        console.error("🚨 Error fetching token creators:", error);
    }
}

getTokenCreators("CyXBDcVQuHyEDbG661Jf3iHqxyd9wNHhE2SiQdNrBAGS");

2. Run Your Script

To analyze a token’s creators, edit the getTokenCreators 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-creators.ts

What You’ll See

The script will output detailed information about the token’s launch creators/deployers: Example output:

🔍 Fetching token creators for: CyXBDcVQuHyEDbG661Jf3iHqxyd9wNHhE2SiQdNrBAGS
📊 Found 2 creator(s)/deployer(s)
✨ Primary Creator Details:
👤 Display Name: tokenCreatorOnTwitter
🔗 Provider: twitter
👛 Wallet: 8xX...abc
🎨 Profile Picture: https://example.com/pfp.jpg
💰 Royalty: 5%

🤝 Other Launch Participants:
#1
👤 Display Name: feeShareUser
🔗 Provider: github
👛 Wallet: 3yz...def
🎨 Profile Picture: https://example.com/pfp2.jpg
💰 Royalty: 2%

✅ Successfully retrieved token creators!

Understanding the Data

isCreator: Identifies the primary token creator. There can be multiple creators/deployers, but at most one will have isCreator: true.
provider: The social/login provider associated with the creator (e.g., twitter, tiktok, kick, github). Use this to show a platform logo. May be unknown or null.
providerUsername: The username on the provider platform, when available. Prefer this for display. The plain username is a Bags internal username and may be absent.
wallet: The creator’s wallet address.
pfp: URL to the profile image, when available.
royaltyBps: Royalty in basis points. Divide by 100 to display as a percentage.
twitterUsername (optional): The creator’s Twitter/X username, if available.
bagsUsername (optional): The creator’s Bags platform username, if available.
isAdmin (optional): Whether this user is an admin of the token.

Key Information Retrieved:

Display Name: providerUsername if present, otherwise username
Provider: Source platform for displaying logos and context
Wallet: Wallet address string
Profile Picture: URL string
Royalty: Percentage derived from royaltyBps / 100

Alternative: Using the Bags CLI

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

Get token creators directly from the terminal:

bags launch creators --mint TOKEN_MINT_ADDRESS

Use --json for machine-readable output:

bags launch creators --mint TOKEN_MINT_ADDRESS --json

Use Cases

This information is valuable for:

Due Diligence: Research token creators before investing
Creator Discovery: Find and follow successful token creators
Fee Analysis: Understand how token fees are distributed
Partnership Opportunities: Identify potential collaborators
Portfolio Research: Learn about the teams behind your investments

For token performance metrics, also check out our Get Token Lifetime Fees guide.

Getting started

CLI

How-to Guides

Core Principles

Robinhood Chain

Robinhood Chain Guides

Robinhood Chain Reference

Prerequisites

1. The Token Creators Script

Endpoint Used Under the Hood

2. Run Your Script

What You’ll See

Understanding the Data

Key Information Retrieved:

Alternative: Using the Bags CLI

Use Cases

​Prerequisites

​1. The Token Creators Script

​Endpoint Used Under the Hood

​2. Run Your Script

​What You’ll See

​Understanding the Data

​Key Information Retrieved:

​Alternative: Using the Bags CLI

​Use Cases

Prerequisites

1. The Token Creators Script

Endpoint Used Under the Hood

2. Run Your Script

What You’ll See

Understanding the Data

Key Information Retrieved:

Alternative: Using the Bags CLI

Use Cases