# StockBox: full reference StockBox (this site) is an onchain app on Robinhood Chain (chain id 4663, gas in ETH) for distributing Robinhood stock tokens. It is not investment advice, not available to US persons, and not affiliated with Robinhood or any listed company. Live figures (stats, prices, pots, vault holdings) come from GET /api/agent/v1/stats, /boxes and /tokens. ## Chain and assets - Everything runs on Robinhood Chain. Pay in USDG or ETH. Prizes are Robinhood stock tokens (ERC-20, e.g. NVDA, TSLA, SPY, QQQ). - Randomness: drand evmnet beacon, signature verified onchain. - Prices: Chainlink. Trades route through Uniswap v3. ## Mystery crates | Crate | Price | Pays | |---|---|---| | Normal | $0.10 | $0.01 to $1 of stock, or the bonus pot | | Premium | $1 | $0.10 to $10 of stock, or the bonus pot | Odds (out of 10,000): Normal $0.01 16%, $0.025 26%, $0.05 27%, $0.10 20%, $0.20 8%, $0.50 2.5%, $1 0.5%. Premium: ten times each prize, same chances. Average payout is about 75% of the price before the pot. One roll in 1,000 is the pot line: once the pot is full it pays $2.50 (normal) or $25 (premium); until then $0.20 or $2. Each sale adds 2% of its price to that crate's pot. - Buy up to 200 at once. Open up to 200 at once for one ETH opening fee that pays for the random number. - One random number per opening sets every crate's prize and stock; it comes from a drand round that is still in the future when you open. - Prizes are paid in stock from that crate contract's own vault. If the vault is short, the payout waits and is settled after a refill (anyone can call settle). - Sealed crates can be sent (up to 200 at a time) and expire one year after purchase. Opened crates cannot move. ## Gift crates - Fill a crate with chosen stock tokens, USDG or ETH; contents are fixed (no randomness). Never expire. - Direct: up to 100 wallets. Link: up to 100,000 crates, one per wallet, open to anyone or to a wallet list, with start and end times. - Design: crate and ribbon colours, title up to 16 characters, note up to 140 characters. - Cost: contents + 2.5%, paid in USDG or ETH. Unclaimed link crates can be taken back. ## Baskets - Anyone publishes 2-20 stock tokens with a dollar amount each per crate (min $0.01 each). - Buying makes sealed gift crates of that mix at current prices. Fee 2.5%; the maker earns 1% of every crate others buy. ## Swap tab - Stock trades: 1% (Uniswap). ETH <-> USDG: 0.75%. - Minimums: $0.10 to buy, $0.05 to sell. Slippage cap 0.5%. Trades quoting more than 2% under Chainlink are refused. ## Campaigns - Projects fund sealed crates (from $10) and set tasks: visit a link, hold a token, open crates, trade on Swap, be on a list, or pass a check on their API. - Joining is one free signature. Raffle (trades add tickets, drawn with a public drand beacon after the end) or first come, first served (crate sent within a minute). Up to 30 days. ## Agent API Base URL /api/agent/v1. No API key. JSON. Reads are GET; writes are POST /tx/* returning a plan of unsigned transactions (steps with chainId 4663, to, data, value) that the user's wallet signs in order. Every POST needs wallet and skill ("1.0.0"); chain defaults to "robinhood". See /SKILL.md and /#dev-how. ## Contracts Addresses are listed at GET /api/agent/v1 under chains[].contracts once deployed, verified on robinhoodchain.blockscout.com.