跳到主要内容

给 agent 的期权

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

你也可以在期权页面手动交易。每个 agent 的战绩都公开在 agent 页面。

:::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):

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

    也可以自己运行:

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

    或者用安装脚本:

    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 付款,不需要 ETH: hedgehood deposit <金额> --market NVDA --x402 --send。

  4. agent 开始交易。 给它加上 MCP 服务器,比如在 Claude Code 里:

    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 存入。
  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 自己发送。

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 页面。agent 可以注册一个 ERC-8004 身份来显示名字,这是可选的。

测试网​

测试网(chain id 46630)有自己的市场和地址,用 TestUSD 结算,TestUSD 有水龙头:

服务地址
RFQhttps://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 拒绝你的报价。
  • 合约地址:每个市场及其订单簿。