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.
- fromTimeinteger
Inclusive lower effectiveAt bound in Unix seconds; must be nonnegative.
- toTimeinteger
Inclusive upper effectiveAt bound in Unix seconds; must be at least fromTime.
- includeScheduledboolean
Include pending changes without an announced event. Defaults to true. Announced future actions are returned even when false.
- limitinteger
Page size from 1 to 1000; defaults to 100.
- cursorstring
Opaque nextCursor from the previous page. Omit for the first page.
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.
- actionsarray
Sorted by
effectiveAt, newest first, then by token address.- tokenstring
Stock token contract address.
- symbolstring
Stock ticker or priced asset symbol.
- typestring
What the action was:
CASH_DIVIDEND,FORWARD_SPLIT,REVERSE_SPLIT, another Robinhood type, orUNKNOWN. See Action types.
- typeSourcestring
Where
typecame from:ROBINHOOD(its matching record),INFERRED(fromratio) orNONE(typeisUNKNOWN).
- statusstring
EFFECTIVE(in force),SCHEDULED(announced,effectiveAtstill ahead) orRESCHEDULED(replaced by a later schedule with a different time).
- oldMultiplierstring
The multiplier before and after, 10^18 scale.
- newMultiplierstring
The multiplier before and after, 10^18 scale.
- ratiostring
Multiplier ratio,
newMultiplier / oldMultiplier, as a decimal string rounded down to 18 decimal places. For example,4.0represents a 4-for-1 split.
- effectiveAtinteger
When the new multiplier applies (Unix seconds and ISO 8601).
- effectiveAtIsostring
When the new multiplier applies (Unix seconds and ISO 8601).
- eventsarray
The on-chain
UIMultiplierUpdatedevents behind the action (block and transaction). Robinhood sometimes emits the same change twice; CRWD's split has two events but is one action.[]for a pending change no event has announced yet.- blockNumberinteger
Block containing the multiplier-update event, as a decimal integer.
- txHashstring
Hash of the transaction.
- supersededarray or null
Earlier values for the same token and
effectiveAtthat a later event replaced, each with its ownevents.nullor[]when nothing was replaced. May be null when unavailable or not applicable.- oldMultiplierstring
Earlier multiplier before the replaced change, scaled by 10^18.
- newMultiplierstring
Earlier multiplier after the replaced change, scaled by 10^18.
- eventsarray
Events announcing the replaced change.
- blockNumberinteger
Block containing the multiplier-update event, as a decimal integer.
- txHashstring
Hash of the transaction.
- matchstring
How Robinhood's records matched:
EXACT(one record),AMBIGUOUS(several) orNONE.
- robinhoodobject or null
The matching record when
matchisEXACT: Robinhood'sid,type,status,processDateanddetails(for a cash dividend, the per-sharerate). Otherwisenull. May be null when unavailable or not applicable.- idstring
Robinhood corporate action identifier.
- typestring
The type from the matched Robinhood record.
- statusstring
The status from the matched Robinhood record.
- processDatestring
Robinhood processing date in YYYY-MM-DD format.
- detailsobject
Action-specific Robinhood metadata. Fields vary by action type.
- cashDividendobject
Cash-dividend metadata, present for a matching cash-dividend record.
- ratestring
Cash dividend per underlying share as a decimal string.
- underlyingSymbolstring
Underlying stock ticker.
- nextCursorstring or null
Pass as
cursorfor the next page;nullon the last page. May be null when unavailable or not applicable.
- 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": "0x5b9ec0b",6"blockHash": "0x774ae99a2fdaef91caf90e53a4a3f8d2d95857d524ea5645f2fc5652f37fa4cc",7"actions": [8{9"token": "0x58FfE4a942d3885bAa22D7520691F611EF09e7AA",10"symbol": "TSM",11"type": "CASH_DIVIDEND",12"typeSource": "ROBINHOOD",13"status": "EFFECTIVE",14"oldMultiplier": "1001463024159690554",15"newMultiplier": "1002728577037771211",16"ratio": "1.001263704048526963",17"effectiveAt": 1791159151,18"effectiveAtIso": "2026-10-05T00:12:31Z",19"events": [20{21"blockNumber": 80347763,22"txHash": "0x3ec41fca900ab92c68ff37c424fe16f0840ccb64fd62d14b1a05172b27dae3fd"23}24],25"superseded": null,26"match": "EXACT",27"robinhood": {28"id": "0x000000000000000000000000000000002e890a0884474abd86ba66b19722e827",29"type": "CASH_DIVIDEND",30"status": "COMPLETED",31"processDate": "2026-10-08",32"details": {33"cashDividend": {34"rate": "0.866038",35"underlyingSymbol": "TSM"36}37}38}39},40{41"token": "0x58FfE4a942d3885bAa22D7520691F611EF09e7AA",42"symbol": "TSM",43"type": "CASH_DIVIDEND",44"typeSource": "INFERRED",45"status": "EFFECTIVE",46"oldMultiplier": "1000000000000000000",47"newMultiplier": "1001463024159690554",48"ratio": "1.001463024159690554",49"effectiveAt": 1789517433,50"effectiveAtIso": "2026-09-16T00:10:33Z",51"events": [52{53"blockNumber": 64062939,54"txHash": "0x53888b0500828784f8eb5e98b22e2becf1e5d9b00d4e48c26d0b440e08f34037"55}56],57"superseded": null,58"match": "NONE",59"robinhood": null60},61{62"token": "0xea72Ecca2d0f6bFA1394DBBCff85b52CD4233931",63"symbol": "CRWD",64"type": "FORWARD_SPLIT",65"typeSource": "INFERRED",66"status": "EFFECTIVE",67"oldMultiplier": "1000000000000000000",68"newMultiplier": "4000000000000000000",69"ratio": "4.0",70"effectiveAt": 1782999000,71"effectiveAtIso": "2026-07-02T13:30:00Z",72"events": [73{74"blockNumber": 978630,75"txHash": "0x07884f2f2440316a996ab3a9c0f8bce962ec872af6924745f5a04a9e9ac1d31f"76},77{78"blockNumber": 1231096,79"txHash": "0x5dbbb9524fc402fea6786eb5a5dd40205ce8c6e848fb313eecedf7e9395f5bf0"80}81],82"superseded": null,83"match": "NONE",84"robinhood": null85}86],87"nextCursor": null,88"warnings": []89}90}
1{2"jsonrpc": "2.0",3"id": 1,4"result": {5"blockNumber": "0x5b9ec0b",6"blockHash": "0x774ae99a2fdaef91caf90e53a4a3f8d2d95857d524ea5645f2fc5652f37fa4cc",7"actions": [8{9"token": "0x58FfE4a942d3885bAa22D7520691F611EF09e7AA",10"symbol": "TSM",11"type": "CASH_DIVIDEND",12"typeSource": "ROBINHOOD",13"status": "EFFECTIVE",14"oldMultiplier": "1001463024159690554",15"newMultiplier": "1002728577037771211",16"ratio": "1.001263704048526963",17"effectiveAt": 1791159151,18"effectiveAtIso": "2026-10-05T00:12:31Z",19"events": [20{21"blockNumber": 80347763,22"txHash": "0x3ec41fca900ab92c68ff37c424fe16f0840ccb64fd62d14b1a05172b27dae3fd"23}24],25"superseded": null,26"match": "EXACT",27"robinhood": {28"id": "0x000000000000000000000000000000002e890a0884474abd86ba66b19722e827",29"type": "CASH_DIVIDEND",30"status": "COMPLETED",31"processDate": "2026-10-08",32"details": {33"cashDividend": {34"rate": "0.866038",35"underlyingSymbol": "TSM"36}37}38}39},40{41"token": "0x58FfE4a942d3885bAa22D7520691F611EF09e7AA",42"symbol": "TSM",43"type": "CASH_DIVIDEND",44"typeSource": "INFERRED",45"status": "EFFECTIVE",46"oldMultiplier": "1000000000000000000",47"newMultiplier": "1001463024159690554",48"ratio": "1.001463024159690554",49"effectiveAt": 1789517433,50"effectiveAtIso": "2026-09-16T00:10:33Z",51"events": [52{53"blockNumber": 64062939,54"txHash": "0x53888b0500828784f8eb5e98b22e2becf1e5d9b00d4e48c26d0b440e08f34037"55}56],57"superseded": null,58"match": "NONE",59"robinhood": null60},61{62"token": "0xea72Ecca2d0f6bFA1394DBBCff85b52CD4233931",63"symbol": "CRWD",64"type": "FORWARD_SPLIT",65"typeSource": "INFERRED",66"status": "EFFECTIVE",67"oldMultiplier": "1000000000000000000",68"newMultiplier": "4000000000000000000",69"ratio": "4.0",70"effectiveAt": 1782999000,71"effectiveAtIso": "2026-07-02T13:30:00Z",72"events": [73{74"blockNumber": 978630,75"txHash": "0x07884f2f2440316a996ab3a9c0f8bce962ec872af6924745f5a04a9e9ac1d31f"76},77{78"blockNumber": 1231096,79"txHash": "0x5dbbb9524fc402fea6786eb5a5dd40205ce8c6e848fb313eecedf7e9395f5bf0"80}81],82"superseded": null,83"match": "NONE",84"robinhood": null85}86],87"nextCursor": null,88"warnings": []89}90}
Additional details
This method returns the history of stock token multiplier changes (splits, reinvested dividends) sorted by effectiveAt (newest first). Results are paginated—pass nextCursor as cursor to fetch the next page.
Action types
The chain records only that a multiplier changed, not why. When a Robinhood corporate action record matches (by token and process date within ±3 days), type comes from Robinhood and typeSource is ROBINHOOD. Otherwise the API infers type from ratio:
| Ratio | Inferred type |
|---|---|
Above 1 and at most 1.02 (e.g. 1.0012) | CASH_DIVIDEND — reinvested into the multiplier |
A whole number ≥ 2 (e.g. 4.0) | FORWARD_SPLIT (4-for-1) |
Exactly 1/n, n ≥ 2 (e.g. 0.1) | REVERSE_SPLIT (1-for-10) |
| Anything else | UNKNOWN with typeSource: "NONE" |
An inferred type is a best guess—a 5-for-4 split or large special dividend is left UNKNOWN rather than misclassified. The ratio field (computed from on-chain multipliers to 18 decimal places) is the reliable description.
Data freshness
Past actions come from a cache updated every 10 minutes. New actions are read live from the chain and appear within seconds of their event.
Errors
| Code | When |
|---|---|
-32001 | An address in addresses is not a stock token. |
-32004 | History temporarily unavailable. Retry after data.retryAfterMs. |
-32602 | limit outside 1–1000, malformed cursor/address, invalid time range, or unknown option. |
See the overview for setup, conventions, and all error codes.