---
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`

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.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/revisions/4a14b82cd39d/schema)