Robinhood Chain glossary

Short definitions of the terms used across the Crius docs and API responses. Each one links to the page that explains it in full.

Robinhood Chain

Robinhood Chain

An Ethereum layer-2 network built on Arbitrum Orbit, with chain id 4663 (0x1237). A sequencer orders transactions about every 100 ms, and batches are settled on Ethereum. ETH is the gas token. See Robinhood Chain.

Sequencer

The node that orders Robinhood Chain transactions into blocks. A transaction is visible as soon as the sequencer includes it, which is the latest finality level. See Finality & reorgs.

L1 block

The Ethereum block number. Inside a Robinhood Chain contract, block.number returns the L1 block (about every 12 seconds), not the L2 block (about every 100 ms), so per-block contract rules act on L1 blocks. Responses report the L2 block and add l1_block where it matters. See Robinhood Chain.

Finality

How settled a block is. latest means included by the sequencer, safe means its batch is posted to Ethereum, and finalized means Ethereum has finalized that batch. Every response’s meta carries safe_block and finalized_block. See Finality & reorgs.

Reorg

A chain reorganization: blocks that were seen are replaced by others. On Robinhood Chain it is rare. REST responses simply reflect the new chain; WebSocket clients get a reorg message and every affected event again with "removed": true. See Finality & reorgs.

WETH

Wrapped ETH, the ERC-20 version of ETH, at 0x0bd7d308f8e1639fab988df18a8011f41eacad73. Pools quote tokens in native ETH (0x0000000000000000000000000000000000000000) or in WETH, and Crius treats both as ETH for pricing. See Robinhood Chain.

USDG

The dollar stablecoin on Robinhood Chain, at 0x5fc5360d0400a0fd4f2af552add042d716f1d168, with 6 decimals. Crius converts ETH to USD through the deepest ETH/USDG pool and counts USDG as $1. Tokens that copy the USDG symbol at other addresses are never used as a price quote. See Token prices.

Tokenized stock

An ERC-20 token that tracks a listed company’s shares, such as NVIDIA’s Robinhood token NVDA at 0xd0601ce157db5bdc3162bbac2a2c8af5320d9eec. Crius prices tokenized stocks from their Robinhood Chain pools like any other token, so the price can differ from the stock exchange’s. They are known assets and always low risk in the security check. See Token prices.

Smart account

A wallet controlled by contract code. On Robinhood Chain this is usually an EIP-7702 account: an ordinary address whose code points to a delegate contract. Crius tags it smart_account and counts it as a holder; ERC-4337 accounts are attributed the same way, with the bundler as executor. See Holder classes.

Relay solver

A wallet that pays out funds for a cross-chain bridge (Relay). It shows up as the first funder of many wallets, labeled bridge:Relay solver. Bridge funding never links wallets into a cluster. See Find connected wallets.

Tokens and markets

Market cap

The token’s price × (total supply − tokens burned at 0x0000000000000000000000000000000000000000 or 0x000000000000000000000000000000000000dead), with unsold bonding-curve tokens included. In the API it is market_cap_usd. It can be far larger than what the token’s pools could pay, so read it next to liquidity. See Market cap, FDV and supply.

FDV

Fully diluted valuation: price × total supply, burned tokens included (fdv_usd). For tokens with nothing burned it equals the market cap. See Market cap, FDV and supply.

Circulating supply

Total supply minus burned tokens (circulating_supply on the token profile). Tokens held by LP lockers are still counted as circulating; they are reported separately as locked. See Market cap, FDV and supply.

Liquidity

How much a token’s pools can trade. liquidity_usd is 2 × the quote side (ETH, WETH or USDG) of a pool, the convention DEX screeners use, and quote_liquidity_usd is the quote side alone. For Uniswap v3 and v4 only in-range liquidity counts. See Responses & conventions.

TVL

Total value locked: the liquidity of every pool on the chain added up. /stats reports it as liquidity.tvl_usd, measured as 2 × the quote side of every pool, in range for v3 and v4. See Build a chain stats dashboard.

Quote asset

The asset a token is priced and traded against in a pool: native ETH, WETH, USDG, or another token such as a tokenized stock. A pool’s quote field holds its address. See Token prices.

Price confidence

How much liquidity backs a price: high for $10,000 or more in the price pool, medium for $1,000 to $10,000, low below that. Use it before you trust a valuation or act on a price. See Token prices.

Thin liquidity

A price with no real market behind it. thin_liquidity: true means no pool passed Crius’s checks (all are dust, one-sided or implausible), so the price is a fallback and its confidence is low. See Token prices.

OHLCV candle

Open, high, low, close and volume for one time bucket, from 1s to 1d. Crius returns candles in columnar form (t, o, h, l, c, v, plus bv, n and mc) and keeps outlier trades from setting prices. See OHLCV candles.

All-time high (ATH)

The highest price (price.ath_usd) and market cap (price.ath_market_cap_usd) a token has reached, with the time (ath_ts). It is computed from the token’s credible markets, so a spike in a side pool doesn’t set it. See All-time high and price change.

Wash trading

Volume that isn’t real demand. Crius counts same-transaction round trips (buys and sells of one token in one pool inside one transaction that cancel within 2%) as wash_volume_usd, apart from organic volume_usd. See Build a chain stats dashboard.

Launchpads

Launchpad

A platform that lets anyone create a token in one transaction, usually starting on a bonding curve. Crius attributes tokens to their launchpad (Pons, Flap.sh, Bankr, Long.xyz, Flywheel, King of the Markets) from the factory that created them. See Launchpads.

Bonding curve

A launchpad contract that sells a new token at a price that rises with each buy, against a quote asset such as ETH. While a token is bonding, the curve is its only market and its price comes from there. See Track bonding and graduating tokens.

Graduation

The moment a bonding-curve token raises its target and moves to a DEX: the launchpad puts the raised quote and part of the supply into a Uniswap pool, often locking the LP. In the API, status changes from bonding to graduated. See Launchpads.

Graduation threshold

The amount of quote a curve must raise before the token graduates (graduation_threshold, or progress.threshold on /launch). CHARGE graduated from Pons after raising 4.2 ETH. progress_pct shows how close a token is. See Track bonding and graduating tokens.

Creator fee

The share of each trade a launchpad pays to the token’s creator, such as creator_tax_bps: 200 (2%) on a Pons token. /token/{address}/fees shows what was earned, who receives it and what was claimed. See Fees and creator rewards.

Snipe tax

A high temporary tax some launchpads charge in the first seconds of trading to discourage bots. On Pons it starts at 9,900 bps (99%) and lasts 3 seconds (fees.snipe_tax on /launch). See Launchpads.

Uniswap

Uniswap v2, v3 and v4

The three Uniswap versions on Robinhood Chain. v2 pairs hold two reserves, v3 pools concentrate liquidity in price ranges, and v4 pools live inside one PoolManager contract and can attach hooks. See Uniswap v2, v3 & v4.

PoolManager

The single Uniswap v4 contract that holds every v4 pool’s tokens, at 0x8366a39cc670b4001a1121b8f6a443a643e40951 on Robinhood Chain. It often looks like a token’s largest holder; Crius labels it uniswap_v4_pool_manager and leaves it out of holder stats. See Holder classes.

Pool id

How a pool is identified in the API: the pair or pool contract address for v2 and v3, and a 32-byte id for v4 pools, since they have no contract of their own. See Uniswap v2, v3 & v4.

v4 hook

A contract a Uniswap v4 pool calls before or after swaps and liquidity changes. Hooks enable launch taxes and dynamic fees, but a hook can also block swaps, change amounts or stop liquidity removal. Its permissions are encoded in its address. See Check the risk of a Uniswap v4 hook.

Hook tax

A fee a v4 hook takes from swaps, on top of the pool’s own fee. Crius measures it from real trades, so it appears in a token’s realized tax even when the token contract itself has no tax. See Check token taxes.

In-range liquidity

The part of a v3 or v4 pool’s liquidity whose price range includes the current price. Only that part can be traded right now, so it is the only part counted in liquidity_usd. See Uniswap v2, v3 & v4.

LP position

A liquidity provider’s share of a pool: LP tokens for v2, an NFT position for v3 and v4. Whoever holds it can withdraw the liquidity, which is why lock and burn status matters. See Check if liquidity is locked.

Safety and risk

Security score

A 0–100 summary of a token’s risk from /token/{address}/security, starting at 100 with points taken off for each problem. It comes with a risk level (low, medium, high, critical) and the flags that cost points. See Token security score.

Honeypot

A token you can buy but not sell. Crius flags one when a simulated sell fails, or when 20 or more buys have no sells from anyone but the developer. A honeypot is always critical risk. See Detect a honeypot.

Selective honeypot

A token where only the developer has managed to sell (honeypot.selective: true). Ordinary buyers are stuck while the developer exits. It costs 60 points in the security score. See Detect a honeypot.

Buy and sell tax

The percentage taken from a buy or a sell, by the token contract or by its pool’s hook (tax.buy_pct, tax.sell_pct). Over 5% costs 15 points in the security score and over 10% costs 30. See Check token taxes.

Realized tax

Tax measured from real trades over the last 30 days: what the pool sent compared with what the wallet received. tax.realized.samples says how many buys and sells it is based on. See Check token taxes.

Simulated tax

Tax measured by simulating a buy, a transfer and a sell at the head block (tax.simulated). It covers tokens nobody has sold yet, and a failed simulated sell marks the token as a honeypot. See Detect a honeypot.

LP lock

Liquidity held by a locker contract until a date or forever, so nobody can withdraw it before then. Crius follows the Pons launch locker, UNCX, Team Finance, TitanLocker, HoodLock and others, with the unlock time. See Check if liquidity is locked.

LP burn

Liquidity sent to a burn address, which can never be withdrawn. liquidity.summary.burned_pct reports the burned share. See Check if liquidity is locked.

Rug pull

A token whose team pulls the liquidity or dumps its supply, leaving holders unable to sell at a fair price. The developer profile counts a token as rugged when its market cap is under 10% of its ATH (above $5,000) and its liquidity is under $500. See Check developer history.

Renounced ownership

An owner that has given up control of the contract (contract.ownership: "renounced"). Owner powers such as minting, blacklisting or changing taxes stop counting against the score once nobody owns the contract. See Token security score.

Upgradeable proxy

A contract whose code can be replaced by its owner, so its rules can change after you buy. The security check reports is_proxy and upgradeable, and the upgradeable_proxy flag costs 15 points. See Token security score.

Sniper

A wallet that bought within the first 10 blocks after a token’s first trade, about one second on Robinhood Chain. A few snipers holding much of the supply is a warning sign. See Detect bundles and snipers.

Bundle

Coordinated buying that looks like several buyers but is one actor: one transaction buying for several recipients, a launch transaction that also buys, wallets with a shared funder buying in the same block, or wallets forwarding tokens to a common wallet. See Detect bundles and snipers.

Insider launch

A launch where a few wallets, including the developer or wallets linked to it, sniped most of the supply. It costs 50 points and always makes the risk high. Rebot is an example: four wallets took about 61% of the supply. See Detect bundles and snipers.

Wallet farm

Many holder wallets created and funded together by one party, to fake a broad holder base. It costs 50 points and makes the risk high. See Token security score.

Uniform holders

Holder balances that are suspiciously equal, typical of an airdrop to controlled wallets. The security check reports how many of the top holders share the same balance (launch.uniform_holders), and the flag costs 30 points. See Token security score.

Address poisoning

Sending dust from an address that looks like one a victim uses, hoping they copy the wrong address later. Crius ignores such lookalike dust transfers when it links wallets in bubble maps. See Read a bubble map.

Wallets and holders

Holder

An address that holds a token and isn’t infrastructure. Pools, the PoolManager, lockers, burn addresses, hooks, routers and other contracts are left out of holder counts and concentration stats. See Holder classes.

Dev wallet

The wallet that created or deployed a token, tagged dev. Its holding (holders.dev_pct), its early buys and its other launches are some of the strongest risk signals. See Check developer history.

Whale

A holder with 1% or more of a token’s total supply, tagged whale. Infrastructure such as a pool or locker is never a whale, however much it holds. See Holder classes.

Trader attribution

Working out who really traded when a swap was sent by a router, aggregator, solver, bundler or bot contract. Crius makes the address whose balance changed the trader, and reports the infrastructure as executor and signer. See Trader attribution.

Bubble map

A graph of a token’s top holders as nodes, with edges for funding and transfers between them. Linked holders form clusters, which often reveal one party behind many wallets. See Read a bubble map.

Holder cohort

The wallets that held a token through a window, such as from the $50k market cap mark until now, above a size threshold. Use it to find holders who didn’t sell. See Find diamond-hand holders.

PnL

Profit and loss. Crius uses the average-cost method: realized PnL from sells, unrealized PnL from what is still held at the current price, with USD values from trade time. See How PnL is computed.

Using the API

API key

The secret that identifies your account, sent in the x-api-key header. Core endpoints work without one; a free key raises the limits and unlocks more endpoints. See Authentication & API keys.

Anonymous plan

Requests without a key: 2 requests per second per IP, on the core endpoints only (prices, token profiles, pools, trades, candles, search, stats, the cached security check). See Plans, limits & credits.

Credits

The unit of usage. Each request costs 1 to 20 credits depending on the endpoint, and each plan includes a monthly amount, shared by all of an account’s keys and reset at the start of each UTC month. The x-credits-cost header shows what a request cost. See Plans, limits & credits.

Rate limit

How many requests per second a key (or, without a key, an IP address) can send, with a burst of twice that. Going over returns 429 rate_limited with a retry-after header. See Plans, limits & credits.

meta.block

The latest Robinhood Chain block a response reflects, in every response’s meta, next to block_ts and lag_ms. Use it to cache, to compare two answers, and to cite exactly what your data was based on. See Responses & conventions.

Cursor

The token for the next page of a list (meta.next_cursor). Pass it back as cursor; cursors are opaque and stable. See Responses & conventions.

WebSocket stream

One connection that pushes trades, prices, live candles, launches, graduations, new pools, tax and LP changes and wallet activity as blocks are decoded. It needs a Free key or higher and costs 1 credit per connection. See WebSocket stream.

Frequently asked questions

Related

Get your free Crius API key

Every example on this page works with a free key: higher rate limits than the anonymous plan, holders, wallets and the WebSocket stream. No card needed.

Get a free API key See plans

• Robinhood Chain (4663) only, from our own archive nodes
• REST + WebSocket
• Pay on-chain or by card