# Crius

> Crius is a real-time and historical data API for Robinhood Chain (chain id 4663): token prices, OHLCV candles, trades with real-trader attribution, holders (live, snapshots, cohorts), pools (Uniswap v2/v3/v4 and hooks), launchpads (Pons, Flap.sh, Bankr, Long.xyz, King of the Markets), security checks and wallet analytics, over REST and WebSocket.

- REST base URL: https://api.crius.sh/v1/robinhood/… (path segment `{chain}` = `robinhood` or `4663`)
- Connection test (no key needed): GET https://api.crius.sh/v1/status (node and chain status), or GET https://api.crius.sh/v1/robinhood (an index of the main endpoints). A first data call: GET https://api.crius.sh/v1/robinhood/stats
- Authentication: `x-api-key` header. Core endpoints (price, token, pools, trades, candles, search, stats) also work without a key at 2 requests/second per IP.
- Every response is `{data, meta}`; `meta.block` is the block the data reflects. Amounts are human units, USD values plain decimals, timestamps unix milliseconds.
- OpenAPI 3: https://api.crius.sh/openapi.json · Full docs in one file: https://crius.sh/llms-full.txt

## Get started

- [Crius API documentation](https://crius.sh/docs/index.md): The Crius API serves real-time and historical Robinhood Chain data (token prices, candles, trades, holders, pools, launchpads, security checks) over REST and WebSocket from our own archive nodes.
- [Quickstart](https://crius.sh/docs/quickstart.md): Create a free Crius account, get an API key and make your first Robinhood Chain API request with cURL, JavaScript or Python in under five minutes.
- [Authentication & API keys](https://crius.sh/docs/authentication.md): How to authenticate Crius API requests with the x-api-key header, key scopes, IP allow-lists, browser origins, expiry, rotation with a grace period, and dashboard sessions.
- [Plans, limits & credits](https://crius.sh/docs/plans-and-limits.md): Crius API plans (Free, Starter, Pro, Business, Enterprise), monthly credits, requests per second, WebSocket limits, credit cost per endpoint and the rate-limit response headers.
- [Responses & conventions](https://crius.sh/docs/conventions.md): The Crius API response envelope, meta block, number and amount formats, timestamps, addresses, pagination, finality levels and liquidity and market-cap definitions.
- [Errors](https://crius.sh/docs/errors.md): Crius API error format, HTTP status codes and every error code with its meaning and what to do about it.

## Try it

- [API playground](https://crius.sh/docs/playground.md): Try every Crius API endpoint from your browser - pick an endpoint, fill in parameters, send a live request to api.crius.sh and copy ready-made cURL, JavaScript and Python code.
- [Chart example](https://crius.sh/docs/examples/chart.md): Draw a live candlestick and volume chart for any Robinhood Chain token with the Crius candles endpoint and TradingView Lightweight Charts, with full source code.
- [Real-time stream example](https://crius.sh/docs/examples/stream.md): A complete reconnecting WebSocket client for the Crius stream in Node.js - subscribe to new launches, trades and prices on Robinhood Chain, resume after disconnects and handle reorgs.

## API reference

- [Tokens & prices](https://crius.sh/docs/reference/tokens.md): Token profiles, live USD prices, batch prices, sparse batch profiles and every market a token trades in on Robinhood Chain.
- [Trades & candles](https://crius.sh/docs/reference/trades.md): Trade tape with real-trader attribution, OHLCV candles from 1 second to 1 day, and a unified activity feed for any Robinhood Chain token.
- [Holders & traders](https://crius.sh/docs/reference/holders.md): Live holder lists, holder snapshots at any past block, time or market cap, diamond-hand cohorts, holder count history and top traders with PnL.
- [Security & liquidity](https://crius.sh/docs/reference/security.md): Realized buy and sell tax, simulated honeypot checks, contract flags and LP lock status for any Robinhood Chain token.
- [Launchpads & fees](https://crius.sh/docs/reference/launchpads.md): Launchpad lifecycle (bonding curve progress, graduation), live launchpad stats, and fees, claims and receivers for Robinhood Chain tokens.
- [Pools & hooks](https://crius.sh/docs/reference/pools.md): Pool details for Uniswap v2, v3 and v4 on Robinhood Chain, and Uniswap v4 hooks with decoded permissions and risk flags.
- [Wallets & devs](https://crius.sh/docs/reference/wallets.md): Wallet profiles with holdings and PnL, wallet trade history, funding connections and token developer profiles on Robinhood Chain.
- [Bundles & bubble maps](https://crius.sh/docs/reference/wallet-graph.md): Sniper, bundle and cluster detection and holder bubble-map graphs for Robinhood Chain tokens.
- [Discovery & search](https://crius.sh/docs/reference/discovery.md): Token lists (new, bonding, graduating, trending, top gainers and losers) and search across tokens, pools, wallets and hooks on Robinhood Chain.
- [Chain stats & status](https://crius.sh/docs/reference/chain.md): Chain-wide Robinhood Chain numbers (volume, trades, TVL, launches, gas) and the API's own health and supported chains.
- [WebSocket stream](https://crius.sh/docs/reference/stream.md): Real-time Robinhood Chain data over one WebSocket - trades, prices, live candles, new launches, graduations, new pools, LP and tax changes, wallet activity, with replay and reorg handling.
- [Account API](https://crius.sh/docs/reference/account.md): Manage your Crius account programmatically - email and wallet sign-in, usage and quota, API keys (create, update, rotate, revoke), dashboard sessions and linked wallets.
- [Billing & payments](https://crius.sh/docs/reference/billing.md): How Crius plans are paid on-chain on Robinhood Chain in USDG, ETH or WETH - pricing, 6 and 12 month discounts, auto-renew with a price cap, upgrades with credit, and the billing endpoints.

## Concepts

- [Robinhood Chain](https://crius.sh/docs/concepts/robinhood-chain.md): What Robinhood Chain is (chain id 4663), its block times, gas, L1 settlement, native assets (ETH, WETH, USDG), tokenized stocks, and how Crius indexes it.
- [Launchpads](https://crius.sh/docs/concepts/launchpads.md): How token launchpads on Robinhood Chain work (bonding curves, graduation to Uniswap pools, LP locks) and which launchpads Crius attributes, including Pons, Flap.sh, Bankr and Long.xyz.
- [Uniswap v2, v3 & v4](https://crius.sh/docs/concepts/uniswap.md): How Crius indexes Uniswap v2 pairs, v3 concentrated-liquidity pools and v4 singleton pools with hooks on Robinhood Chain, including liquidity definitions and v4 hook permissions.
- [Trader attribution & wallet tags](https://crius.sh/docs/concepts/attribution.md): How Crius attributes Robinhood Chain trades to the real trader behind routers, aggregators, bundlers and bot contracts, and what each wallet tag means.
- [Finality & reorgs](https://crius.sh/docs/concepts/finality.md): Finality levels on Robinhood Chain (latest, safe, finalized), how the Crius API marks them, and how chain reorganizations are handled in REST and WebSocket.

## Resources

- [FAQ](https://crius.sh/docs/faq.md): Answers to common questions about the Crius Robinhood Chain API - pricing, free plan, data freshness, coverage, history, rate limits, payments and support.
- [Changelog](https://crius.sh/docs/changelog.md): Changes to the Crius API, dashboard and documentation.
- [For AI agents & LLMs](https://crius.sh/docs/ai.md): How AI assistants and agents can read the Crius documentation (llms.txt, llms-full.txt, Markdown pages) and call the Crius API (OpenAPI document, anonymous endpoints).

## Blog

- [Detect Token Bundles, Sniper Wallets and Connected Holders](https://crius.sh/blog/bundles-snipers-connected-holders.md): Spot bundled launches, sniper wallets and clusters of connected holders on Robinhood Chain with the Crius bundles, bubble map and wallet connections APIs.
- [How to Connect an LLM to Robinhood Chain Data](https://crius.sh/blog/connect-llm-robinhood-chain-data.md): Three working ways to give a language model live Robinhood Chain data: an MCP server, a tool-calling loop for any model API, and retrieval over the Crius docs.
- [How to Detect New Uniswap v4 Pools on Robinhood Chain](https://crius.sh/blog/detect-new-uniswap-v4-pools.md): Detect every new Uniswap v4 pool on Robinhood Chain as it is created: the pools:new stream, raw PoolManager Initialize logs, and hook checks before you trade.
- [How to Monitor Launchpad Creator Fees and Revenue](https://crius.sh/blog/launchpad-creator-fees-revenue.md): Measure what Robinhood Chain launchpad creators earn: hook fees, creator tax, sweeps and pending balances per token and per creator, with Pons examples.
- [How to Calculate Robinhood Chain Liquidity, TVL and DEX Volume](https://crius.sh/blog/liquidity-tvl-dex-volume.md): How Robinhood Chain liquidity, TVL and DEX volume are measured: per-pool USD liquidity, quote-side valuation, thin pools, volume windows, wash trades.
- [Track Pons Bonding Curve Progress With an API](https://crius.sh/blog/pons-bonding-curve-progress-api.md): Read Pons bonding curve progress on Robinhood Chain, ETH raised versus the 4.2 ETH threshold, in real time; with code for speed, ETA and graduation alerts.
- [Build a Crypto Portfolio Dashboard Using the Crius API](https://crius.sh/blog/portfolio-dashboard-crius-api.md): Build a portfolio dashboard for Robinhood Chain wallets: holdings, live valuation in one batch call, realized and unrealized PnL, gas and confidence.
- [How to Build a Real-Time Robinhood Chain Trading Terminal](https://crius.sh/blog/real-time-trading-terminal.md): Build a Robinhood Chain trading terminal: REST bootstrap, WebSocket updates, a live candle chart, trade tape and risk panels, with working code.
- [Robinhood Chain API for AI Agents: Live On-Chain Research](https://crius.sh/blog/robinhood-chain-api-ai-agents.md): Give an AI agent live Robinhood Chain data: llms.txt and Markdown docs for context, OpenAPI-derived tools for calls, and the guardrails that keep it accurate and cheap.
- [Robinhood Chain Historical Data: Indexing, Retention and Reorgs](https://crius.sh/blog/robinhood-chain-historical-data-reorgs.md): How Crius indexes Robinhood Chain from block 0, what history is retained, how latest, safe and finalized data differ, and how to handle reorgs in REST and WebSocket.
- [How to Fetch Historical OHLCV Candles on Robinhood Chain](https://crius.sh/blog/robinhood-chain-ohlcv-candles.md): Fetch historical OHLCV candles for any Robinhood Chain token: intervals from 1s to 1d, paging with to_ts, pool selection, gap filling and clean wicks.
- [Robinhood Chain API: The Complete Developer Guide for 2026](https://crius.sh/blog/robinhood-chain-token-api.md): How to get Robinhood Chain prices, OHLCV candles, trades, holders, launches and live streams from one API, with tested code in cURL, Node.js and Python.
- [Robinhood Chain Token Holders API: Live and Historical Snapshots](https://crius.sh/blog/robinhood-chain-token-holders-api.md): Get the holders of any Robinhood Chain token, live or at any past block or market cap, with cohorts and holder-count history. Code in Node.js and Python.
- [Robinhood Chain WebSocket API: Live Trades, Prices and Reconnects](https://crius.sh/blog/robinhood-chain-websocket-api.md): Stream live Robinhood Chain trades, prices, candles, launches and new pools over WebSocket: channels, resume after reconnects, reorgs and finality.
- [Track Robinhood Chain Smart Money Wallets and Top Traders](https://crius.sh/blog/smart-money-top-traders.md): Find wallets that are consistently profitable across Robinhood Chain tokens: top traders by PnL, wallet tags, and a script that filters out bots and infrastructure.
- [How Robinhood Chain Stock Token Multipliers Affect Price Data](https://crius.sh/blog/stock-token-multipliers-price-data.md): Robinhood stock tokens use an ERC-8056 uiMultiplier for splits and dividends. What it does to prices, balances and charts, and how to convert correctly.
- [Build a Robinhood Chain Token Screener with Node.js](https://crius.sh/blog/token-screener-nodejs.md): Build a Robinhood Chain token screener in Node.js: rank by volume or momentum, filter on liquidity, holders and flow, then check tax, honeypots and LP.
- [Understanding Tokenized Stock Prices on Robinhood Chain](https://crius.sh/blog/tokenized-stock-prices-robinhood-chain.md): How Robinhood stock tokens like TSLA and NVDA are priced on-chain: DEX pools, confidence and thin-liquidity flags, copycat tokens, weekends and multipliers.
- [How to Track Wallet PnL on Robinhood Chain](https://crius.sh/blog/wallet-pnl-robinhood-chain.md): Realized and unrealized PnL, win rate and per-token results for any Robinhood Chain wallet: the average-cost method, the API calls and code to recompute it.
- [Best Robinhood Chain Data APIs Compared: Crius, Bitquery, Alchemy & More](https://crius.sh/blog/best-robinhood-chain-data-apis-compared.md): Which APIs cover Robinhood Chain in October 2026: RPC providers, multi-chain indexers and market-data APIs compared on data, history, streaming, price.
- [Holder analysis on Robinhood Chain: snapshots, diamond hands and bubble maps](https://crius.sh/blog/holder-analysis-bubble-maps.md): How to analyse a token's holders on Robinhood Chain: live concentration, holders at any past block or market cap, wallets that held through a window, and bubble maps of connected wallets.
- [Detecting honeypots and hidden taxes on Robinhood Chain](https://crius.sh/blog/honeypot-tax-detection.md): Why static contract scans miss many honeypots and taxes, how measuring tax from real trades and simulating a full buy-transfer-sell sequence catches them, and how to use it before you trade.
- [How to get real-time token prices on Robinhood Chain](https://crius.sh/blog/real-time-token-prices-robinhood-chain.md): Three ways to get live Robinhood Chain token prices (single, batch and streaming), how on-chain prices are derived, and how to avoid bad prices from thin liquidity.
- [Pons Launchpad API: Track Token Launches and Graduations in Real Time](https://crius.sh/blog/track-pons-launchpad-tokens.md): Track every Pons launch on Robinhood Chain in real time: new tokens, bonding curve progress, graduations into Uniswap v4, fees and creator history, with code.
- [Building a Robinhood Chain trading bot with WebSocket streams](https://crius.sh/blog/trading-bot-websocket-streams.md): Architecture and working code for a Robinhood Chain trading bot: stream new launches and trades, filter with security and holder checks, track prices in real time and handle reconnects and reorgs.
- [Uniswap v4 hooks on Robinhood Chain, explained](https://crius.sh/blog/uniswap-v4-hooks-robinhood-chain.md): What Uniswap v4 hooks are, how their permissions are encoded in the hook address, which permissions can block swaps or trap liquidity, and how to check any hook on Robinhood Chain.
- [How to Get All Robinhood Chain Transactions Without Running a Node](https://crius.sh/blog/robinhood-chain-transactions-without-node.md): Export every trade, transfer and liquidity event for a Robinhood Chain token or wallet with an indexed API. Tested Python and Node.js, no archive node.
- [Robinhood Chain REST API vs RPC vs Indexed Data API](https://crius.sh/blog/robinhood-chain-rest-api-vs-rpc-vs-indexed.md): One Robinhood Chain question answered three ways: raw JSON-RPC, a REST wrapper and an indexed data API, with tested code, timings and when to use each.
- [Free Robinhood Chain API: What Can You Build Without Paying?](https://crius.sh/blog/free-robinhood-chain-api.md): What the free Robinhood Chain API covers, the exact no-key and free-plan limits, and three working projects: price ticker, launch radar, whale alerts.
- [Robinhood Chain vs Ethereum Mainnet: Indexing Requirements](https://crius.sh/blog/robinhood-chain-vs-ethereum-indexing.md): Why indexing Robinhood Chain differs from Ethereum: 100x more blocks, two clocks, staged finality, Nitro receipts and traces, with real index figures.

## Robinhood Chain APIs

- [Robinhood Chain API](https://crius.sh/robinhood-chain-api/): overview of every Crius product, how it works, and how it compares.
- [Robinhood Chain token price API](https://crius.sh/api/token-price.md): Live USD and ETH prices for every Robinhood Chain token and tokenized stock, from on-chain pools, with liquidity and confidence. Free plan.
- [Robinhood Chain OHLCV candles API](https://crius.sh/api/ohlcv-candles.md): OHLCV candles for any Robinhood Chain token, 1 second to 1 day, live and historical, with dust and off-market prints filtered. Free plan.
- [Robinhood Chain DEX trades and swap history API](https://crius.sh/api/dex-trades.md): Every swap on Robinhood Chain: Uniswap v2/v3/v4 and launchpad curves, with the real trader, price, value, tax and finality. Full swap history.
- [Robinhood Chain WebSocket API](https://crius.sh/api/websocket.md): Stream Robinhood Chain trades, prices, live candles, new pools, launches and graduations over one WebSocket, with resume and reorg handling.
- [Robinhood Chain token holders API](https://crius.sh/api/token-holders.md): Live holder lists and holder snapshots at any past block, time or market cap for every Robinhood Chain token, plus cohorts and holder history.
- [Robinhood Chain liquidity and TVL API](https://crius.sh/api/liquidity.md): Liquidity, LP locks and TVL for Robinhood Chain tokens and pools: who owns the LP, what is locked or burned and until when, chain-wide TVL.
- [Robinhood Chain wallet analytics and PnL API](https://crius.sh/api/wallet-analytics.md): Wallet PnL, holdings, trade history and top traders for Robinhood Chain: realized and unrealized PnL, ROI, win rate and wallet tags.
- [Robinhood Chain honeypot checker and token tax API](https://crius.sh/api/token-security.md): Check any Robinhood Chain token for honeypots, buy/sell tax, risky contract flags, v4 hook risk and LP locks, from real trades and simulation.
- [Robinhood Chain bundle map and sniper detection API](https://crius.sh/api/bundle-detection.md): Detect snipers, bundled buys, funding clusters and connected holders on Robinhood Chain, with bubble-map graphs ready to render.
- [Robinhood Chain new token and graduation tracker API](https://crius.sh/api/launchpads.md): Track every new token, bonding curve and graduation on Robinhood Chain launchpads (Pons, Flap.sh, Bankr, Long.xyz, King of the Markets).
- [Pons launchpad API: token tracker and bonding curve data](https://crius.sh/api/pons.md): Pons launchpad API for Robinhood Chain: every Pons token, bonding curve progress, graduations to Uniswap v4, creator fees and live launches.
- [Flap.sh token API for Robinhood Chain](https://crius.sh/api/flap-sh.md): Flap.sh token data on Robinhood Chain: every Flap.sh launch, graduation, pools, prices, trades and holders through one API.
- [Uniswap v4 on Robinhood Chain: pools and hooks API](https://crius.sh/api/uniswap-v4.md): Uniswap v4 on Robinhood Chain: every pool and hook with decoded permissions and risk flags, new pools live, trades, liquidity and fees.
- [Robinhood Chain historical data API](https://crius.sh/api/historical-data.md): Robinhood Chain history from block 0: trades, candles, holders at any block, transfers and stats, indexed and finality-aware. No node needed.

## Comparisons

- [Robinhood Chain API comparison](https://crius.sh/compare/): Crius and other Robinhood Chain data providers side by side, with sources.
- [Robinhood Chain RPC vs indexed API](https://crius.sh/compare/rpc-vs-indexer/): what an RPC gives you, what an indexer adds, and what building one takes.
- [Crius vs Bitquery for Robinhood Chain data](https://crius.sh/compare/bitquery.md): Crius vs Bitquery for Robinhood Chain data: GraphQL cubes vs a chain-specific REST + WebSocket API. Coverage, launchpads, pricing and when to use each.
- [Crius vs Alchemy for Robinhood Chain](https://crius.sh/compare/alchemy.md): Alchemy gives you Robinhood Chain RPC, WebSockets and token/transfer APIs; Crius gives you indexed market data: trades, candles, holders, launchpads.
- [Crius vs QuickNode for Robinhood Chain](https://crius.sh/compare/quicknode.md): QuickNode gives you Robinhood Chain RPC with archive, debug/trace and Streams; Crius gives you decoded trades, candles, holders and launchpad data.
- [Crius vs GoldRush (Covalent) for Robinhood Chain](https://crius.sh/compare/goldrush.md): GoldRush offers multi-chain wallet, balance and transaction APIs that include Robinhood Chain; Crius specialises in its DEX, holder and launchpad data.
- [Crius vs Mobula for Robinhood Chain](https://crius.sh/compare/mobula.md): Mobula and Crius both serve Robinhood Chain token prices, OHLCV, trades, holders and wallet data. How their coverage and focus compare.
- [Crius vs Dune for Robinhood Chain](https://crius.sh/compare/dune.md): Dune is a SQL warehouse for Robinhood Chain analysis and dashboards; Crius is a real-time API for applications. When to use each.
- [Crius vs Goldsky for Robinhood Chain](https://crius.sh/compare/goldsky.md): Goldsky gives you subgraphs and pipelines to build your own Robinhood Chain index; Crius gives you a ready-made market-data API. Which fits?

## Optional

- [Pricing](https://crius.sh/pricing/): Free plan (1M credits/month), Starter $19, Pro $79, Business $249 per month, paid on-chain.
- [Platform integrations](https://crius.sh/integrations/): custom limits, firehose stream, custom endpoints and priority support for wallets, explorers, terminals, launchpads and AI products. Contact support@crius.sh, subject "Platform integration".
- [Terms of Service](https://crius.sh/terms/), [Privacy Policy](https://crius.sh/privacy/), [Acceptable Use](https://crius.sh/acceptable-use/), [Refund Policy](https://crius.sh/refunds/)
- [Service status](https://status.crius.sh)