# Fees & claims

> Fees paid around a token over a window: gas (L2 and L1), LP fees, Uniswap protocol fees, hook fees and taxes, launchpad and creator fees and token tax, plus…

Source: https://docs.crius.sh/reference/launchpads/fees-claims/ · Updated 2026-10-28

GET https://api.crius.sh/v1/{chain}/token/{address}/fees

Fees paid around a token over a window: gas (L2 and L1), LP fees, Uniswap protocol fees, hook fees and taxes, launchpad and creator fees and token tax, plus who claimed them and where they went.

> Gas, LP fees, hook fees, creator tax, bonding-curve fees, token tax; Pons sweeps.

## Path parameters

`chain`stringrequired

Chain slug (`robinhood`) or chain id (`4663`).

`address`stringrequired

Contract or wallet address, any case (`0x…`, 20 bytes).

## Query parameters

`window`string Default `24h`

Stats window. One of `1h`, `24h`, `7d`, `all`.

## Guides that use this endpoint

[**Get a Robinhood Chain token's fees, taxes and creator rewards**See every fee paid around a Robinhood Chain token (gas, LP, hook, creator tax, curve, token tax), who receives it and what is still unclaimed. Real response.](https://docs.crius.sh/guides/get-token-fees-and-creator-rewards/)[**Robinhood Chain API for launchpad and DEX builders**How launchpad, DEX and v4 hook teams use the Crius API for launch lifecycles, launchpad stats, creator fees, hook records and pool data on Robinhood Chain.](https://docs.crius.sh/use-cases/launchpad-and-dex-builders/)

## Errors

Errors come back as `{ "error": { "code", "message" } }` with the matching HTTP status: `400` bad parameter, `401` missing or invalid key, `403` endpoint above your plan, `404` unknown token or address, `429` rate limit or credits used up (with `Retry-After`). See [Errors](https://docs.crius.sh/errors/).

## More launchpads & fees endpoints

[GET/launchpadsLaunchpadsAnonymous · 1 cr](https://docs.crius.sh/reference/launchpads/launchpads/)[GET/launchpads/{id}Launchpad detailAnonymous · 2 cr](https://docs.crius.sh/reference/launchpads/launchpad-detail/)[GET/token/{address}/launchLaunch lifecycleFree · 2 cr](https://docs.crius.sh/reference/launchpads/launch-lifecycle/)

Request Needs a Starter key

 

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/fees?window=7d" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/fees?window=7d", {
  headers: { "x-api-key": process.env.CRIUS_API_KEY },
});
const { data, meta } = await res.json();
```

**Python**

```python
import os, requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/fees?window=7d",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "by_pool": [
      {
        "dex": "uniswap_v4",
        "lp_usd": 0,
        "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
        "token_tax_usd": 0,
        "volume_usd": 5.92732
      }
    ],
    "claims": [],
    "launchpad": {
      "bonding_curve": {
        "fee_a": 0,
        "fee_a_usd": 0,
        "fee_b": 0,
        "fee_b_usd": 0
      },
      "creator_tax_usd": 0.119245,
      "hook_fee_usd": 0.0596227,
      "pending": {
        "buyback": "0",
        "creator_tax": "1037358686757100",
        "fees": "518679343378549"
      },
      "swept_usd": {
        "buyback": 0,
        "creator": 0,
        "protocol": 0
      }
    },
    "receivers": [
      {
        "address": "0x14a6f00bad1f4e21e2af4e317383c3d550378996",
        "creator_tax_bps": 200,
        "role": "creator_fee_recipient"
      },
      {
        "address": "0x31ea5b453a6cd60f36203830de046ff32dec2cdb",
        "role": "launchpad_protocol",
        "share_bps": 3000
      },
      {
        "address": "0xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e",
        "role": "launchpad_fee_escrow"
      }
    ],
    "totals_usd": {
      "bonding_curve": 0,
      "creator": 0.119245,
      "gas": 0.0365916,
      "hook": 0.0596227,
      "lp": 0,
      "token_tax": 0,
      "total": 0.21546,
      "uniswap_protocol": null
    },
    "window": "24h"
  },
  "meta": {
    "block": 100406855,
    "block_age_ms": 1148,
    "block_ts": 1793225083000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 7,
    "notes": [
      "USD at the current ETH price",
      "uniswap_protocol: protocol fee switch not indexed yet (null)"
    ],
    "safe_block": 100401329
  }
}
```

[Get a key for this endpoint](https://dashboard.crius.sh/signup?ref=docs-endpoint) [Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D%2Ffees&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Flaunchpads%2Ffees-claims%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)
