---
name: astock
description: Buy, sell and check tokenized stocks on Arc with Astock (astock.fi): stock tokens backed one to one by Robinhood Stock Tokens held in a reserve on Robinhood Chain. Use when an agent needs a stock price, a quote with the exact transaction to send, to buy or sell a stock token (hub or desk) or a launchpad token, to check that a stock token is backed, or to follow what changed. Works from any EVM wallet on Arc, and gives Circle CLI commands for Circle Agent Wallets (not yet run end to end on Arc).
metadata:
  version: 0.2.0
  homepage: https://astock.fi
  api: https://astock.fi/api/v2
  openapi: https://astock.fi/api/openapi.json
  chains: Arc mainnet (5042, Circle "ARC"); reserve on Robinhood Chain (4663)
---

# Astock for agents

Astock lists stock tokens on Arc (NVDA, TSLA, SPY and more): each one is backed by the real Robinhood Stock Token held
in a vault on Robinhood Chain. You trade with USDC, Arc's native asset. Nothing custodies your funds: every write is a transaction your own wallet signs.

## What you need

- A wallet on Arc with USDC (gas on Arc is paid in USDC too).
- Nothing else for reading: the API is open, no key. A key (`X-Api-Key`) only raises limits and unlocks webhooks.

## The three steps of any trade

1. **Ask:** `GET https://astock.fi/api/v2/quote?stock=NVDA&side=buy&amount=100&wallet=<your address>`
   answers each route with `call` (contract, function, arguments, native value) and `circle` (the same as Circle CLI
   lines; a list when an `approve` goes first).
2. **Send:** run the `circle` lines in order, or send `call` with any EVM library (`astock-sdk` does it with viem).
3. **Follow:** `GET /api/v2/orders/{id}` for a hub order, or `GET /api/v2/changes?since=<ms>`, or a webhook.

Details per route, selling, launching and exiting: [AGENT-GUIDE.md](AGENT-GUIDE.md).
Checking the backing yourself, from the chains: [VERIFY.md](VERIFY.md).
Every contract address and the Circle allowlist: [addresses.json](addresses.json) (generated from the deployment records).

## Reading

| What | Call |
|---|---|
| Every stock and its price | `GET /api/v2/stocks` |
| One stock on one page: supply, backing, oracle age, where it trades, fees | `GET /api/v2/factsheet/{SYM}` |
| The reserve and what backs each token | `GET /api/v2/reserves` |
| What changed since a moment | `GET /api/v2/changes?since=<ms>` (then `cursor=`) |
| Launchpad tokens | `GET https://launch.astock.fi/api/v2/launch`, `…/launch/{token}` |
| Holder payouts | `GET /api/v2/payouts`, `GET /api/v2/rewards` |
| Points of a wallet | `GET https://launch.astock.fi/api/v2/points/{wallet}` |

Or run the reader that ships with this skill (Node 18+, no dependencies):

```bash
node astock-read.mjs factsheet NVDA
node astock-read.mjs quote NVDA buy 100 --wallet 0xYourWallet
node astock-read.mjs verify NVDA        # the backing read from Arc and Robinhood Chain directly
```

An MCP server with the same reads is `astock-mcp` (stdio, read-only).

## Rules for agents

- **Amounts:** USDC on Arc is native with 18 decimals; `call.value` and `args` are raw integers as strings. Prices are
  USDC per share. Timestamps are Unix milliseconds unless a field says seconds.
- **Never reuse an old quote.** Ask again before sending; a quote names the contract that serves at that moment.
- **Respect `unavailable`.** A route that cannot take the trade says why; do not send its call.
- **Hub sells burn at once** and pay USDC when the reserve answers (about a minute). The previous hub
  (`addresses.json` → `arc.previousHub`) never fills a sell: do not send `requestSell`, `escalate` or `canonicalRedeem`
  there.
- **Circle CLI lines have not been run end to end on Arc yet**, and the ones with `bytes`, arrays or tuples are marked
  `circleUnverified`: test with a small amount first.
