Add hoodgrow skill: pay-per-call Robinhood Chain stock token data via… - #599
Open
MeMikko wants to merge 10 commits into
Open
Add hoodgrow skill: pay-per-call Robinhood Chain stock token data via…#599MeMikko wants to merge 10 commits into
MeMikko wants to merge 10 commits into
Conversation
… x402 HoodGrow reads Robinhood Chain (chain id 4663) stock token contracts directly — live price, ERC-8056 corporate-action adjusted supply (so numbers stay correct through stock splits, not just raw token balances), and both pending (on-chain) and historical (official Robinhood ledger) corporate actions for the full token catalog in one call. GET https://www.hoodgrow.com/api/agent/tokens — $0.50/call, USDC on Base via x402 (Coinbase CDP facilitator), no signup or API key.
Matches HoodGrow's own API additions (single-symbol pay-per-call endpoint at $0.05, and a defi field with Morpho best supply APY + Uniswap V3 TVL on both endpoints), so the skill's payment-safety price ceiling and endpoint docs stay accurate for both call shapes instead of only the original full-catalog one.
HoodGrow's agent API defaults to 30 req/min per IP for pay-per-call callers now that per-key rate limits shipped server-side. An agent polling frequently should know a 429 means back off (and why blindly retrying a paid call risks a duplicate payment), and that a persistent key with its own higher limit exists for sustained/heavy use.
Both are thin clients that handle x402 payment (or a bearer key) and return typed responses instead of raw JSON — an easier on-ramp than calling the endpoints directly for anyone not building a bespoke x402 client already.
Both shipped in production since this PR was opened, but the skill file still described the old two-endpoint, x402-only shape: - A free self-serve API key (300 requests/day, no payment) is now available at hoodgrow.com/builders, in addition to the existing x402 pay-per-call path. The previous "no signup or API key" framing undersold this — a persistent key no longer requires a paid subscription. - GET /api/corporate-actions is a new, dedicated, filterable, cursor-paginated feed of corporate-action events, independent of price data, priced at $0.05/call like the single-symbol endpoint. Documented with its query params, response fields, and the same payment-safety price-ceiling treatment as the other two endpoints. catalog.json's demo script and setup steps updated to match.
hoodgrow.com redirects to www.hoodgrow.com, and fetch drops the Authorization header on a cross-host redirect per spec. A bearer-key call to the bare host loses its key mid-request and falls through to the x402 paywall instead of erroring — indistinguishable from "no key sent" unless you already know to look for it. Every example in this skill already uses www.hoodgrow.com; this makes explicit why that matters beyond just the payment-safety host check.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
… x402
HoodGrow reads Robinhood Chain (chain id 4663) stock token contracts directly — live price, ERC-8056 corporate-action adjusted supply (so numbers stay correct through stock splits, not just raw token balances), and both pending (on-chain) and historical (official Robinhood ledger) corporate actions for the full token catalog in one call.
GET https://www.hoodgrow.com/api/agent/tokens — $0.50/call, USDC on Base via x402 (Coinbase CDP facilitator), no signup or API key.