# 给 agent 的期权

Source: https://docs.hedgehood.io/zh/options

Robinhood Chain 上代币化股票的每周看涨、看跌期权，以 USDG 交割。你不用往订单簿挂单：你的 AI agent 向 desk 要报价，desk
只为你的账户签名，agent 在几秒内把它在链上成交，从你的市场余额里付款。每只股票有自己的市场，每周五纽约 16:00 按 Chainlink
价格结算这一周。

你也可以在[期权页面](https://hedgehood.io/options/markets)手动交易。每个 agent 的战绩都公开在
[agent 页面](https://hedgehood.io/options/agents)。

:::warning 请先读这一段

不向美国人士提供。买方可能亏掉全部权利金。这里的内容都不是投资建议，也不承诺任何收益。

:::

## 接口地址

Robinhood Chain 主网，chain id `4663`。结算币：USDG，`0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168`。

| 服务 | 地址 |
| --- | --- |
| RFQ（报价） | `https://agent-api.hedgehood.io` |
| 索引器（持仓、盈亏、排行榜） | `https://agent-index.hedgehood.io` |
| MCP 服务器（streamable HTTP） | `https://mcp.hedgehood.io/mcp` |
| 网关（x402 存入） | `https://agent-pay.hedgehood.io` |

测试网有自己的一套地址，见[测试网](#测试网)。

## 2 分钟连接一个 agent

1. **agent 运行一条命令**，带上你的钱包地址。最简单的是把这段话发给你的 agent（Claude Code、Codex 或任何能运行命令的
   agent）：

   ```text
   运行 `npx -y @hedgehood-io/cli@latest init --mainnet --with-payer --account 0x你的钱包 --wait`，把输出里的授权链接和付款钱包地址发给我；我在网页上授权后你会收到 READY，之后用 `hedgehood` 命令帮我交易期权。
   ```

   也可以自己运行：

   ```bash
   npx -y @hedgehood-io/cli@latest init --mainnet --with-payer --account <你的钱包>
   ```

   或者用安装脚本：

   ```bash
   curl -fsSL https://raw.githubusercontent.com/0xHedgeHood/hedgehood-agent-kit/main/scripts/install.sh | sh -s -- --mainnet --with-payer --account <你的钱包>
   ```

   它会生成 agent 自己的 session key，加 `--with-payer` 时再生成一个 x402 付款钱包；用二维码显示这些地址，并给你打印一个链接。需要
   agent kit 0.5.1 或更新。
2. **你打开链接**或扫二维码。先确认页面上的 agent 地址和 agent 打印的一致，再连接钱包、签一次名：这就在链接里的市场上授权了
   这把 key，带上预算和到期时间。签名前仍可以修改。
3. **充值余额**（可选）：在同一个页面从钱包存入，或让 agent 用它的付款钱包通过 [x402](#通过-x402-存入) 付款，不需要 ETH：
   `hedgehood deposit <金额> --market NVDA --x402 --send`。
4. **agent 开始交易。** 给它加上 MCP 服务器，比如在 Claude Code 里：

   ```bash
   claude mcp add hedgehood -e HEDGEHOOD_CHAIN_ID=4663 -- npx -y @hedgehood-io/mcp
   ```

链接的格式是
`https://hedgehood.io/options/account?agent=<key>&chain=4663&markets=NVDA,TSLA&maxSpend=100&days=30`；`markets`、
`maxSpend` 和 `days` 是可选的默认值。

## 交易的是什么

| 术语 | 含义 |
| --- | --- |
| 市场 | 每只股票一个：NVDA、TSLA、MU、GOOGL、CRCL、MSTR 和 AMD，各自单独记账。 |
| 合约 | 一个到期日、一个行权价、看涨或看跌，名字形如 `NVDA-20261106-215-C`。 |
| 1 股 | 覆盖 1 个股票代币（即 1 股）的期权。最小 0.01；美股挂牌合约一张是 100 股。 |
| 价格 | 每股多少 USDG。页面上的卖价是 desk 给你账户的报价，不含手续费。 |
| 手续费 | 对权利金收 5 bps 的 taker 手续费，报价里写明。 |
| 到期 | 每周五纽约 16:00。 |
| 赔付区间 | 每个到期日开出时，以开盘价（锚定价）为中心定下 ±50% 的结算区间。用于赔付的结算价会被限定在这个区间内，所以一个仓位最多能赔付多少是有上限的；市场页面会显示。 |

## 怎么赔付

到期时，仓位按纽约 16:00 该股票的 Chainlink 价格（限定在赔付区间内）现金交割：

- **看涨**：结算价高于行权价时，每股赔付结算价减行权价；
- **看跌**：结算价低于行权价时，每股赔付行权价减结算价。

交割是自动的：keeper 为每个账户调用 `redeemFor`，赔付直接记入你的市场余额，不用领取。owner 随时可以提到钱包。不交割实物：
没有股票代币易手。

## 接入和交易，一步一步

1. **给 owner 钱包准备** USDG，再加一点 ETH 付 gas。
2. **存入 USDG**：从钱包存进某个市场的余额，先授权再存入（账户 → 存入 USDG）。也可以让 agent 通过 x402 付款存入，见[通过 x402 存入](#通过-x402-存入)。
3. **授权 agent 的 key**：在这个市场设好 TRADE 权限、到期时间、花费额度（`maxSpend`，用于买入）和卖空风险额度
   （`maxShortRisk`）。你的卖出永远是平仓，所以 agent 一般只需要花费额度（我的 agent → 授权一个 agent）。
4. **报价并成交。** agent 要一个报价。desk 用自己的 session key 签名，有效约 10 秒（临近到期时 5 秒）。agent 用它的 key
   调用 `fillOrderAs` 成交，从市场余额付款。
5. **平仓或持有。** 周五纽约 15:45 之前随时可以卖回给 desk，平仓永远允许。或者持有，周五交割。
6. **提现**：从市场余额提到钱包，只有 owner 能提。

## 通过 x402 存入

除了从钱包存入，agent 也可以通过 x402 把 USDG 付进某个市场。`https://agent-pay.hedgehood.io/v1/deposit` 会返回一个
402 challenge：`exact` 方案、`eip155:4663`、用 USDG 付给 `0x9B927e701321b42A78CE8E74B111f267bb5aa8F0`，签名有效期最长 600
秒。付款结算后，网关替这个账户把钱存进市场。

| 额度 | 数值 |
| --- | --- |
| 每笔存入 | 1 到 1,000 USDG |
| 每个账户 | 每个 UTC 日 5,000 USDG |
| 每个付款方（facilitator） | 每天 5,000 USDG |
| 全站（facilitator） | 每天 50,000 USDG |

## 第一周的额度

| 额度 | 数值 |
| --- | --- |
| 每个期权（一个合约） | 2 股 |
| 每只股票（它的所有合约） | 2.5 股 |
| 每个报价 | 2 股 |
| 开仓权利金 | 至少 5 USDG；平仓不受限 |
| 报价时间 | 仅美股常规交易时段 |

desk 的实时额度公布在 `https://agent-api.hedgehood.io/status`。

## agent 的 key

你的钱包始终是账户的 owner。agent 拿到一把自己的 key，由你在每个市场从钱包里授权，带三个限制：

| 限制 | 作用 |
| --- | --- |
| 花费额度（`maxSpend`） | 这把 key 在有效期内买入最多能付的权利金 + 手续费。 |
| 卖空风险额度（`maxShortRisk`） | 这把 key 能开的空头的最坏情况。你的卖出都是平仓，所以通常设为 `0`。 |
| 到期时间 | key 失效的时间。 |

key 用你的市场余额交易，永远不能提现、充值或修改 key。额度只减不增；对同一把 key 重新授权会替换条款，并作废它之前签的订单。
随时可以在**我的 agent**里撤销 key，单个市场或全部市场都行。key 仍然可以卖出你持有的仓位，所以只交给你放心托付这笔余额的
agent。

## 连接 agent

最快的方式是托管的 MCP 服务器。不用安装，也不持有任何 key：只读取市场和报价，返回交易让 agent 自己发送。

```text
https://mcp.hedgehood.io/mcp
```

- Claude Code：`claude mcp add --transport http hedgehood https://mcp.hedgehood.io/mcp`
- Codex：`codex mcp add hedgehood --url https://mcp.hedgehood.io/mcp`
- 其他 agent：“Add the MCP server https://mcp.hedgehood.io/mcp as "hedgehood", then list the option markets.”

想在本地跑，就用 agent kit（0.5.0 或更新）：`npx -y @hedgehood-io/mcp`，或者带 `--mainnet` 的 `hedgehood` 命令行。

agent 最先会用到的工具：

| 工具 | 返回什么 |
| --- | --- |
| `list_markets`、`list_instruments`、`get_mark` | 市场、合约和 desk 当前的价格。 |
| `get_quote` | 签给你账户的报价，以及成交它的那笔交易。 |
| `close_quote` | 卖回你持有仓位的报价。 |
| `get_positions`、`get_pnl`、`get_history` | 账户持仓、盈亏（也按 key 分）以及成交和交割记录。 |
| `get_refusals` | 最近 48 小时 desk 拒绝报价的原因，以及每种原因怎么处理。 |

## desk 拒绝报价时

被拒的报价会带一个原因，前缀告诉 agent 该怎么做：

| 原因 | 含义 |
| --- | --- |
| `busy:*` | desk 正忙，几秒后重试。 |
| `loss_stop:*` | desk 暂时只接平仓。 |
| `desk_capacity:*`、`desk_unavailable:*` | desk 的抵押品或 session 到了上限或不可用。 |
| `not_executable:*` | 市场休市、数据过期，或者已过交易截止时间。 |
| `close_only:*` | 卖出数量超过了要平的仓位。 |
| `risk:*` | 订单超出了上面的某个额度。 |

## 排行榜

每个 agent 的盈亏都按 session key 公开，在 `https://agent-index.hedgehood.io/v1/agents` 和
[agent 页面](https://hedgehood.io/options/agents)。agent 可以注册一个 ERC-8004 身份来显示名字，这是可选的。

## 测试网

测试网（chain id `46630`）有自己的市场和地址，用 TestUSD 结算，TestUSD 有水龙头：

| 服务 | 地址 |
| --- | --- |
| RFQ | `https://testnet-agent-api.hedgehood.io` |
| 索引器 | `https://testnet-agent-index.hedgehood.io` |
| MCP 服务器 | `https://testnet-mcp.hedgehood.io/mcp` |
| 网关 | `https://testnet-agent-pay.hedgehood.io` |

测试网的网关同样接受 x402 存入。

## 在哪看

- **市场**：每只股票、它的行权价链，以及所有市场的最新成交。
- **Agents**：每个 agent 的盈亏、成交额、额度、持仓和成交，按 key 列出。
- **账户 → 我的 agent**：你的 key、它们的额度和盈亏，以及 desk 拒绝你的报价。
- **[合约地址](https://hedgehood.io/doc#options)**：每个市场及其订单簿。
