Robinhood Chain stock tokens: reading the multiplier, holders and daily activity with one API key

Robinhood Chain supports tokenized real-world assets (RWAs), including tokenized US equities and exchange-traded funds (ETFs). While standard ERC-20 tokens map balances 1:1, tokenized stocks introduce a corporate-action multiplier to accommodate stock splits and dividend adjustments without changing wallet balances.

This guide explains how the stock token multiplier operates, how to convert raw token balances into underlying share counts, how to query uiMultiplier on-chain using JSON-RPC eth_call, and how to retrieve daily holders and transfer activity through the BlockVectra Data API.

For broad network parameters, method policies, and RPC setup, see the Robinhood Chain guide. For comprehensive field references and Compute Unit (CU) usage models for the dataset, see the Tokenized stocks guide.

What is the stock token multiplier

Robinhood stock tokens are standard ERC-20 tokens (with 18 decimals) issued by Robinhood Assets (Jersey) Limited (RHJ). To handle corporate actions such as stock splits and reinvested dividends, these contracts implement ERC-8056 (Scaled UI Amount Extension).

The multiplier (uiMultiplier) defines the shares-per-token ratio:

• Precision: uiMultiplier() is represented as an 18-decimal fixed-point number, where 1e18 equals 1.0.
• Initial value: At token issuance, the multiplier is initialized to 1e18 (one token represents one underlying share).
• Corporate actions: When a corporate event takes place (such as a forward stock split or a reinvested dividend), the token contract updates uiMultiplier and emits the UIMultiplierUpdated(uint256 oldMultiplier, uint256 newMultiplier, uint256 effectiveAtTimestamp) event.

Fixed token balances during splits

Stock tokens are not rebasing tokens. During corporate actions:

• Wallet balances (balanceOf(account)) and total token issuance (totalSupply()) remain unchanged.
• Only the scaling multiplier changes.

For example, if an underlying stock executes a 2-for-1 forward split:

• A holder who owns 10 tokens continues to hold 10 tokens in balanceOf.
• The contract updates uiMultiplier from 1.0 (1e18) to 2.0 (2e18).
• Each token now represents 2 underlying shares, giving the holder an effective exposure of 20 shares.

Converting balances to share count

To compute the number of underlying shares represented by a token balance, use the ERC-8056 formula:

underlying shares = raw token amount × uiMultiplier ÷ 1e18

ERC-8056 token contracts also expose read-only helper functions on-chain:

• balanceOfUI(address account): Directly returns the account's balance expressed in underlying shares (scaled by uiMultiplier, 18 decimals).
• totalSupplyUI(): Directly returns the total token supply expressed in underlying shares.

In addition, token transfers emit the TransferWithScaledUI(address indexed from, address indexed to, uint256 value, uint256 uiValue) event, recording both the raw token amount and the scaled underlying-share count.

Multiplier and oracle price feeds

Robinhood Chain deploys a dedicated Chainlink price feed (AggregatorV3Interface) for each stock token:

• The Chainlink price feed (latestRoundData()) already incorporates the multiplier. It reflects the full market price of one token (underlying share price multiplied by the multiplier).
• Applications reading the on-chain Chainlink oracle receive the multiplier-adjusted price directly and must not apply the multiplier a second time.
• Off-chain metadata can also be checked via Robinhood's REST endpoint GET https://api.robinhood.com/rhj/assets, which provides currentMultiplier and pendingMultiplier.

Reading the multiplier with JSON-RPC eth_call

You can inspect the multiplier of any tokenized stock directly via BlockVectra's JSON-RPC endpoint for Robinhood Chain using eth_call.

• Function: uiMultiplier()
• 4-byte function selector: 0xa60bf13d (bytes4(keccak256("uiMultiplier()")))
• Return format: 32-byte hex-encoded uint256 (18-decimal fixed-point value)

BlockVectra serves Robinhood Chain JSON-RPC requests under https://api.blockvectra.com/v1/robinhood_mainnet. Pass your API key via the x-api-key header or append it to the path (https://api.blockvectra.com/v1/robinhood_mainnet/{api_key}).

Code examples

The examples below query uiMultiplier() on the Everpure stock token contract (0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D):

curl -s "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_call",
    "params": [
      {
        "to": "0x1Cdad396DB64BDa184d5182A97Dd9B3C62100b7D",
        "data": "0xa60bf13d"
      },
      "latest"
    ]
  }'

Querying holders and daily activity with the Data API

The BlockVectra Data API provides pre-indexed daily summaries for tokenized stocks. Use GET /v1/data/robinhood_mainnet/stocks for the daily activity leaderboard and GET /v1/data/robinhood_mainnet/stocks/{token} for one token's metadata and up to 30 days of daily metrics. For request parameters, response fields, and examples, see the Tokenized stocks guide.

Regulatory notes

Stock tokens are tokenised debt securities issued by Robinhood Assets (Jersey) Limited (RHJ). See the Robinhood RHJ documentation for prospectuses, final terms, and jurisdictional notices.

Next steps

• Browse the datasets directory to see every dataset BlockVectra indexes.
• See the free plan and pricing to check what your account includes.
• Log in to the console to create an API key.