> For the complete documentation index, see [llms.txt](https://docs.callput.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.callput.app/cn/readme.md).

# README

Callput 是部署在 Base 上的链上期权协议与公开产品。用户并不是通过即时成交的订单簿交易，而是先提交请求，这些请求由执行层异步处理，随后在到期前通过独立的平仓请求流程结束，或者在到期后通过 `SettleManager` 进行结算。

本套文档的目标，是让交易者、开发者与 AI Agent 仅凭文档就能理解当前机制并安全使用产品。

## 为什么交易者会选择 Callput

Callput 面向的是这样一类交易者：

* 希望以比直接持有现货或全额方向性仓位更高的资金效率，获取加密期权与合成股票期权敞口
* 希望通过付权利金的多头策略和定义风险的价差策略获得更高的有效杠杆
* 希望使用由 IV、期货、现货、利率与协议侧风险调整共同决定的期权定价

完整定位页见 [Why Trade On Callput](/cn/start-here/why-trade-on-callput.md)。

## 期权教育

如果你熟悉加密市场，但想在真正使用产品之前系统学习期权策略，请先确认当前公开可用范围，再按下面的路径阅读：

1. [Live Scope And Markets](/cn/start-here/live-scope-and-markets.md)
2. [Options Education](/cn/options-education/readme.md)
3. [Options Basics For Crypto Traders](/cn/options-education/options-basics-for-crypto-traders.md)
4. [Crypto Options Context](/cn/options-education/crypto-options-context.md)
5. [Option Payoffs, Value, And The Greeks](/cn/options-education/option-payoffs-value-and-the-greeks.md)
6. [Long Option Strategies](/cn/options-education/long-option-strategies.md)
7. [Short Option Strategies](/cn/options-education/short-option-strategies.md)
8. [Vertical Spread Strategies](/cn/options-education/vertical-spread-strategies.md)
9. [Options Strategy Cheat Sheet](/cn/options-education/options-strategy-cheat-sheet.md)
10. [Choosing Strikes, Expiries, And Trade Plans](/cn/options-education/choosing-strikes-expiries-and-trade-plans.md)
11. [Risk Management And Common Mistakes](/cn/options-education/risk-management-and-common-mistakes.md)
12. [Trading Options On Callput](/cn/options-education/trading-options-on-callput.md)

## 理解三层结构

### 协议事实

这是合约真正强制执行的规则：

* 仓位通过 `PositionManager` 开仓与平仓
* 请求状态会落在 `Pending`、`Cancelled`、`Executed`
* 到期前最后一段 buffer 时间内不能创建新的开仓或平仓请求
* 到期后的结算通过 `SettleManager` 独立处理

### 公开产品层

这是今天对外暴露给用户的产品表面。截至 2026 年 6 月 3 日（KST），已验证的公开市场范围包括 Base 上的 BTC、ETH 期权，以及 Callput.app 支持的合成股票/权益期权市场。

### 集成层

这是外部构建者与系统交互的接口层：

* 公共市场数据源
* 面向前端的市场数据
* MCP 或其他 Agent 包装层
* 地址包、ABI 与索引事件

## 当前已上线内容

详细范围请见 [LIVE SCOPE AND MARKETS](/cn/start-here/live-scope-and-markets.md)。简版如下：

* 目前已验证的公开标的包括 BTC、ETH，以及受支持的合成股票/权益期权市场
* synthetic stock options 现在已经在 Callput.app 上线
* 初始参考股票和 ETF 市场包括 QQQ、SPY、EWY、TSLA、NVDA、GOOG、AAPL、PLTR，以及 live product 支持的更多市场
* 交易是基于请求的异步执行
* 到期前平仓需要单独提交平仓请求
* 到期后结算通过 `SettleManager`
* LP 文档当前以 `sVault` 为中心

## 选择你的阅读路径

### 交易者

1. [Why Trade On Callput](/cn/start-here/why-trade-on-callput.md)
2. [Live Scope And Markets](/cn/start-here/live-scope-and-markets.md)
3. [Options Education](/cn/options-education/readme.md)
4. [Instruments, Strategies, And Collateral](broken://pages/2f8bbb9e35e1e583c5d1f85bc923ae6331963149)
5. [Pricing And Execution](broken://pages/fe40ff9001bf423e09a5787e10258b6156025af9)
6. [Pricing Mechanics](broken://pages/ccefc13b5f90cfddc5eff010a4620219923f5da4)
7. [Position Lifecycle](broken://pages/1884dd5067c8bad3dfd33404d5ce9002f1ffb5d1)
8. [Fees, Limits, And FAQ](broken://pages/3fa15a70b5e385eee8b84b34b7837766ceb8b19c)

### 流动性提供者

1. [OLP Overview](broken://pages/06bb292bb2fc79605021352002c597549c5ae71b)
2. [Vaults, Risk, And Epoch](broken://pages/1cd6988964cdf14800dfd4de6d9097f50c1ba3a0)

### 开发者

1. [Protocol Architecture](broken://pages/53b44233d79b912a82488c8826ab35dcbe719d3f)
2. [Contracts, Addresses, And Data Sources](broken://pages/6abe35d61198874d85860c4bd1a395a77e90960f)
3. [Option Token ID And State Machine](broken://pages/84053804b084780c0ab4722bfb543f7d7e4eee31)
4. [Request Lifecycle Reference](broken://pages/63fca1ed00292d4d6304508840301eca75846339)
5. [Integration Guide](broken://pages/902fc6fd9841af78743197e1e0f33c44ce543b60)

### AI Agent 构建者

1. [Agent Quickstart](/cn/ai-agents/agent-quickstart.md)
2. [Callput MCP](/cn/ai-agents/callput-mcp.md)
3. [Base MCP + Callput Agent Flow](/cn/ai-agents/base-mcp-+-callput-agent-flow.md)
4. [Trading Loop And Recovery](/cn/ai-agents/trading-loop-and-recovery.md)
5. [Option Token ID And State Machine](/cn/developers/option-token-id-and-state-machine.md)
6. [Request Lifecycle Reference](/cn/request-lifecycle-reference.md)

## Callput 如何运作

高层流程如下：

1. 用户从公共市场数据中发现可交易市场
2. 用户向 `PositionManager` 提交开仓请求
3. 请求进入队列，而不是立即成交
4. 执行层将请求标记为 `Executed` 或 `Cancelled`
5. 如果执行成功，用户收到 ERC-1155 期权仓位代币
6. 到期前，用户可以提交平仓请求
7. 到期后，用户必须通过 `SettleManager` 结算

最重要的操作含义是：交易哈希成功只代表请求被登记，不代表仓位已经真正开出。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.callput.app/cn/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.