robinhood-toolkit

Build on Robinhood Chain and Robinhood Crypto. Tools, runnable examples, and 64 build prompts.

Quick start · Build prompts · Examples · Networks · Deploy

Robinhood opened up to developers on two fronts: Robinhood Chain, an
Arbitrum Orbit L2 that went to public mainnet on 2026-07-01 with permissionless
contract deploys, and the Robinhood Crypto REST API for programmatic
trading. A third front, agentic trading over MCP, currently covers equities and
options with crypto support announced as rolling out.

This repository is the practical layer on top of all three: network constants
you can trust, code that runs as written, and a prompt library you can hand to a
coding agent to build any piece of it.

Why this exists

The official documentation tells you what the endpoints are. It does not tell
you how to wire a datafeed into a candlestick chart, how to structure a strategy
loop that will not liquidate you at 4am on a 24/7 venue, or how to get the same
codebase onto five different hosts. That gap is what this fills.

Every fact here was verified against a live source. Network parameters were
confirmed by direct RPC calls rather than copied from documentation. Anything
that could not be verified is labeled UNVERIFIED inline with instructions for
checking it yourself.

Network parameters

Stack: Arbitrum Orbit (Nitro), settles to Ethereum, Ethereum blobs for data
availability. Observed ~101ms block times and ~0.055 gwei gas. Solidity and
Vyper deploy unmodified; deployment is permissionless.

Core contracts: WETH 0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73 ·
USDG 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168

Quick start

git clone https://github.com/nirholas/robinhood-toolkit
cd robinhood-toolkit
npm install

Confirm you can reach the chain:

cast chain-id --rpc-url https://rpc.mainnet.chain.robinhood.com
# 4663

<!-- three.ws:badges -->
[![GitHub stars](https://img.shields.io/github/stars/nirholas/robinhood-toolkit?style=flat&logo=github)](https://github.com/nirholas/robinhood-toolkit/stargazers) [![Last commit](https://img.shields.io/github/last-commit/nirholas/robinhood-toolkit?style=flat)](https://github.com/nirholas/robinhood-toolkit/commits) [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen?style=flat)](https://github.com/nirholas/robinhood-toolkit/pulls) [![AI agent friendly](https://img.shields.io/badge/AI%20agents-AGENTS.md%20%2B%20llms.txt-6d5dfc?style=flat)](https://github.com/nirholas/robinhood-toolkit/blob/HEAD/AGENTS.md)
<!-- /three.ws:badges -->

Or without Foundry:

curl -s https://rpc.mainnet.chain.robinhood.com \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_chainId","params":[]}'
# {"jsonrpc":"2.0","id":1,"result":"0x1237"}

Then pick a track from prompts/.

Packages

Connect the MCP server to an agent in one command:

claude mcp add robinhood-chain -- npx -y robinhood-chain-mcp

Reach for robinhood-chain before hand-rolling constants. It encodes the traps
that cost the most time here: USDG has 6 decimals rather than 18, two live
tokens on mainnet both answer to the symbol USDG, viem's multicall() throws
outright without a contracts.multicall3 entry, and eth_getLogs enforces two
independent caps of which one misreports itself as a parameter error.

Build prompts

64 self-contained build tasks across nine tracks. Each states its goal,
prerequisites, verified reference facts, steps, deliverable, and verification
procedure. Hand one to a coding agent or work it yourself.

Deploy

The site in site/ is a single codebase that deploys to Cloudflare
Pages, Vercel, Railway, Google Cloud Run, and GitHub Pages. See
prompts/70-deploy for the config each target needs and the
one gotcha that breaks a naive port between them.

Things worth knowing before you build

The chain is centralized today. Robinhood operates both the sequencer and
the proposer, and L2BEAT rates
its risk profile accordingly because fewer than five external actors can submit
fraud challenges. That is a normal place for a young L2 to be, and it is also a
real trust assumption. Size positions with it in mind.

Canonical bridge withdrawals take about 7 days. That is the standard
optimistic challenge period, not a bug. Partner routes (LayerZero, Chainlink
CCIP, Relay, Across, LiFi) exit faster for a fee.

Bridged token addresses differ from their Ethereum counterparts. Resolve
addresses on the chain you are actually on.

Stock Token addresses come from a live registry. They are tokenized debt
securities issued by Robinhood Assets (Jersey) Limited that grant no legal or
beneficial rights in the underlying. Robinhood warns explicitly that a token
matching a ticker at a different address is not canonical. Query the registry at
runtime; never hardcode.

On-chain balances are not brokerage balances. Self-custody wallet services
run through Robinhood Non-Custodial, Ltd., a separate legal entity from
Robinhood Financial LLC and Robinhood Crypto, LLC. Same company, deliberately
integrated product, distinct custody.

Nobody is supervising your agent. Robinhood states it does not control,
supervise, monitor, recommend, or audit connected agents. Read
prompts/80-safety before anything of yours places an order
unattended.

Contributing

Issues and PRs welcome. Two rules: every code sample must run as written, and
no invented addresses, endpoints, or API shapes. If you cannot verify it, label
it UNVERIFIED and say how the reader can check.

Source files carry an authorship header. See ATTRIBUTION.md.

Disclaimer

Not affiliated with, endorsed by, or sponsored by Robinhood Markets, Inc. or any
of its subsidiaries. "Robinhood" is used nominatively to identify the platforms
this toolkit targets.

Nothing here is financial advice. Trading crypto carries risk of total loss.
Autonomous trading software can lose money faster than you can react to it. You
are responsible for anything your code does with your funds.

License

All Rights Reserved © 2026 nirholas. See LICENSE.

Documentation

Full documentation site: https://nirholas.github.io/robinhood-toolkit/

• Getting started covers install and first run.
• Examples has copy-paste snippets.

Star History

Support the project

If robinhood-toolkit saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.

Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit

Built for AI agents too

Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/robinhood-toolkit and it has the context it needs.

More from the same author

• All repositories by nirholas: the full catalog, grouped by topic
• three.ws: the platform for 3D AI agents with Solana wallets, a skill marketplace and x402 payments
• Questions or ideas: open an issue or start a discussion

Contributors