Skip to content

Robinhood Events, Calls, Balances & Token Holders API pages#221

Merged
buddies2705 merged 5 commits into
mainfrom
docs/robinhood-cube-pages
Jul 24, 2026
Merged

Robinhood Events, Calls, Balances & Token Holders API pages#221
buddies2705 merged 5 commits into
mainfrom
docs/robinhood-cube-pages

Conversation

@buddies2705

Copy link
Copy Markdown
Contributor

Summary

Four new live-tested Robinhood docs pages plus supporting updates, continuing the audit merged in #220. Every query was executed against the production endpoint (streaming.bitquery.io) before publishing; all subscriptions were verified over WebSocket (graphql-transport-ws). Pages follow the evergreen rule — no dated stats.

  • Events API & WebSocket Streams (robinhood-events-api.md) — stream-first guide to EVM.Events as a no-node alternative to eth_subscribe/eth_getLogs: full-field firehose, per-contract / per-signature / topic0-hash / decoded-argument / wallet-scoped streams, per-tx forensics, top signatures & emitters, dataset-window probes. Documents LogHeader.Address vs Log.SmartContract proxy semantics and no-0x hash formats.
  • Calls & Traces API (robinhood-calls-api.md) — EVM.Calls as a debug_traceTransaction/trace_filter alternative: firehose, contract/function/selector streams, Create: true deployment radar (Call.To = deployed address), reverted-call monitor, internal value traces, per-tx call-tree reconstruction (Index/CallerIndex/CallPath), gas & method analytics. Documents uppercase 4-byte selector format.
  • Balances API (robinhood-balances-api.md) — wallet-centric EVM.Balances: full portfolios, as-of-date balance history (Block.Date.till), native/single-token, multi-address batches, wallet profiling (first/last change, update count), per-currency network totals. Documents grouping-follows-selection and selectWhere (HAVING) semantics.
  • Token Holders API (robinhood-token-holders-api.md) — token-centric EVM.Holders: top-holder rankings, current-vs-ever holder counts, balance floors, distribution stats (avg/median/p99), dormancy screens via LastChangeTime, tokenized stock holders, native rich list, offset pagination for snapshots. Documents that LastChangeTime.till is a dormancy filter (not time travel) and the cube has no USD field.
  • Cross-cutting: ~3-month archive-retention wording for Calls/Events, Kafka firehose pointers (per protobuf topic) on the five streaming-heavy pages, sidebar entries for all four new pages, holder queries moved off the Balances page to the Holders page.

Testing

  • ~60 queries live-tested across the four cubes; failing/ambiguous patterns fixed or documented before inclusion.
  • 9 subscriptions verified end-to-end over WebSocket, including full-field firehoses.
  • Docusaurus production build green (routes, links, anchors); in-page anchors verified per page.

🤖 Generated with Claude Code

Gaurav agarwal and others added 5 commits July 24, 2026 12:19
Stream-first guide to EVM.Events on Robinhood, positioned as a no-node
alternative to eth_subscribe/eth_getLogs: verified firehose (full field
set), per-contract, per-signature, topic0-hash, decoded-argument, and
wallet-scoped streams, plus historical queries (per-tx forensics, top
signatures/emitters, window probes) and dataset guidance. Documents
LogHeader.Address vs Log.SmartContract proxy semantics and no-0x hash
format. All queries live-tested; subscriptions verified over WebSocket.
Registers the page in the sidebar.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
New stream-first Calls/Traces page (EVM.Calls) as a debug_traceTransaction
alternative: verified firehose, per-contract/function/selector streams,
Create-true deployment radar, reverted-call monitor, value traces, per-tx
call-tree reconstruction, and gas/method analytics. Documents 4-byte
uppercase selector format and call-tree semantics; registered in sidebar.
Updates Events page archive wording to the ~3-month retention plan and
adds Robinhood Kafka stream pointers (per-topic) to the five streaming
pages. All queries live-tested; subscriptions verified over WebSocket.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Balances cube guide: wallet portfolios, as-of-date time travel, native
and single-token balances, multi-address batches, top holders, rich
lists, USD whale floors, holder counts, wallet profiling
(first/last change, update count), per-currency network totals, and the
BalanceUpdates live delta stream (WS-verified) with Kafka pointer.
Documents grouping-follows-selection, selectWhere (HAVING) semantics,
signed deltas, and native-only USD enrichment. All queries live-tested;
registered in sidebar.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Drops the BalanceUpdates stream section and all references; live
balance-change needs now point to polling and Kafka streams
(robinhood.tokens.proto).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
New Holders-cube page: top-holder rankings (user's flagship query),
current vs ever holder counts, balance floors, distribution stats
(avg/median/p99), dormancy screens via LastChangeTime, tokenized stock
holders, native rich list, and offset pagination for snapshots.
Documents no-USD-field and LastChangeTime semantics. Balances page now
focuses on wallet portfolios and links holder use cases to the new page.
All queries live-tested; registered in sidebar.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@buddies2705
buddies2705 merged commit 17338bc into main Jul 24, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant