CRIUS

Liquidity API

Robinhood Chain liquidity and TVL API

Crius tells you how much liquidity a Robinhood Chain token has, in which pools, and who controls it: burned, locked in a known locker until a given time, or sitting in wallets that can pull it. The same index gives you per-pool TVL and chain-wide TVL and locked liquidity.

Get a free API key API reference
  • History from block 0
  • REST + WebSocket
  • Free plan: 1M credits / month
  • Robinhood Chain · chain ID 4663

Try it

A real request and its response

Captured from the live API, trimmed for length. Replace $CRIUS_API_KEY with your key; calls without that header work keyless at 2 requests a second.

Who owns CHARGE's liquidity Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x7b8892cea949bc60d494681d1bc3ea96071ab0b8/liquidity" \
  -H "x-api-key: $CRIUS_API_KEY"
Response 
{
  "data": {
    "pools": [
      {
        "pool": "0x871b166182fd708d5d16a4daa9a42f05a653fa51ee2b195097f425e0d9ca4913",
        "dex": "uniswap_v4",
        "liquidity_usd": 6681.33,
        "lp_type": "nft_positions",
        "summary": {
          "burned_pct": 0,
          "locked_pct": 100,
          "protocol_fee_pct": 0,
          "unlocked_in_wallets_pct": 0
        },
        "locks": [
          {
            "locker": "pons_v2_launch_locker",
            "locker_address": "0x267444d099b10fb5ed7c3cc7b7c767adca574952",
            "status": "locked",
            "permanent": true,
            "locked_block": 88461321
          }
        ]
      }
    ],
    "summary": {
      "burned_pct": 0,
      "locked_pct": 99.8905,
      "next_unlock_ts": null,
      "protocol_fee_pct": 0,
      "unlocked_in_wallets_pct": 0.10947,
      "weighting": "by pool liquidity_usd"
    }
  },
  "meta": {
    "block": 96714197,
    "block_ts": 1792839655000,
    "finalized_block": 96703786,
    "lag_ms": 30,
    "safe_block": 96707359
  }
}

The graduated Pons pool's LP position sits in the Pons launch locker, permanently. Other pools of the same token list each LP owner's share.

What you get

Built for Robinhood Chain, not bolted on

  • LP ownership per pool

    Burned, locked (which locker, until when, who can withdraw) or held by wallets, for v2 LP tokens and v3/v4 NFT positions.

  • Known lockers

    The Pons launch locker, UNCX v2/v3/v4, Team Finance, TitanLocker and HoodLock are decoded.

  • Follows unlocks

    After an unlock the LP keeps being tracked: withdrawn, to whom, removed or still held.

  • Consistent TVL

    TVL is 2× the quote side (ETH, WETH, USDG) of every pool, in-range only for v3 and v4, so numbers compare across pools.

  • Every market of a token

    v2 pairs, v3 pools, v4 pools with hooks and bonding curves, with liquidity and 24h activity.

  • LP events live

    lp: on the WebSocket pushes liquidity added or removed.

Endpoints

The calls behind it

Base URL https://api.crius.sh, chain segment robinhood (or 4663). Every response is {data, meta} with the block it reflects.

EndpointReturnsPlanCredits
GET /v1/{chain}/token/{address}/liquidity Per pool: liquidity, LP owners, locks and unlock times Free+ 5
GET /v1/{chain}/token/{address}/pools Every market of a token with liquidity and 24h activity Any (no key) 1
GET /v1/{chain}/pool/{pool} Reserves, in-range liquidity, fee, hook and TVL of one pool Any (no key) 1
GET /v1/{chain}/stats Chain-wide TVL and locked liquidity Any (no key) 1

Use cases

  • Rug-pull and LP-unlock monitoring
  • Pre-trade liquidity checks
  • DEX and TVL dashboards
  • Listing due diligence
  • Market-making analysis

Plans and limits

Token liquidity and locks: Free plan, 5 credits. Pools and pool detail: every plan, 1 credit. Chain stats: every plan.

See pricing Plans, limits & credits

Questions about the Liquidity & TVL API

How is TVL calculated?

As 2× the quote side (ETH, WETH or USDG) of each pool, counting only in-range liquidity for Uniswap v3 and v4, so a pool's value doesn't depend on the price of the token being listed.

Which lockers are supported?

The Pons launch locker, UNCX v2/v3/v4, Team Finance, TitanLocker and HoodLock.

Can I tell if a token's liquidity is locked?

Yes. /liquidity lists each pool's LP owners with lock status, locker, permanence and unlock time; the token profile and security check summarise it as locked, burned and unlocked percentages.

Do you track liquidity after it unlocks?

Yes. The LP keeps being followed after an unlock: who withdrew it, where it went, and whether it was removed from the pool.

Related APIs

Guides and articles

Documentation

Security & liquidity reference →Pools & hooks reference → All Robinhood Chain APIs → Compare providers →

Start with the free plan

1,000,000 credits a month, no card. Your key in under a minute.

Get a free API key Try the playground