Robinhood Chain Examples

14 small, runnable projects for Robinhood Chain (mainnet 4663 / testnet 46630) — from a raw viem read to a live dashboard, a Telegram bot, and a paper trader. Every read below is real.

Example 07, running live — client-side JSON-RPC, no backend. How it works →

Which package do I need?

You want to…	Use	Try
Read one price, no dependency	`viem` only	Example 01
Read prices / portfolios in a Node script	`hoodchain`	Examples 02, 03
Ship a static page with live prices	`hoodchain`-derived raw RPC (no build step)	Example 07
Build a React app	`hoodchain` + a local hook (hoodkit not shipped yet)	Example 08
Trade or launch on-chain	`hoodchain`'s `swap` / `launchpads` modules	Examples 04, 05, 14
Charge or pay for an API call	`hood402` (not shipped yet)	Examples 09, 10
Give an LLM agent chain tools	`hood-mcp` (not shipped yet)	Example 11

All examples

Read a stock price

viem only, no SDK

Robinhood Chain is a normal EVM L2 — viem ships its chain def, Chainlink feeds are a plain readContract.

Stock price with the SDK

hoodchain basics

hoodchain collapses example 01 to 3 lines and covers all 95 registry tokens.

Portfolio valuation

ERC-8056 multiplier math

The correct way to value Stock Token holdings without double-counting corporate actions.

Uniswap v3 quote + execute

One code path quotes and (with a funded key) executes swaps on testnet and mainnet alike.

NOXA + Odyssey event streams

Two different launchpad contract shapes decode into one Launch type.

Sequencer firehose

Raw Nitro feed decoding

Transactions are visible ~100–300ms before they hit RPC, straight off the public feed socket.

Live price webpage

Client-side JSON-RPC

Read-only chain calls work from a static page — no backend, no build step, live on this gallery below.

Portfolio dashboard

React + polling hook

A production-shaped dashboard (loading/empty/error states) is a thin wrapper over example 03.

Pay for an API call

Blocked on: hood-api, hood402 (not built yet — see the README for the gap).

x402 server middleware

Blocked on: hood402 (not built yet — see the README for the gap).

MCP agent session

Model Context Protocol

Blocked on: hood-mcp (not built yet — see the README for the gap).

Telegram price bot

grammY + hoodchain

A full user-facing bot is ~70 lines once the SDK does the chain work.

Launch a coin (testnet)

Launchpad direct rail

Blocked on: hood-launcher (not built yet — see the README for the gap).

Agent paper trader

Strategy loop, simulated

A strategy loop is just getQuote on a timer — real execution slots in later without a rewrite.