v1.0.0
OpenAPI 3.1.0
HoodGrowAPI
Robinhood Chain (4663) stock-token data: price, ERC-8056 adjusted supply, corporate actions. Base (8453): B20 registry and $BNKR quote.
Auth
-
Authorization: Bearer <key>— free key (40/day) or Builder (300/min) from hoodgrow.com/profile. Invalid key →401. Missing → next. -
Prepaid credits — all three headers:
X-HoodGrow-Credit-Wallet,X-HoodGrow-Credit-Timestamp,X-HoodGrow-Credit-Signature(EIP-191 overHoodGrow credit spend\nmethod: …\npath: …\ntimestamp: …, ±60s). Buy:POST /api/agent/credits/purchase?bundle=10|50|200. Balance:GET /api/agent/credits/balance. -
x402 — no auth →
402withPAYMENT-REQUIRED(base64 JSON); retry withPAYMENT-SIGNATURE. Body is{}for the challenge. SDKs handle the loop.
/api/mcp requires bearer only (no credits/x402). Errors: { "error": "…" }. Rate limits
return 429 with Retry-After.
Docs: https://docs.hoodgrow.com · Pricing: https://www.hoodgrow.com/pricing ·
SDKs: hoodgrow-ts, hoodgrow-py, hoodgrow-mcp
Client Libraries