Skip to main content

qn_getCorporateActions - Stock Token API

Returns past and scheduled stock token multiplier changes, including splits and reinvested dividends, on Robinhood Chain.

Updated on
Oct 26, 2026

Requires the Stock Token API add-on on Robinhood Chain mainnet. See additional details below or the full overview.

Parameters

options
object

Optional filters and read options. Unknown keys are rejected with -32602.

symbols
array

Case-insensitive stock tickers. Unknown tickers are skipped. Omit to use all tokens or registered feeds.

addresses
array

Stock token contract addresses. Combined with symbols using OR. Non-stock-token addresses return -32001.

fromTime
integer

Inclusive lower effectiveAt bound in Unix seconds; must be nonnegative.

toTime
integer

Inclusive upper effectiveAt bound in Unix seconds; must be at least fromTime.

includeScheduled
boolean

Include pending changes without an announced event. Defaults to true. Announced future actions are returned even when false.

limit
integer

Page size from 1 to 1000; defaults to 100.

cursor
string

Opaque nextCursor from the previous page. Omit for the first page.

Returns

result
object

The stock token API result at the reported block.

blockNumber
string

Snapshot block number in hexadecimal. Nested event block numbers are integers.

blockHash
string

Hash of the snapshot block.

actions
array

Sorted by effectiveAt, newest first, then by token address.

token
string

Stock token contract address.

symbol
string

Stock ticker or priced asset symbol.

type
string

What the action was: CASH_DIVIDEND, FORWARD_SPLIT, REVERSE_SPLIT, another Robinhood type, or UNKNOWN. See Action types.

typeSource
string

Where type came from: ROBINHOOD (its matching record), INFERRED (from ratio) or NONE (type is UNKNOWN).

status
string

EFFECTIVE (in force), SCHEDULED (announced, effectiveAt still ahead) or RESCHEDULED (replaced by a later schedule with a different time).

oldMultiplier
string

The multiplier before and after, 10^18 scale.

newMultiplier
string

The multiplier before and after, 10^18 scale.

ratio
string

Multiplier ratio, newMultiplier / oldMultiplier, as a decimal string rounded down to 18 decimal places. For example, 4.0 represents a 4-for-1 split.

effectiveAt
integer

When the new multiplier applies (Unix seconds and ISO 8601).

effectiveAtIso
string

When the new multiplier applies (Unix seconds and ISO 8601).

events
array

The on-chain UIMultiplierUpdated events 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.

blockNumber
integer

Block containing the multiplier-update event, as a decimal integer.

txHash
string

Hash of the transaction.

superseded
array or null

Earlier values for the same token and effectiveAt that a later event replaced, each with its own events. null or [] when nothing was replaced. May be null when unavailable or not applicable.

oldMultiplier
string

Earlier multiplier before the replaced change, scaled by 10^18.

newMultiplier
string

Earlier multiplier after the replaced change, scaled by 10^18.

events
array

Events announcing the replaced change.

blockNumber
integer

Block containing the multiplier-update event, as a decimal integer.

txHash
string

Hash of the transaction.

match
string

How Robinhood's records matched: EXACT (one record), AMBIGUOUS (several) or NONE.

robinhood
object or null

The matching record when match is EXACT: Robinhood's id, type, status, processDate and details (for a cash dividend, the per-share rate). Otherwise null. May be null when unavailable or not applicable.

id
string

Robinhood corporate action identifier.

type
string

The type from the matched Robinhood record.

status
string

The status from the matched Robinhood record.

processDate
string

Robinhood processing date in YYYY-MM-DD format.

details
object

Action-specific Robinhood metadata. Fields vary by action type.

cashDividend
object

Cash-dividend metadata, present for a matching cash-dividend record.

rate
string

Cash dividend per underlying share as a decimal string.

underlyingSymbol
string

Underlying stock ticker.

nextCursor
string or null

Pass as cursor for the next page; null on the last page. May be null when unavailable or not applicable.

warnings
array

Warning code strings describing partial data or unavailable signals; empty when there are no warnings.

Request
Response
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": null
60
},
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": null
85
}
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": null
60
},
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": null
85
}
86
],
87
"nextCursor": null,
88
"warnings": []
89
}
90
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free

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:

RatioInferred 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 elseUNKNOWN 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​

CodeWhen
-32001An address in addresses is not a stock token.
-32004History temporarily unavailable. Retry after data.retryAfterMs.
-32602limit outside 1–1000, malformed cursor/address, invalid time range, or unknown option.

See the overview for setup, conventions, and all error codes.