# Launchpads & fees

> Launchpad lifecycle (bonding curve progress, graduation), live launchpad stats, and fees, claims and receivers for Robinhood Chain tokens.

Source: https://crius.sh/docs/reference/launchpads/

Robinhood Chain launchpads such as **Pons**, **Flap.sh**, **Bankr**, **Long.xyz** and **King of the Markets** are attributed automatically. Every response that mentions a launchpad carries a stable id (`launchpad`, use it in filters) and a display name (`launchpad_name`).

| Endpoint | Method | Plan | Credits |
|---|---|---|---|
| [Launchpads](#launchpads) | `GET /v1/{chain}/launchpads` | Anonymous | 1 |
| [Launch lifecycle](#launch-lifecycle) | `GET /v1/{chain}/token/{address}/launch` | Free | 2 |
| [Fees & claims](#fees-claims) | `GET /v1/{chain}/token/{address}/fees` | Starter | 5 |

## Launchpads

**GET** `/v1/{chain}/launchpads`

**Plan:** Anonymous and above (no key needed) · **Cost:** 1 credit per call

Every supported launchpad with its live stats: launches, graduations and volume.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/launchpads" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/launchpads", {
  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/launchpads",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

[Try it in the playground →](https://crius.sh/docs/playground/?op=GET%20%2Fv1%2F%7Bchain%7D%2Flaunchpads)

### Example response

Real response captured from the API (arrays trimmed to three items).

```json
{
  "data": [
    {
      "contracts": {
        "buyback_vault": "0x42df2a798f82289e177311362e8f5ccc45c1219c",
        "factory": "0x7ed598bcef8bd9edd8c97a195c6d13f40801ec7e",
        "fee_escrow": "0xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e",
        "hook": "0xe5e702641ea86f4ae6cc3cdaed2b886f976be044",
        "launch_and_buy": "0xe33e9e479df8802cb0866d5d05258bec4cf62948",
        "lp_locker": "0x267444d099b10fb5ed7c3cc7b7c767adca574952"
      },
      "id": "pons",
      "name": "Pons",
      "since_block": 27027321,
      "stats": {
        "graduated": 10411,
        "graduated_24h": 23,
        "graduation_rate_pct": 1.47015,
        "launches_24h": 1591,
        "median_blocks_to_graduate": 2469,
        "tokens_launched": 708157,
        "volume_usd_24h": 22460562
      },
      "type": "bonding_curve_to_v4",
      "website": null
    },
    {
      "contracts": {
        "launch_contracts": [
          "0x26605f322f7ff986f381bb9a6e3f5dab0beaeb09"
        ]
      },
      "id": "flap",
      "name": "Flap.sh",
      "since_block": 4227932,
      "stats": {
        "graduated": 337,
        "graduated_24h": 0,
        "graduation_rate_pct": 0.0885423,
        "launches_24h": 1374,
        "median_blocks_to_graduate": 8048,
        "tokens_launched": 380609,
        "volume_usd_24h": 378086
      },
      "type": "config_driven",
      "website": "https://flap.sh"
    },
    {
      "contracts": {
        "launch_contracts": [
          "0xeb7c034704ef8dcd2d32324c1545f62fb4ad0862"
        ]
      },
      "id": "bankr",
      "name": "Bankr",
      "since_block": 1565844,
      "stats": {
        "graduated": 0,
        "graduated_24h": 0,
        "graduation_rate_pct": 0,
        "launches_24h": 54,
        "median_blocks_to_graduate": null,
        "tokens_launched": 98503,
        "volume_usd_24h": 296276
      },
      "type": "config_driven",
      "website": "https://bankr.bot"
    }
  ],
  "meta": {
    "block": 95504452,
    "block_age_ms": 603,
    "block_ts": 1792713001000,
    "chain": "robinhood",
    "finalized_block": 95493649,
    "lag_ms": 160,
    "safe_block": 95497061
  }
}
```

## Launch lifecycle

**GET** `/v1/{chain}/token/{address}/launch`

**Plan:** Free and above · **Cost:** 2 credits per call

A launchpad token's lifecycle: creator, curve, bonding progress, raised amount, graduation block and the pool it graduated into. Tokens from unattributed factories return `data: null` with `meta.attribution = "unattributed_factory"`.

> Pons config & fees read live from the chain, graduation details.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |

### Request

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/launch" \
  -H "x-api-key: $CRIUS_API_KEY"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/launch", {
  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/launch",
    headers={"x-api-key": os.environ["CRIUS_API_KEY"]},
)
body = r.json()
print(body["data"])
```

## Fees & claims

**GET** `/v1/{chain}/token/{address}/fees`

**Plan:** Starter and above · **Cost:** 5 credits per call

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.

### Parameters

| Name | In | Type | Default | Description |
|---|---|---|---|---|
| `chain` | path, required | string |  | Chain slug (`robinhood`) or chain id (`4663`). |
| `address` | path, required | string |  | Contract or wallet address, any case (`0x…`, 20 bytes). |
| `window` | query | string | `24h` | Stats window. One of `1h`, `24h`, `7d`, `all`. |

### Request

**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"])
```