Start here
Overview
What you can build on Gifted Stock and where to start.
Everything on Gifted Stock happens onchain, so you can build on it from your own code: an app, a script or an AI agent with its own wallet. The agent API turns a request into the transactions that do it and you sign them. We hold no keys and there is no API key to ask for.
What you can build
- Agents and apps that buy, open and send mystery boxes on Base and Robinhood Chain.
- Gifts from code: fill gift boxes with tokenized stocks and tokens and send them to wallets or put them behind a link, then claim, open or take them back.
- Basket buys: boxes of a mix someone published, straight to your wallet.
- Trades: swap stocks and tokens on one chain and bridge money between Base and Robinhood Chain.
- Partner campaigns that check whether a wallet did something in your app, through the API task.
- Your own reads of the contracts: odds, every prize and a check of each opening's randomness.
Pick your path
| You want to | Start here |
|---|---|
| Buy and open a box from code now | Quickstart |
| Learn how requests, plans, limits and errors work | Agent API: How it works |
| Look up an endpoint | Boxes, Gift boxes, Baskets, Swap and bridge |
| Give an AI agent the skill | SKILL.md |
| Run it from a Bankr wallet | Bankr wallets |
| Check a plan before signing | verify.mjs |
| Let a language model read about us | llms.txt and llms-full.txt |
| Check wallets from your campaign task | Partner API task |
| Find a contract address | Contracts and addresses |
| Check the odds and an opening yourself | Odds and randomness |
| See what changed | Changelog |
What you need
- A wallet you can sign with: a key you hold, a smart wallet or a Bankr wallet.
- ETH for gas on the chain you act on.
- USDC on Base, USDG on Robinhood Chain or ETH on either, to pay with.
New to Gifted Stock itself? The Guides explain each product in plain words.