# On-Chain Claims

{% hint style="info" %}
This feature is only available to **Pro** users.
{% endhint %}

## Overview

Tokenomist’s **On-Chain Claims** provides a precise view of how token supply actually enters circulation after unlocks.

In many cases, when tokens unlock, they don’t automatically circulate. Many remain in vesting or internal wallets until claimed by beneficiaries. By tracking on-chain activity for known vesting wallets, we surface the *real* amount of tokens entering circulation. This data is continuously updated on a daily basis.

Our goal is to bring greater transparency to token supply and vesting by showing not just what is unlocked, but what has truly been claimed and moved into the market.

<figure><img src="/files/CdplUOQUa61YoewEjyze" alt=""><figcaption></figcaption></figure>

## Accessing On-Chain Claims

You can access **On-Chain Claims** from the sidebar. This opens a table of supported tokens along with their most recent claim data.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FbSxtjEmzyCyoByVegnqt%2Faccessing-onchain-claims.mp4?alt=media&token=e3e058ee-5de0-46a3-8719-22db134cc439>" %}

You can also reach a token’s Claims page directly by visiting its [Token Page](/tokenomist/token-page.md) and selecting the **Claimed** tab.

## Using On-Chain Claims

At the top of the page you'll see

1. **Total Unlocked Supply**: the number of tokens that have unlocked, based on our vesting data.
2. **Total Claimed**: the cumulative amount of tokens that have been claimed, i.e., transferred out of **known** vesting/internal wallets into beneficiary wallets.

Below this, you’ll find a **sankey diagram** of the top 10 claimers — the beneficiaries who have received the largest amounts of tokens from vesting wallets.

* You can filter this by timeframe to understand claim activity in context.
* Clicking on a claimer reveals their address, the total amount and value of tokens claimed, and a full transaction history (including token prices at the time of claim).

{% hint style="danger" %}
It is possible for the tracked total claim amount to exceed total unlocked amount due to unlabeled or unidentified internal / operational transfers by the token project.
{% endhint %}

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2FdLTRlCCE0kwGzi9ymGgi%2Fonchain-claims.mp4?alt=media&token=346e4bfa-b66d-4dbe-a33f-4b458dc8c85a>" %}

### On-Chain Claims in Release Schedules

On-Chain Claims can also be layered onto a token’s **Release Schedule**.

1. On the token’s overview page, click **Add Metric** above the Release Schedule.
2. Select **Claim**, then click **Save**.

This lets you compare *actual claimed supply* against the projected unlock schedule.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAiV8rQPRMYfCyYrQgX5Q%2Fuploads%2Fb7XLex4ePgplPedCoLxl%2Fonchain-claims-overlay.mp4?alt=media&token=da5b7154-a00c-4503-8835-6ccbec9c01df>" %}

## Claim FAQs

### How are internal wallets identified?

We identify vesting and internal wallets using:

* **Project disclosures**: team allocations, foundation wallets, or addresses published in docs/announcements.
* **On-chain heuristics**: transaction patterns, clustering, funding sources.
* **Direct verification**: where possible, we confirm with project teams directly.

Once identified, we monitor these wallets. Outflows from them into external wallets are classified as **claims**.

### How often is claim data updated?

Claim data is refreshed **daily**. We continuously track on-chain transfers, tag them against our database of vesting wallets, and update cumulative claim totals.

### What’s the difference between released, claimed, and circulating supply?

See our [Supply Metrics](/methodology/supply-metrics.md) page, but in short:

* **Released supply**: Tokens that have passed their release schedule.
* **Claimed supply**: Released tokens actually withdrawn from vesting wallets.
* **Circulating supply**: A broader market metric, which includes claimed tokens plus other liquid tokens available for trading.

## Supported Tokens

As of **15 September 2025**, On-Chain Claims supports the following tokens:

1. [1inch](https://tokenomist.ai/1inch/claim)
2. [ApeCoin](https://tokenomist.ai/apecoin/claim)
3. [Arbitrum](https://tokenomist.ai/arbitrum/claim)
4. [Axie Infinity](https://tokenomist.ai/axie-infinity/claim)
5. [BitDAO](https://tokenomist.ai/bitdao/claim)
6. [Blur](https://tokenomist.ai/blur/claim)
7. [Ethena](https://tokenomist.ai/ethena/claim)
8. [Ethereum Name Service](https://tokenomist.ai/ethereum-name-service/claim)
9. [SpaceID](https://tokenomist.ai/space-id/claim)
10. [Illuvium](https://tokenomist.ai/illuvium/claim)
11. [ImmutableX](https://tokenomist.ai/immutable-x/claim)
12. [Chainlink](https://tokenomist.ai/chainlink/claim)
13. [Liquity](https://tokenomist.ai/liquity/claim)
14. [Polygon](https://tokenomist.ai/matic-network/claim)
15. [Optimism](https://tokenomist.ai/optimism/claim)
16. [Pendle](https://tokenomist.ai/pendle/claim)
17. [The Sandbox](https://tokenomist.ai/the-sandbox/claim)
18. [XAI](https://tokenomist.ai/xai-blockchain/claim)

## Where To Next?

* See how you can use Claims in conjunction with other metrics on the [Token Page](/features/token-page.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.unlocks.app/features/on-chain-claims.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
