RobinhoodRPCDocs

Instruments

Every tokenized equity on Robinhood Chain, with its contract, multiplier and tradability.

What an instrument is

An instrument is a tokenized equity or ETF deployed on Robinhood Chain — an ERC-20 with 18 decimals extended by ERC-8056, the Scaled UI Amount Extension. There are more than 200, covering US stocks and exchange-traded products.

Robinhood publishes the canonical registry free and unauthenticated at api.robinhood.com/rhj/assets. We consume it, reconcile it against onchain state, and serve it with the multiplier history that the REST endpoint does not carry.

Fields

FieldTypeDescription
idstringRobinhood onchain uid: 0x plus 66 lowercase hex characters.
token_symbolstringFor example AAPL. No X prefix.
underlying_symbolstringThe underlying equity ticker.Usually equal to token_symbol, but not guaranteed across name changes and mergers.
deployments[]Deployment[]Contract address and EIP-155 chain id per chain.
current_multiplierdecimalShares per token, 18 decimals.
pending_multiplierdecimal?Set when a change is scheduled but not yet effective.
pending_multiplier_effective_attimestamp?When the pending change takes effect.
trading_capabilitiesobjectfractional, all_day and extended_hours_fractional, each tradable / untradable / position_closing_only / position_opening_only.
statusenumACTIVE or INACTIVE.

Request

curl -s https://api.robinhoodrpc.io/v1/instruments \  -H "Authorization: Bearer $RHRPC_KEY" \  | jq '.instruments[] | select(.token_symbol == "AAPL")'

Correctness

Correctness note

An instrument's current_multiplier is only correct as of now. Valuing anything historical requires the multiplier at that block — see /docs/equities/multipliers. Reading current_multiplier and applying it to a past balance is the single most common error on this chain.

Related

MultipliersThe multiplier series, indexed by blockCorporate actionsAll 13 action types and their lifecycle