---
title: "Get token claim stats"
method: GET
path: "/token-launch/claim-stats"
tags: ["Analytics"]
---

# Get token claim stats

`GET /token-launch/claim-stats`

## Request

- Base URL: `https://public-api-v2.bags.fm/api/v1`
- URL: `https://public-api-v2.bags.fm/api/v1/token-launch/claim-stats`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bags/apis/bags-public-api-v2/docs/token-launch/claim-stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve claim statistics for all fee claimers of a specific token, including total claimed amounts per user.

## Query parameters

- `tokenMint` string, required

## Response `200`

Successfully retrieved token claim stats

- object
  - `success` boolean, required
  - `response` TokenLaunchCreatorV3WithClaimStats[]
    - `username` string, required: Bags username of the creator (internal; may be a shortened wallet if no Bags user is linked)
    - `pfp` string, required: Profile picture URL of the creator
    - `royaltyBps` number, required: Royalty in basis points
    - `isCreator` boolean, required: Whether this user is the token creator
    - `wallet` string, required: Public key of the wallet
    - `provider` union: Social/auth provider for the associated account
      - 'apple' | 'google' | 'email' | 'solana' | 'twitter' | 'tiktok' | 'kick' | 'instagram' | 'onlyfans' | 'github' | 'moltbook': Supported social/auth providers
      - 'unknown'
    - `providerUsername` string, nullable: Username/handle on the social provider
    - `twitterUsername` string: Twitter/X username of the creator, if available (optional)
    - `bagsUsername` string: Bags platform username of the creator, if available (optional)
    - `isAdmin` boolean: Whether this user is an admin of the token launch (optional)
    - `totalClaimed` string, required: Total fees claimed by this user (as string to support bigint)

## Other responses

- `400`: Bad request - Invalid token mint
- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal server error

---

[API](https://skmtc.dev/bags/apis/bags-public-api-v2.md) - [All operations](https://skmtc.dev/bags/apis/bags-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/bags/apis/bags-public-api-v2/revisions/4a14b82cd39d?raw)