Requires the Stock Token API add-on on Robinhood Chain mainnet. See additional details below or the full overview.
Parameters
- optionsobject
Optional filters and read options. Unknown keys are rejected with -32602.
- symbolsarray
Case-insensitive stock tickers. Unknown tickers are skipped. Omit to use all tokens or registered feeds.
- addressesarray
Stock token contract addresses. Combined with symbols using OR. Non-stock-token addresses return -32001.
- includeInactiveboolean
Include delisted tokens. Defaults to false.
- blockTagstring
Block to read: a hex block number, block hash, latest (default), safe, or finalized. All on-chain reads use this one block.
Returns
- resultobject
The stock token API result at the reported block.
- blockNumberstring
Snapshot block number in hexadecimal. Nested event block numbers are integers.
- blockHashstring
Hash of the snapshot block.
- tokensarray
One entry per token, sorted by symbol.
- addressstring
Checksummed stock token contract address.
- symbolstring
Stock ticker or priced asset symbol.
- namestring or null
Display name.
nullif Robinhood has no entry for the token (someINACTIVEtokens). May be null when unavailable or not applicable.
- decimalsinteger
Always 18 for stock tokens.
- statusstring
ACTIVE, orINACTIVEfor a token Robinhood dropped from its list (only withincludeInactive).
- uiMultiplierstring
Current multiplier, scaled by 10^18.
4000000000000000000= 4.0.
- uiMultiplierDecimalstring
The multiplier as a decimal string.
- pendingobject or null
Scheduled multiplier change, or null when no change is pending.
- uiMultiplierstring
Scheduled multiplier scaled by 10^18.
- uiMultiplierDecimalstring
Scheduled multiplier as a decimal string.
- effectiveAtinteger
Unix seconds when the change takes effect.
- effectiveAtIsostring
The effective time in ISO 8601 format.
- oraclePausedboolean
truewhile Robinhood has paused the token's price feed, usually around a corporate action. The feed holds its last price until unpaused.
- priceFeedstring or null
The token's Chainlink price feed (proxy address), or
nullif it has none. Feed coverage varies by token. May be null when unavailable or not applicable.
- totalSupplyRawstring
Total supply in raw units (18 decimals).
- totalSupplyUistring
Total supply in shares (18 decimals): raw × multiplier / 10^18.
- totalSupplyUiDecimalstring
Total supply in shares, as a decimal string.
- firstBlockinteger
The block where the token first appears (its deployment).
- tradingCapabilitiesobject or null
Whether the stock trades on Robinhood in each session (
market= 09:30–16:00 ET,extended= pre- and after-hours,overnight), forwholeandfractionalshares:TRADING_STATUS_TRADABLEorTRADING_STATUS_UNTRADABLE. May be null when unavailable or not applicable.- marketobject
Regular-session trading capabilities.
- wholestring
Whole-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- fractionalstring
Fractional-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- extendedobject
Pre-market and post-market trading capabilities.
- wholestring
Whole-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- fractionalstring
Fractional-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- overnightobject
Overnight-session trading capabilities.
- wholestring
Whole-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- fractionalstring
Fractional-share trading status: TRADING_STATUS_TRADABLE or TRADING_STATUS_UNTRADABLE.
- referenceObservedAtinteger
When
nameandtradingCapabilitieswere fetched from Robinhood (Unix seconds).
- warningsarray
Warning code strings describing partial data or unavailable signals; empty when there are no warnings.
1{2"jsonrpc": "2.0",3"id": 1,4"result": {5"blockNumber": "0x5b9ec07",6"blockHash": "0x952998db38778ebb03eaee447eed56f9e22989a5290b0cb9532d98d397d01aeb",7"tokens": [8{9"address": "0xea72Ecca2d0f6bFA1394DBBCff85b52CD4233931",10"symbol": "CRWD",11"name": "CrowdStrike Holdings • Robinhood Token",12"decimals": 18,13"status": "ACTIVE",14"uiMultiplier": "4000000000000000000",15"uiMultiplierDecimal": "4.0",16"pending": null,17"oraclePaused": false,18"priceFeed": null,19"totalSupplyRaw": "11058495000000000000",20"totalSupplyUi": "44233980000000000000",21"totalSupplyUiDecimal": "44.23398",22"firstBlock": 48228,23"tradingCapabilities": {24"market": {25"whole": "TRADING_STATUS_TRADABLE",26"fractional": "TRADING_STATUS_TRADABLE"27},28"extended": {29"whole": "TRADING_STATUS_TRADABLE",30"fractional": "TRADING_STATUS_TRADABLE"31},32"overnight": {33"whole": "TRADING_STATUS_TRADABLE",34"fractional": "TRADING_STATUS_TRADABLE"35}36},37"referenceObservedAt": 179277180138},39{40"address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",41"symbol": "NVDA",42"name": "NVIDIA • Robinhood Token",43"decimals": 18,44"status": "ACTIVE",45"uiMultiplier": "1000775159164630595",46"uiMultiplierDecimal": "1.000775159164630595",47"pending": null,48"oraclePaused": false,49"priceFeed": "0x379EC4f7C378F34a1B47E4F3cbeBCbAC3E8E9F15",50"totalSupplyRaw": "87680062585910000000000",51"totalSupplyUi": "87748028589978852282845",52"totalSupplyUiDecimal": "87748.028589978852282845",53"firstBlock": 45898,54"tradingCapabilities": {55"market": {56"whole": "TRADING_STATUS_TRADABLE",57"fractional": "TRADING_STATUS_TRADABLE"58},59"extended": {60"whole": "TRADING_STATUS_TRADABLE",61"fractional": "TRADING_STATUS_TRADABLE"62},63"overnight": {64"whole": "TRADING_STATUS_TRADABLE",65"fractional": "TRADING_STATUS_TRADABLE"66}67},68"referenceObservedAt": 179277180169}70],71"warnings": []72}73}
1{2"jsonrpc": "2.0",3"id": 1,4"result": {5"blockNumber": "0x5b9ec07",6"blockHash": "0x952998db38778ebb03eaee447eed56f9e22989a5290b0cb9532d98d397d01aeb",7"tokens": [8{9"address": "0xea72Ecca2d0f6bFA1394DBBCff85b52CD4233931",10"symbol": "CRWD",11"name": "CrowdStrike Holdings • Robinhood Token",12"decimals": 18,13"status": "ACTIVE",14"uiMultiplier": "4000000000000000000",15"uiMultiplierDecimal": "4.0",16"pending": null,17"oraclePaused": false,18"priceFeed": null,19"totalSupplyRaw": "11058495000000000000",20"totalSupplyUi": "44233980000000000000",21"totalSupplyUiDecimal": "44.23398",22"firstBlock": 48228,23"tradingCapabilities": {24"market": {25"whole": "TRADING_STATUS_TRADABLE",26"fractional": "TRADING_STATUS_TRADABLE"27},28"extended": {29"whole": "TRADING_STATUS_TRADABLE",30"fractional": "TRADING_STATUS_TRADABLE"31},32"overnight": {33"whole": "TRADING_STATUS_TRADABLE",34"fractional": "TRADING_STATUS_TRADABLE"35}36},37"referenceObservedAt": 179277180138},39{40"address": "0xd0601CE157Db5bdC3162BbaC2a2C8aF5320D9EEC",41"symbol": "NVDA",42"name": "NVIDIA • Robinhood Token",43"decimals": 18,44"status": "ACTIVE",45"uiMultiplier": "1000775159164630595",46"uiMultiplierDecimal": "1.000775159164630595",47"pending": null,48"oraclePaused": false,49"priceFeed": "0x379EC4f7C378F34a1B47E4F3cbeBCbAC3E8E9F15",50"totalSupplyRaw": "87680062585910000000000",51"totalSupplyUi": "87748028589978852282845",52"totalSupplyUiDecimal": "87748.028589978852282845",53"firstBlock": 45898,54"tradingCapabilities": {55"market": {56"whole": "TRADING_STATUS_TRADABLE",57"fractional": "TRADING_STATUS_TRADABLE"58},59"extended": {60"whole": "TRADING_STATUS_TRADABLE",61"fractional": "TRADING_STATUS_TRADABLE"62},63"overnight": {64"whole": "TRADING_STATUS_TRADABLE",65"fractional": "TRADING_STATUS_TRADABLE"66}67},68"referenceObservedAt": 179277180169}70],71"warnings": []72}73}
Additional details
This method returns all official Robinhood stock tokens with their current multiplier, supply, price feed status, and trading capabilities. Robinhood-sourced fields (name, tradingCapabilities) show the latest values even when reading a historical block.
Warnings
The warnings array may include:
| Warning | Meaning |
|---|---|
READ_FAILED:<SYMBOL> | Token read failed at this block; omitted from response. |
MULTIPLIER_NOT_APPLIED:<SYMBOL> | Scheduled change passed but contract still reports old multiplier. |
RH_DATA_STALE | Robinhood data is over 30 minutes old. |
RH_DATA_UNAVAILABLE | name and tradingCapabilities are null; data missing or over 24 hours old. |
Errors
| Code | When |
|---|---|
-32001 | An address in addresses is not a stock token. |
-32002 | blockTag is ahead of the chain head. |
-32602 | Unknown option, malformed address, or invalid blockTag. |
See the overview for setup, conventions, and all error codes.