---
title: "Get token claim events"
method: GET
path: "/fee-share/token/claim-events"
tags: ["Analytics"]
---

# Get token claim events

`GET /fee-share/token/claim-events`

## Request

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

Retrieve claim events for a specific token. Supports two query modes:

**Offset Mode** (default): Use `mode=offset` (or omit mode) with `limit` and `offset` for traditional pagination.

**Time Mode**: Use `mode=time` with `from` and `to` unix timestamps to retrieve events within a specific time range.

## Query parameters

- `tokenMint` string, required
- `mode` 'offset' | 'time'
- `limit` integer
- `offset` integer
- `from` integer
- `to` integer

## Response `200`

Successfully retrieved token claim events

- object
  - `success` boolean, required
  - `response` object
    - `events` TokenClaimEvent[], required: Array of claim events
      - `wallet` string, required: Public key of the wallet that claimed fees
      - `isCreator` boolean, required: Whether this wallet is the token creator
      - `amount` string, required: Amount claimed in lamports (as string to support bigint)
      - `signature` string, required: Transaction signature of the claim
      - `timestamp` string, required: ISO 8601 timestamp of the claim event

## Other responses

- `400`: Bad request - Invalid token mint or parameters
- `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)