# Hook detail

> One hook: decoded permissions, code (kind, owner, admin functions), what happened in its pools, its code family's history, flags with evidence and risk level,…

Source: https://docs.crius.sh/reference/pools/hook-detail/ · Updated 2026-10-28

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

One hook: decoded permissions, code (kind, owner, admin functions), what happened in its pools, its code family's history, flags with evidence and risk level, and the events it emits.

## 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

[**Check the risk of a Uniswap v4 hook**Find out what a Robinhood Chain token's Uniswap v4 hook can do and what happened in its pools (taxes, honeypots, rugs). Real examples, including critical hooks.](https://docs.crius.sh/guides/check-uniswap-v4-hook-risk/)[**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 pools & hooks endpoints

[GET/pool/{pool}Pool detailAnonymous · 1 cr](https://docs.crius.sh/reference/pools/pool-detail/)[GET/hooksUniswap v4 hooksFree · 2 cr](https://docs.crius.sh/reference/pools/uniswap-v4-hooks/)

Request Needs a Free key

 

**cURL**

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

**JavaScript**

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

Response 200 · captured Oct 28, 2026

```json
{
  "data": {
    "abi_events": [
      "Collect(bytes32,uint256,uint256)",
      "Create(address,address,address)",
      "DelegateAuthority(address,address)"
    ],
    "address": "0x4e3468951d49f2eea976ed0d6e75ffcb44a9a544",
    "attribution": "unattributed",
    "capabilities": {
      "can_block_swaps": false,
      "can_gate_liquidity": false,
      "can_modify_liquidity_amounts": false,
      "can_modify_swap_amounts": true
    },
    "code": {
      "admin_functions": [],
      "checked_ts": 1793207143998,
      "code_hash": "0xc41a91106002f15bf70ae266824317f3f3ac638ac72ca5253bae395fa47ee631",
      "family": "0xaa37a5a3457a",
      "kind": "contract",
      "logic": null,
      "owner": null,
      "ownership": "none",
      "size": 25533
    },
    "events": [
      {
        "emitted_in_scan": 7796,
        "event": "Swap(address,(address,address,uint24,int24,address),bytes32,(bool,int256,uint160),int128,int128,bytes)",
        "topic0": "0x1d9f7b5e406d8c887155e1a78e070d2d41c5d0444dab8b21612f846835c27183"
      },
      {
        "emitted_in_scan": 1724,
        "event": "ModifyLiquidity((address,address,uint24,int24,address),(int24,int24,int256,bytes32))",
        "topic0": "0xdb675a606e5aa8f039e93c54673258dc875053bdaa5dbb96de1670bfdece53b3"
      },
      {
        "emitted_in_scan": 545,
        "event": "Create(address,address,address)",
        "topic0": "0xb224da6575b2c2ffd42454faedb236f7dbe5f92a0c96bb99c0273dbe98464c7e"
      }
    ],
    "family": {
      "honeypot_pct": 0.0318652,
      "hooks": 1,
      "id": "0xaa37a5a3457a",
      "liquidity_pulled_pct": 0.0389463,
      "pools_traded": 28244,
      "taxed_pct": 1.78091,
      "verified_hooks": 1
    },
    "fee_tiers_in_scan": [
      {
        "fee": 10000,
        "pools": 3
      },
      {
        "fee": 15000,
        "pools": 2
      },
      {
        "fee": 16000,
        "pools": 1
      }
    ],
    "flags": [],
    "flags_hex": "0x2544",
    "launchpad": null,
    "launchpad_name": null,
    "name": "DopplerHookInitializer",
    "observed": {
      "dynamic_tax_pools": 24,
      "first_trade_ts": 1782922953000,
      "honeypot_pools": 9,
      "last_trade_ts": 1793223683000,
      "liquidity_pulled_pct": 0.0389463,
      "liquidity_pulled_pools": 11,
      "max_buy_tax_pct": 99.52,
      "max_sell_tax_pct": 93.49,
      "median_pool_life_min": 2138,
      "pools": 224061,
      "pools_traded": 28244,
      "tax_measured_pools": 5814,
      "taxed_10pct_pools": 29,
      "taxed_pools": 503,
      "volume_usd": 1968346259
    },
    "pattern": {
      "description": "hooks that change swap amounts only",
      "honeypot_pct": 0.0696347,
      "id": "swap_delta_only",
      "liquidity_pulled_pct": 7.93603,
      "pools_traded": 43082,
      "taxed_pct": 15.7537
    },
    "permissions": [
      "beforeInitialize",
      "afterAddLiquidity",
      "afterRemoveLiquidity"
    ],
    "pools": 224090,
    "risk": [
      "can_modify_swap_amounts"
    ],
    "risk_level": "low",
    "stats": {
      "pools_created_24h": 1181,
      "trades_24h": 59387,
      "volume_usd_24h": 7478239
    },
    "verified": true
  },
  "meta": {
    "block": 100406861,
    "block_age_ms": 985,
    "block_ts": 1793225084000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "intel_computed_ts": 1793223685333,
    "lag_ms": 107,
    "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%2Fhook%2F%7Baddress%7D&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Freference%2Fpools%2Fhook-detail%2F%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)