# Launch lifecycle

> A launchpad token's lifecycle: creator, curve, bonding progress, raised amount, graduation block and the pool it graduated into.

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

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

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.

## Path parameters

`chain`stringrequired

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

`address`stringrequired

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

## Guides that use this endpoint

[**Get new Robinhood Chain tokens and graduations in real time**Get new Robinhood Chain launchpad tokens, graduations and pools the moment they happen, with the Crius WebSocket and a Node.js client that checks each token.](https://docs.crius.sh/guides/stream-new-tokens/)[**Track Robinhood Chain bonding-curve tokens about to graduate**Track Pons, Flap and other Robinhood Chain launchpad tokens on their bonding curves, see which are closest to graduating and catch each graduation.](https://docs.crius.sh/guides/track-bonding-and-graduating-tokens/)[**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/)[**Robinhood Chain API for Telegram and Discord bots**Build a Robinhood Chain token scanner, buy bot or launch-alert channel for Telegram or Discord with the Crius API, with real replies and credit costs.](https://docs.crius.sh/use-cases/telegram-and-discord-bots/)[**Robinhood Chain API for trading bots**What a Robinhood Chain trading bot needs from the Crius API: new launches, live prices, pools and safety checks before every buy, with credit costs.](https://docs.crius.sh/use-cases/trading-bots/)

## 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}/feesFees & claimsStarter · 5 cr](https://docs.crius.sh/reference/launchpads/fees-claims/)

Request Needs a Free key

 

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

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "creator": "0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca",
    "curve": "0x2b0943bf947b54df526047b6fec8183a4fdeb3c3",
    "curve_stats": {
      "buys": 482,
      "first_indexed_block": 88385895,
      "history": "complete",
      "sells": 280,
      "unique_traders": 61,
      "volume_quote": 21.053399701262936019
    },
    "factory": "0x7ed598bcef8bd9edd8c97a195c6d13f40801ec7e",
    "fees": {
      "buyback_burn_bps": 5000,
      "buyback_enabled": false,
      "buyback_vault": "0x42df2a798f82289e177311362e8f5ccc45c1219c",
      "creator_fee_recipient": "0x14a6f00bad1f4e21e2af4e317383c3d550378996",
      "creator_tax_bps": 200,
      "escrow": "0xd3afeb2a57f70ef218aa82451c51b2fb0416ac9e",
      "hook_fee_bps": 100,
      "pending": {
        "buyback": 0,
        "creator_tax": 0.0010373586867571,
        "currency": "ETH",
        "fees": 0.000518679343378549
      },
      "protocol_fee_recipient": "0x31ea5b453a6cd60f36203830de046ff32dec2cdb",
      "protocol_fee_share_bps": 3000,
      "snipe_tax": {
        "start_bps": 9900,
        "window_s": 3
      }
    },
    "graduation": {
      "block": 88461321,
      "blocks_to_graduate": 75435,
      "graduated_block_recorded": 88461321,
      "lp_locker": "0x267444d099b10fb5ed7c3cc7b7c767adca574952",
      "lp_position_id": 3790055,
      "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "quote_to_pool": 4.200000000000000236,
      "tokens_to_pool": 204081632.653061227766208523,
      "ts": 1791990423100
    },
    "launch_tx": "0x4d9536e81ce418070e93b72f46f1d91afdd6a9ed34141b8e3773926b0d863747",
    "launched_block": 88385886,
    "launched_ts": 1791982833600,
    "launched_via": "factory",
    "launchpad": "pons",
    "launchpad_name": "Pons",
    "pair_token": {
      "address": "0x0000000000000000000000000000000000000000",
      "logo": null,
      "symbol": "ETH"
    },
    "progress": {
      "pct": 100,
      "raised": 4.200000000000000236,
      "threshold": 4.2
    },
    "status": "graduated",
    "version": "v2"
  },
  "meta": {
    "block": 100406852,
    "block_age_ms": 778,
    "block_ts": 1793225083000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 86,
    "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%2Flaunch&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Flaunchpads%2Flaunch-lifecycle%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)