> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filter.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /tokens

> Live leaderboard with HP, components, and per-token detail + creator-earnings

## /tokens — machine-readable

| Field     | Value                                                          |
| --------- | -------------------------------------------------------------- |
| method    | GET                                                            |
| host      | api.filter.fun                                                 |
| paths     | /tokens · /tokens/:address · /tokens/:address/creator-earnings |
| auth      | none                                                           |
| sort      | rank ascending                                                 |
| hp\_scale | 0–10000 integer                                                |

### Component field map (canonical)

| Field               | UI label            | Weight | Score range |
| ------------------- | ------------------- | -----: | ----------- |
| velocity            | Buy pressure        |   0.30 | 0–1         |
| effectiveBuyers     | Real buyers         |   0.15 | 0–1         |
| stickyLiquidity     | Sticky liquidity    |   0.30 | 0–1         |
| retention           | Holder retention    |   0.15 | 0–1         |
| holderConcentration | Holder distribution |   0.10 | 0–1         |
| momentum            | Momentum            |   0.00 | gated off   |

### `score` vs `cohortPercentile`

|                 | score                                                                     | cohortPercentile                     |
| --------------- | ------------------------------------------------------------------------- | ------------------------------------ |
| Range           | 0–1                                                                       | 0–100                                |
| Used in HP calc | yes                                                                       | no                                   |
| Used in UI bars | no                                                                        | yes                                  |
| Normalization   | fixed-reference (velocity/effectiveBuyers/stickyLiquidity) or already 0–1 | percentile rank within active cohort |

### Token status enum

`safe` · `at-risk` · `finalist` · `filtered` · `winner` · `inactive`

### dataAvailability

When `complete: false`, the `missing` array names which component inputs are
unavailable for this snapshot. Display logic should grey out missing
components rather than show 0.