# Token profile

> Full profile of any ERC-20 on the chain: name, symbol, decimals, supply (total, burned, locked, circulating), creation and launchpad lifecycle, metadata and…

Source: https://docs.crius.sh/reference/tokens/token-profile/ · Updated 2026-10-28

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

Full profile of any ERC-20 on the chain: name, symbol, decimals, supply (total, burned, locked, circulating), creation and launchpad lifecycle, metadata and socials (with their source), price with change per window and all-time high, market (market cap, FDV, liquidity), holder summary (count, top-10 share, dev holding), liquidity lock status, contract verification and rolling trade stats.

Heavier sections link to their own endpoints (`security.see`, `bundles.see`) so the profile stays fast.

> Identity, supply, metadata & socials, creation, verification, launch, price + change + ATH, market (FDV, market cap, liquidity), stats per window, holders summary, liquidity summary, dexscreener (dex paid, community takeover, boosts; confirmed against DexScreener orders).

## Path parameters

`chain`stringrequired

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

`address`stringrequired

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

## Key response fields

-   `price.usd`, `price.change_pct` (per window), `price.ath_usd`, `price.confidence`
-   `market.market_cap_usd`, `market.fdv_usd`, `market.liquidity_usd`, `market.quote_liquidity_usd`, `market.pools_count`
-   `holders.count`, `holders.top10_pct`, `holders.dev_pct`, `holders.burned_pct`, `holders.locked_pct`
-   `launch`: launchpad id and name, creator, curve, `status` (`bonding` / `graduated`), `progress_pct`, launch and graduation blocks
-   `liquidity`: lock status, lockers, next unlock time
-   `stats`: trades, buys, sells, traders, volume per window plus `all_time`
-   `metadata`: `logo`, `banner`, `description` and `links` (website, twitter, telegram, discord, farcaster, github), the same shape on every endpoint, with their `sources` (see [Conventions](https://docs.crius.sh/conventions/#token-logo-and-links))

## Guides that use this endpoint

[**How to get Robinhood Chain token data (token profile API)**Get a Robinhood Chain token's name, supply, price, market cap, holders, launchpad, liquidity lock and links in one API call. Real response, no API key needed.](https://docs.crius.sh/guides/get-token-data/)[**Build a Telegram token scanner bot for Robinhood Chain**Build a Telegram bot that scans Robinhood Chain tokens: price, liquidity, holders, taxes and a security score from two Crius API calls, with real examples.](https://docs.crius.sh/guides/build-a-telegram-token-scanner/)[**How to detect a honeypot token on Robinhood Chain**Check whether a Robinhood Chain token can be sold before you buy it. One API call simulates a buy and a sell and checks real trades; a real honeypot example shows the evidence.](https://docs.crius.sh/guides/detect-honeypot/)[**Get a token's all-time high and price change**Get a Robinhood Chain token's all-time high, when it was set, its market cap at the peak and its price change from 1 second to 24 hours, plus 7-day change.](https://docs.crius.sh/guides/get-all-time-high-and-price-change/)[**Search Robinhood Chain tokens, pools and wallets by name or address**Find a Robinhood Chain token's address by name or symbol, or look up any address or Uniswap v4 pool id, with one search call. Real responses included.](https://docs.crius.sh/guides/search-tokens/)[**Use the Crius API from AI agents (OpenAPI, llms.txt, MCP)**Give an AI agent Robinhood Chain data: Crius docs as llms.txt and Markdown, tool definitions from the OpenAPI document, an MCP server, and accuracy tips.](https://docs.crius.sh/guides/use-crius-with-ai-agents/)[**Market cap, FDV and circulating supply of a Robinhood Chain token (token supply API)**Robinhood Chain token supply API: total, burned, locked and circulating supply plus market cap and FDV of any token in one call, and how each is computed.](https://docs.crius.sh/guides/market-cap-fdv-and-supply/)[**How to create a token on Robinhood Chain (launchpads compared)**The ways to create a token on Robinhood Chain: Pons, Flap.sh, Bankr, Long.xyz, Flywheel, King of the Markets or your own ERC-20, compared with real launch data.](https://docs.crius.sh/guides/create-a-token-on-robinhood-chain/)[**Check a token developer's history (past launches and rugs)**Check a Robinhood Chain token creator's track record in one call: every token they launched, peak and current market cap, graduations, rugs, dev selling.](https://docs.crius.sh/guides/check-developer-history/)[**Robinhood Chain API for AI agents**Give an AI agent Robinhood Chain data with the Crius API: which endpoints to expose as tools, the OpenAPI document, structured errors and citing the block.](https://docs.crius.sh/use-cases/ai-agents/)[**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/)

## 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 tokens & prices endpoints

[GET/token/{address}/priceToken priceAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/token-price/)[GET/pricesBatch pricesAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-prices/)[POST/pricesBatch prices (POST)Anonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-prices-post/)[POST/tokens/batchBatch token profilesAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/batch-token-profiles/)[GET/token/{address}/poolsToken marketsAnonymous · 1 cr](https://docs.crius.sh/reference/tokens/token-markets/)

Request No key needed

  

**cURL**

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

**JavaScript**

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

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "address": "0x7b8892cea949bc60d494681d1bc3ea96071ab0b8",
    "admin_flags": null,
    "bundles": {
      "see": "/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/bundles"
    },
    "burned": 29840058.774195638068253872,
    "chain_id": 4663,
    "circulating_supply": 970159941.225804361931746128,
    "creation": {
      "attribution": "known_launchpad",
      "block": 88385886,
      "deployed_via": "pons_v2",
      "deployer": "0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca",
      "factory": "0x7ed598bcef8bd9edd8c97a195c6d13f40801ec7e",
      "launchpad_name": "Pons",
      "tx": "0x4d9536e81ce418070e93b72f46f1d91afdd6a9ed34141b8e3773926b0d863747"
    },
    "decimals": 18,
    "dexscreener": {
      "boosts": {
        "active_amount": null,
        "active_seen_ts": null,
        "count": 0,
        "last_ts": null,
        "total_amount": 0
      },
      "checked_ts": 1793040659244,
      "community_takeover": false,
      "community_takeover_ts": null,
      "confirmed": true,
      "dex_paid": true,
      "dex_paid_ts": 1791988981764,
      "orders": [
        {
          "payment_ts": 1791988981764,
          "status": "approved",
          "type": "tokenProfile"
        }
      ],
      "profile": {
        "description": null,
        "header": "https://cdn.dexscreener.com/cms/images/JcxosvISKHoUITBu?width=1500&height=500&quality=95&format=auto",
        "icon": "https://cdn.dexscreener.com/cms/images/DjTh8_NirbFrIzjW?width=800&height=800&quality=95&format=auto",
        "links": [
          {
            "label": "Website",
            "type": "website",
            "url": "https://chargeai.bid/"
          },
          {
            "type": "twitter",
            "url": "https://x.com/chargeairh"
          }
        ]
      },
      "url": "https://dexscreener.com/robinhood/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8"
    },
    "first_seen_block": 88385886,
    "history": "complete",
    "holders": {
      "burned_pct": 2.98401,
      "count": 179,
      "dev_holding": false,
      "dev_pct": 0,
      "locked_pct": 8.16327,
      "top10_pct": 13.436
    },
    "launch": {
      "creator": "0x3ac82d45ff9e4963cefbc3f74dbe293f34c927ca",
      "creator_label": null,
      "curve": "0x2b0943bf947b54df526047b6fec8183a4fdeb3c3",
      "curve_state": null,
      "graduated_block": 88461321,
      "graduation_threshold": 4.2,
      "launched_block": 88385886,
      "launchpad": "pons",
      "launchpad_name": "Pons",
      "pair_token": "0x0000000000000000000000000000000000000000",
      "progress_pct": 100,
      "raised": null,
      "status": "graduated"
    },
    "liquidity": {
      "locked_pct": 100,
      "lockers": [
        "pons_v2_launch_locker"
      ],
      "next_unlock_ts": null,
      "permanent": true,
      "status": "locked"
    },
    "locked": 81632653.061224486519511236,
    "market": {
      "fdv_usd": 3889.48,
      "liquidity_usd": 5611.8,
      "market_cap_usd": 3773.42,
      "pools_count": 10,
      "quote_liquidity_usd": 2805.9
    },
    "metadata": {
      "banner": "https://cdn.dexscreener.com/cms/images/JcxosvISKHoUITBu?width=1500&height=500&quality=95&format=auto",
      "description": "hf:charge-ai/charge-30b@9ff2ef1e98ea4d9745a70b33ea02b80dba26c582",
      "links": {
        "discord": null,
        "farcaster": null,
        "github": null,
        "telegram": null,
        "twitter": "https://x.com/chargeairh",
        "website": "https://chargeai.bid/"
      },
      "logo": "https://api.crius.sh/v1/robinhood/logo/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8.png?size=128",
      "logo_original": "https://api.surplusllm.com/api/launchpad/logos/bb4315cb9506ef872830b1dab25ffdb6694df1b8b8e32cc2c8d083208f26baab.png",
      "socials": {
        "discord": null,
        "farcaster": null,
        "github": null,
        "telegram": null,
        "twitter": {
          "source": "pons_launch",
          "url": "https://x.com/chargeairh"
        },
        "website": {
          "source": "pons_launch",
          "url": "https://chargeai.bid/"
        }
      },
      "source": "pons_launch",
      "sources": {
        "links": "pons_launch",
        "logo": "pons_launch"
      }
    },
    "name": "Charge AI",
    "price": {
      "ath_market_cap_usd": 68675.8,
      "ath_scope": "all_time",
      "ath_ts": 1792055400000,
      "ath_usd": 0.0000707881,
      "change_pct": {
        "1h": 0.896103,
        "1m": 0.896103,
        "1s": 0.896103,
        "24h": -0.171971,
        "30s": 0.896103,
        "4h": 0.896103,
        "5m": 0.896103,
        "6h": 0.896103
      },
      "confidence": "medium",
      "dex": "uniswap_v4",
      "eth": 0.00000000165124,
      "liquidity_usd": 5604.57,
      "quote": "0x0000000000000000000000000000000000000000",
      "quote_liquidity_usd": 2802.29,
      "source_pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
      "thin_liquidity": false,
      "usd": 0.00000388948
    },
    "security": {
      "see": "/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/security"
    },
    "standard": "erc20",
    "stats": {
      "all_time": {
        "buy_volume_usd": 143046,
        "buys": 2893,
        "first_trade_ts": 1791982835000,
        "sell_volume_usd": 137621,
        "sells": 2250,
        "since": "chain_start",
        "trades": 5143,
        "volume_usd": 280667
      },
      "avg_trade_usd": {
        "1h": null,
        "1m": null,
        "1s": null,
        "24h": 2.96366,
        "30s": null,
        "4h": null,
        "5m": null,
        "6h": null
      },
      "buy_volume_usd": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 0,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "buyers": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 0,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "buys": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 0,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "last_trade_ts": 1793196204000,
      "sell_volume_usd": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 5.92732,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "sellers": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 2,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "sells": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 2,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "traders": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 2,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "trades": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 2,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "txns": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 2,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "volume_eth": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 0.00252958,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      },
      "volume_usd": {
        "1h": 0,
        "1m": 0,
        "1s": 0,
        "24h": 5.92732,
        "30s": 0,
        "4h": 0,
        "5m": 0,
        "6h": 0
      }
    },
    "symbol": "CHARGE",
    "total_supply": 1000000000,
    "type": "launchpad",
    "ui_multiplier": null,
    "verification": {
      "compiler": null,
      "contract_name": null,
      "implementation": null,
      "is_proxy": null,
      "sourcify": null
    }
  },
  "meta": {
    "block": 100406769,
    "block_age_ms": 400,
    "block_ts": 1793225075000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 38,
    "pending": [],
    "safe_block": 100401329
  }
}
```

[Report an issue](mailto:support@crius.sh?subject=Docs%20issue%3A%20GET%20%2Fv1%2F%7Bchain%7D%2Ftoken%2F%7Baddress%7D&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Ftokens%2Ftoken-profile%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)