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

# Get token claim stats

`GET /token-launch/claim-stats`

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.net/bags/apis/bags-public-api-v2.md) · [All operations](https://skmtc.net/bags/apis/bags-public-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bags/bags-public-api-v2/versions/4a14b82cd39d/schema)