# Move from raw RPC calls to the Crius API on Robinhood Chain

> Replace eth_getLogs scans, slot0 math and Transfer replays with Crius API calls on Robinhood Chain: a mapping table, before/after code and credit costs.

Source: https://docs.crius.sh/guides/migrate-from-rpc-to-crius/ · Updated 2026-10-28

Short answer

Keep your RPC for writes (`eth_sendRawTransaction`, gas, nonces) and your own contracts. Replace the reads you index yourself: Swap logs with `GET /token/{address}/trades`, slot0 and reserve math with `/pool/{pool}` or `/token/{address}/price`, Transfer replays with `/holders`, ERC-20 metadata calls with `/token/{address}` or `/tokens/batch`, and `eth_subscribe` logs with the WebSocket stream.

[GET `/token/{address}/trades`](https://docs.crius.sh/reference/trades/trade-tape/) [GET `/pool/{pool}`](https://docs.crius.sh/reference/pools/pool-detail/) [GET `/token/{address}/price`](https://docs.crius.sh/reference/tokens/token-price/) [GET `/token/{address}/holders`](https://docs.crius.sh/reference/holders/live-holders/) [POST `/tokens/batch`](https://docs.crius.sh/reference/tokens/batch-token-profiles/)

A Robinhood Chain RPC node answers one question about raw chain state at a time: a block, a log range, a contract call. Market data (prices, trades, candles, holders) is built on top of millions of those answers: decoding every DEX’s events, routing prices to USD, finding the real trader behind routers, replaying transfers, handling reorgs. The Crius API is that work already done, from block 0. This guide maps the RPC reads apps usually build themselves onto single Crius calls, and says which RPC calls to keep.

## What to replace, and what to keep

| What you do over RPC | What it takes | Crius call | Credits |
| --- | --- | --- | --- |
| `eth_getLogs` for Swap events, then decode and price them | ABIs for Uniswap v2, v3, v4 and each launch curve, pool-to-token maps, decimals, a USD route, block-range caps | `/token/{address}/trades` | 2 |
| Aggregate swaps into OHLCV | Storage, bucketing, spike filtering | `/token/{address}/candles` | 2 |
| `eth_call` slot0 / getReserves, then price math | Per pool type; v4 needs the PoolManager and pool id | `/pool/{pool}`, `/token/{address}/price` | 1 |
| Replay `Transfer` logs (or `balanceOf` scans) for holders | Every transfer since the token's first block, kept current | `/token/{address}/holders` (Free plan) | 2 |
| `name`, `symbol`, `decimals`, `totalSupply` calls | Four calls per token, plus metadata and logos | `/token/{address}`, `/tokens/batch` (100 per call) | 1 |
| `owner()`, tax and limit getters, a simulated sell | Per contract; simulation infrastructure | `/token/{address}/security` | 1 |
| `eth_subscribe` to logs | No replay after a disconnect; reorgs are yours to undo | WebSocket stream: `trades:`, `pools:new`, `launches:all` | 1 per connection |

Keep the RPC for `eth_sendRawTransaction`, `eth_estimateGas`, nonces, `eth_call` against your own contracts and simulations of your own transactions. Crius is read-only.

Endpoints used: [GET`/token/{address}/trades`](https://docs.crius.sh/reference/trades/trade-tape/) [GET`/token/{address}/candles`](https://docs.crius.sh/reference/trades/ohlcv-candles/) [GET`/pool/{pool}`](https://docs.crius.sh/reference/pools/pool-detail/) [GET`/token/{address}/price`](https://docs.crius.sh/reference/tokens/token-price/) [GET`/token/{address}/holders`](https://docs.crius.sh/reference/holders/live-holders/) [POST`/tokens/batch`](https://docs.crius.sh/reference/tokens/batch-token-profiles/) [GET`/token/{address}/security`](https://docs.crius.sh/reference/security/security-checks/)

## One pool: slot0 math versus one call

Example [Anonymous · no key · 1 credit](https://docs.crius.sh/reference/pools/pool-detail/)

### The WETH/USDG Uniswap v3 pool, decoded

What is WETH worth in the 0.01% WETH/USDG pool (0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca), and how deep is it?

GET/v1/robinhood/pool/0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca

  

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/pool/0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/pool/0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca");
const { data, meta } = await res.json();
```

**Python**

```python
import requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/pool/0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
)
body = r.json()
print(body["data"])
```

**Real response 200 Captured Oct 28, 2026 · 191 lines (arrays trimmed)**

```json
{
  "data": {
    "created_block": 1506281,
    "created_ts": 1783025467340,
    "currency0": {
      "address": "0x0bd7d308f8e1639fab988df18a8011f41eacad73",
      "decimals": 18,
      "logo": null,
      "price_usd": 2355.49,
      "symbol": "WETH"
    },
    "currency1": {
      "address": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "decimals": 6,
      "logo": null,
      "price_usd": 1,
      "symbol": "USDG"
    },
    "dex": "uniswap_v3",
    "dynamic_fee": false,
    "factory": "0x1f7d7550b1b028f7571e69a784071f0205fd2efa",
    "fee": 100,
    "fee_bps": 1,
    "hook": null,
    "lp": null,
    "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
    "pool_manager": null,
    "state": {
      "initialized_ticks": 2234,
      "last_block": 100409961,
      "liquidity": 1994488602507464498,
      "price_0_in_1": 2357.32,
      "price_1_in_0": 0.000424211,
      "real_quote_raised": null,
      "reserve0": 0,
      "reserve1": 0,
      "reserves": {
        "currency0": 3815.33,
        "currency1": 3821317,
        "kind": "real"
      },
      "sqrt_price_x96": 3846701614108804881326106,
      "tick": -198668
    },
    "stats": {
      "all_time": {
        "buy_volume_usd": 13612852311,
        "buys": 24419328,
        "first_trade_ts": 1783530660000,
        "sell_volume_usd": 13597498410,
        "sells": 23196198,
        "since": "chain_start",
        "trades": 47615526,
        "volume_usd": 27210350721
      },
      "avg_trade_usd": {
        "1h": 278.58,
        "1m": 337.523,
        "1s": 835.826,
        "24h": 665.311,
        "30s": 298.573,
        "4h": 669.733,
        "5m": 261.935,
        "6h": 732.144
      },
      "buy_volume_usd": {
        "1h": 3415833,
        "1m": 55762.5,
        "1s": 13.1165,
        "24h": 71952485,
        "30s": 20837.4,
        "4h": 27415158,
        "5m": 336149,
        "6h": 37164488
      },
      "buyers": {
        "1h": 2322,
        "1m": 87,
        "1s": 1,
        "24h": 10385,
        "30s": 47,
        "4h": 4124,
        "5m": 569,
        "6h": 4935
      },
      "buys": {
        "1h": 11720,
        "1m": 131,
        "1s": 1,
        "24h": 105661,
        "30s": 65,
        "4h": 38476,
        "5m": 1420,
        "6h": 47760
      },
      "last_trade_ts": 1793225401000,
      "sell_volume_usd": {
        "1h": 3448384,
        "1m": 52919.9,
        "1s": 12524.3,
        "24h": 71729997,
        "30s": 20962.8,
        "4h": 27060933,
        "5m": 349335,
        "6h": 36625426
      },
      "sellers": {
        "1h": 2408,
        "1m": 119,
        "1s": 7,
        "24h": 11079,
        "30s": 54,
        "4h": 4805,
        "5m": 556,
        "6h": 5661
      },
      "sells": {
        "1h": 12920,
        "1m": 191,
        "1s": 14,
        "24h": 110302,
        "30s": 75,
        "4h": 42864,
        "5m": 1197,
        "6h": 53026
      },
      "traders": {
        "1h": 3245,
        "1m": 194,
        "1s": 8,
        "24h": 15793,
        "30s": 97,
        "4h": 6304,
        "5m": 894,
        "6h": 7551
      },
      "trades": {
        "1h": 24640,
        "1m": 322,
        "1s": 15,
        "24h": 215963,
        "30s": 140,
        "4h": 81340,
        "5m": 2617,
        "6h": 100786
      },
      "txns": {
        "1h": 24522,
        "1m": 322,
        "1s": 15,
        "24h": 212815,
        "30s": 140,
        "4h": 80538,
        "5m": 2564,
        "6h": 99706
      },
      "volume_eth": {
        "1h": 2908.97,
        "1m": 46.14,
        "1s": 5.32262,
        "24h": 61121.5,
        "30s": 17.7459,
        "4h": 23102.1,
        "5m": 291.015,
        "6h": 31357.2
      },
      "volume_usd": {
        "1h": 6864217,
        "1m": 108682,
        "1s": 12537.4,
        "24h": 143682482,
        "30s": 41800.2,
        "4h": 54476091,
        "5m": 685484,
        "6h": 73789914
      }
    },
    "swaps_indexed": 1956380,
    "tick_spacing": 1,
    "tvl_usd": 12808300
  },
  "meta": {
    "block": 100409961,
    "block_age_ms": 1256,
    "block_ts": 1793225401000,
    "chain": "robinhood",
    "finalized_block": 100401329,
    "lag_ms": 22,
    "safe_block": 100405028
  }
}
```

What this tells you

-   `state.sqrt_price_x96` (3846701614108804881326106) and `state.tick` (−198668) are the raw slot0 values an RPC call returns. Crius also returns the result of the math: `state.price_0_in_1` 2357.32 USDG per WETH and `price_1_in_0` 0.000424211.
-   `currency0` is WETH with 18 decimals, `currency1` USDG with 6: the decimals you would otherwise fetch with two more calls. `fee: 100` is 1 basis point (`fee_bps: 1`).
-   `state.reserves` holds 3,815.33 WETH and 3,821,317 USDG (`kind: "real"`), and `tvl_usd` is 12,808,300.
-   `stats.all_time` counts 47,615,526 trades since `first_trade_ts` 1783530660000, with per-window volume and traders from `1s` to `24h`: numbers an RPC can’t give you without indexing every swap.

[Pool detail reference](https://docs.crius.sh/reference/pools/pool-detail/) Runs from your browser on the anonymous plan [Data looks wrong? Report it](mailto:support@crius.sh?subject=Wrong%20data%20in%20docs%20example%3A%20The%20WETH%2FUSDG%20Uniswap%20v3%20pool%2C%20decoded&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Fguides%2Fmigrate-from-rpc-to-crius%2F%23pool%0ARequest%3A%20GET%20%2Fv1%2Frobinhood%2Fpool%2F0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)

```js
// Before: WETH price from slot0 over JSON-RPC (the public RPC is shared and rate limited: use a provider in production)
const RPC = "https://rpc.mainnet.chain.robinhood.com";
const POOL = "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca"; // Uniswap v3 WETH/USDG, 0.01%
const rpc = await fetch(RPC, {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_call", params: [{ to: POOL, data: "0x3850c7bd" }, "latest"] }), // slot0()
});
const sqrtPriceX96 = BigInt("0x" + (await rpc.json()).result.slice(2, 66));
// token1 per token0, adjusted for WETH's 18 and USDG's 6 decimals (you must already know them)
console.log("slot0:", Number((sqrtPriceX96 * sqrtPriceX96 * 10n ** 12n * 10n ** 6n) >> 192n) / 1e6);

// After: the same price, plus reserves, TVL and volume, in one call
const { data } = await (await fetch(`https://api.crius.sh/v1/robinhood/pool/${POOL}`)).json();
console.log("crius:", data.state.price_0_in_1, "tvl", data.tvl_usd, "24h volume", data.stats.volume_usd["24h"]);
```

For the sample above, the slot0 math gives 2357.316, the same as `price_0_in_1`. The difference is everything around it: that’s one pool type, one pool, at the latest block. A token’s USD price needs its deepest pool, the quote’s own USD route and a check that the pool isn’t too thin, which `/token/{address}/price` does in one call.

## Swap logs: what decoding gives you

Example [Anonymous · no key · 2 credits](https://docs.crius.sh/reference/trades/trade-tape/)

### Three WETH trades, already attributed

What does the decoded version of a Swap log look like?

GET/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3

  

**cURL**

```bash
curl "https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3"
```

**JavaScript**

```js
const res = await fetch("https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3");
const { data, meta } = await res.json();
```

**Python**

```python
import requests

r = requests.get(
    "https://api.crius.sh/v1/robinhood/token/0x0bd7d308f8e1639fab988df18a8011f41eacad73/trades?limit=3",
)
body = r.json()
print(body["data"])
```

**Real response 200 Captured Oct 28, 2026 · 144 lines (arrays trimmed)**

```json
{
  "data": [
    {
      "amount_base": 0.241346083005198446,
      "amount_quote": 569.019791,
      "block": 100406784,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.021,
          "gas_used": 239930,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.00000503853,
          "total_eth": 0.00000503853,
          "usd": 0.0118753
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406784-6-44",
      "market_cap_usd_at_trade": 90494155,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00034,
      "price_usd": 2357.69,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0xe950337f36e45c316c53c69a5f285487b54f0bad",
      "signer_label": null,
      "trader": "0xe950337f36e45c316c53c69a5f285487b54f0bad",
      "trader_app": null,
      "trader_label": "fomo_relayer_3",
      "ts": 1793225076000,
      "tx": "0x5b474612139f91cb226cf9e5097244dbb896a86834d8adbd263641c96d67b9f7",
      "tx_index": 6,
      "type": "buy",
      "value_eth": 0.241428,
      "value_usd": 569.02,
      "via": []
    },
    {
      "amount_base": 0.021222351350879784,
      "amount_quote": 50.025498,
      "block": 100406784,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.021,
          "gas_used": 455557,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.0000095667,
          "total_eth": 0.0000095667,
          "usd": 0.0225477
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406784-1-12",
      "market_cap_usd_at_trade": 90475571,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00013,
      "price_usd": 2357.21,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0x800539138ff0510191277f6b5c58fb94ae700064",
      "signer_label": null,
      "trader": "0x800539138ff0510191277f6b5c58fb94ae700064",
      "trader_app": null,
      "trader_label": null,
      "ts": 1793225076000,
      "tx": "0x0bde8abf03edce0f2ba13a3398ec2575b177c3f2d85eef77c25c7899a9949311",
      "tx_index": 1,
      "type": "sell",
      "value_eth": 0.0212252,
      "value_usd": 50.0255,
      "via": [
        "uniswap_universal_router"
      ]
    },
    {
      "amount_base": 0.011210844980975568,
      "amount_quote": 26.431588,
      "block": 100406782,
      "dex": "uniswap_v3",
      "eth_usd_at_trade": 2356.9,
      "executor": null,
      "fees": {
        "gas": {
          "gas_price_gwei": 0.020904,
          "gas_used": 315171,
          "gas_used_l1": 0,
          "l1_eth": 0,
          "l2_eth": 0.00000658833,
          "total_eth": 0.00000658833,
          "usd": 0.015528
        },
        "token_tax": {
          "pct": null
        }
      },
      "finality": "latest",
      "id": "100406782-10-32",
      "market_cap_usd_at_trade": 90493695,
      "pool": "0x52e65b17fb6e5ba00ed806f37afcd2daa50271ca",
      "price_eth": 1.00033,
      "price_usd": 2357.68,
      "quote": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
      "quote_symbol": "USDG",
      "signer": "0x8a2a3d6fcefd9427ac46b07c91d21207aaa0e168",
      "signer_label": null,
      "trader": "0x8a2a3d6fcefd9427ac46b07c91d21207aaa0e168",
      "trader_app": null,
      "trader_label": null,
      "ts": 1793225076000,
      "tx": "0xa3a9ddaaa96d7cc4d300eb5ae37d174755cee56aec3e5e15ae7c3adf437a113b",
      "tx_index": 10,
      "type": "buy",
      "value_eth": 0.0112146,
      "value_usd": 26.4316,
      "via": [
        "gmgn_swap_router"
      ]
    }
  ],
  "meta": {
    "block": 100406789,
    "block_age_ms": 367,
    "block_ts": 1793225077000,
    "chain": "robinhood",
    "finalized_block": 100397649,
    "lag_ms": 7,
    "next_cursor": "100406782-32",
    "safe_block": 100401329
  }
}
```

What this tells you

-   Each trade has a `type`, amounts in human units (`amount_base` 0.241346083005198446 WETH for `amount_quote` 569.019791 USDG), `price_usd` and `value_usd`: no `int256` deltas or `sqrtPriceX96` to convert.
-   `trader` is the wallet whose balance changed. The routing is reported separately: `via: ["uniswap_universal_router"]` and `via: ["gmgn_swap_router"]`, and `trader_label: "fomo_relayer_3"` names known infrastructure.
-   `fees.gas` gives the L2 and L1 cost in ETH and USD (`usd` 0.0118753 for the first trade), and `finality: "latest"` says the block isn’t safe yet.
-   `id` (`100406784-6-44`) is block, transaction index and log index, so trades join with logs you already store.

[Trade tape reference](https://docs.crius.sh/reference/trades/trade-tape/) Runs from your browser on the anonymous plan [Data looks wrong? Report it](mailto:support@crius.sh?subject=Wrong%20data%20in%20docs%20example%3A%20Three%20WETH%20trades%2C%20already%20attributed&body=Page%3A%20https%3A%2F%2Fdocs.crius.sh%2Fguides%2Fmigrate-from-rpc-to-crius%2F%23trades%0ARequest%3A%20GET%20%2Fv1%2Frobinhood%2Ftoken%2F0x0bd7d308f8e1639fab988df18a8011f41eacad73%2Ftrades%3Flimit%3D3%0A%0AWhat's%20wrong%20or%20missing%3F%0A%0A)

## Plan the move

1.  **List your reads.** Group the RPC calls in your app by the question they answer (price, trades, holders, metadata, risk). Each group maps to a row of the table above.
    
2.  **Start with the expensive ones.** Log scans and transfer replays cost the most to run yourself: Robinhood Chain makes a block about every 100 ms and has passed 100 million blocks, so a full backfill over a shared RPC endpoint can take weeks. Replace those first.
    
3.  **Swap subscriptions for the stream.** `eth_subscribe` gives you logs with no replay. The Crius stream adds per-channel `seq` numbers, a 60-second resume buffer and explicit reorg messages ([trades stream guide](https://docs.crius.sh/guides/stream-trades-websocket/)).
    
4.  **Keep identifiers.** Addresses are lowercase hex, v4 pools are 32-byte pool ids, trade ids are `block-tx-log`, amounts are human units and timestamps unix milliseconds ([conventions](https://docs.crius.sh/conventions/)).
    

Plans and costs

Trades, candles, prices, pools, token profiles, batch calls and security are on the anonymous plan (2 requests per second without a key; 1–2 credits each with one). Holders need a Free key (2 credits), holder snapshots at past blocks 5. Credits per endpoint are on [Plans & limits](https://docs.crius.sh/plans-and-limits/).

## Frequently asked questions

**Do I still need an RPC provider if I use Crius?**

Only to write to the chain or to read data no index models (your own contracts' state, eth\_call simulations of your transactions, gas estimates, nonces). Crius is a read-only API and doesn't relay transactions.

**Is an indexed API slower than calling the RPC myself?**

An indexer decodes a block before serving it, so there is a small delay. Crius streams events as each block is decoded, typically well under a second after the block, and every REST response reports `meta.block`, `meta.lag_ms` and the safe and finalized blocks.

**How do reorgs work after migrating?**

Every trade carries `finality` (`latest`, `safe`, `finalized`) and every response `meta.safe_block` and `meta.finalized_block`. The stream sends a `reorg` message and re-sends affected events with `removed: true`, or holds events until `safe` if you subscribe with `"finality": "safe"`. See [Finality](https://docs.crius.sh/concepts/finality/).

**Can I migrate gradually?**

Yes. Trade `id`s (`block-tx-log`) and pool keys (v2/v3 address, v4 pool id) are the chain's own identifiers, so Crius data joins with what you already store. Move one read path at a time and compare.

## Related

[Concept **Robinhood Chain** 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. Read](https://docs.crius.sh/concepts/robinhood-chain/) [Concept **Finality & reorgs** Finality levels on Robinhood Chain (latest, safe, finalized), how the Crius API marks them, and how chain reorganizations are handled in REST and WebSocket. Read](https://docs.crius.sh/concepts/finality/) [Concept **Trader attribution & wallet tags** How Crius attributes Robinhood Chain trades to the real trader behind routers, aggregators, bundlers and bot contracts, and what each wallet tag means. Read](https://docs.crius.sh/concepts/attribution/) [Guide **Token trades** Get every buy and sell of a Robinhood Chain token with USD value, price, gas, tax and the real trader behind routers and smart wallets. Real examples, no key. Read](https://docs.crius.sh/guides/get-token-trades/) [Guide **Token holders** Robinhood Chain token holders API: get any token's top holders in one call, with balance, share of supply, USD value, labels, holder count and top-10 share. Read](https://docs.crius.sh/guides/get-token-holders/) [API reference **WebSocket stream** 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. Read](https://docs.crius.sh/reference/stream/)