> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driven.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This documentation is available in English and Simplified Chinese. English pages use root paths; Chinese counterparts use the same path under /zh/.
> For a Chinese-language query, retrieve the corresponding /zh/ page when available. Preserve its data, account, permission, and execution limitations when answering.

# Driven Options: Research and position analysis

> Research US and Hong Kong options, compare strategies, sync supported brokerage positions, and review trades with clear data and permission limits.

**Options** brings contract research, strategy tools, real positions, and earlier conversations into one workspace. Continue from opportunity discovery to position analysis, tracking, and review. Live trading is available where broker tools and account permissions support it.

Research does not require a broker connection. Real positions and trade history require a supported broker. The **Options** entry and new-chat suggestions may not be enabled for every account yet.

## Open the workspace

Open your Agent and click **Options** in the sidebar. Choose positions, an analysis card, a strategy, or a conversation under **Option track**.

## Use data and compare strategies

Driven provides supported US and Hong Kong chains, expirations, and contract details. Compare candidates using strikes, bid/ask, volume, open interest, IV, and Greeks.

When data supports it, ask the Agent to calculate spreads, breakevens, expiration payoffs, and ROC. Request the capital basis, annualization, quantities, multipliers, and currencies. Expiration payoffs do not establish early-exit results, and midpoint prices do not guarantee fills.

**Strategies** provides downside-protection and income-enhancement entry points: protective puts, bear put spreads, protective collars, cash-secured puts, covered calls, and covered strangles. Clicking fills a suggested question. Add holdings, horizon, and risk constraints before sending. Other structures can be researched in chat.

```text theme={null}
Compare a protective put and protective collar for 100 AAPL shares over
one month. Show each leg, quote time, premium, breakevens, capital requirements,
and loss bounds. Label assumptions and missing data. Do not place orders.
```

Real-time access, fields, and trading sessions depend on the source. Check each quote's timestamp. Strategy illustrations and animated charts on the product page are demonstrations.

## Connect and sync positions

1. Connect and authorize a supported broker from the current Agent's **Connectors**. When no broker is connected, you can also click **Connect** in Options.
2. Return to **Options** and select the broker under **Connector**.
3. Click **Sync Positions** for the first sync, inspect the conversation and result, then return to the workspace.
4. Switch between accounts when needed. The refresh icon beside the update time starts a new conversation that refreshes the selected account.

Sync saves real options accounts, excluding paper accounts and futures-only accounts. The broker must expose the required account and position tools.

| Position column | What you see |
| - | - |
| **Options**, **Qty** | Underlying, expiration, strike, Call / Put, and quantity; short quantities are negative |
| **Cost / Bid-Ask** | Average cost and available bid/ask; a position price appears when quotes are unavailable |
| **vs Strike** | Moneyness and distance from strike when data is available |
| **Delta**, **Theta**, **IV** | Available sensitivity and implied-volatility values for each leg |

Positions are saved snapshots. Update time is not each contract's quote time. Refresh before using them. Missing metrics are not estimated; the table is not a complete account valuation, margin balance, or performance history.

## Analyze positions and trades

| Card | Use it for |
| - | - |
| **Leg-by-Leg Analysis** | Each leg's risk, Greeks, payoff, and strategy contribution |
| **Options Portfolio Analysis** | Holdings and combined risk in the selected account |
| **Options Trade Review** | Decisions using the last month's order and fill history |

The first two request a position refresh. If it fails, the Agent can use an old snapshot and should flag its age. Trade review needs history; current positions cannot establish fills.

## Research contracts and opportunities

General contract screening currently covers US options. For Hong Kong research, start with a named underlying's chain. Describe filters directly or use a specialized Skill:

| Skill / entry | Scope and limits |
| - | - |
| **Unusual Option Activities** | US contract snapshots; they cannot establish trade direction, institutional intent, or multi-leg execution |
| **Earnings Option Opportunities** / **Earnings Option Analysis** | Earnings timing, event coverage, liquidity, and volatility; defaults to US, permits an explicit Hong Kong request, and covers one market per scan |
| **0DTE Option Opportunities** / **Scan 0DTE Options** | Contracts expiring on the current US trading day, requiring verified expirations and usable quotes |

```text theme={null}
Research US earnings options over the next two weeks. Check event timing,
expirations, and liquidity before comparing strategies. Separate facts,
calculations, and judgments. Explain when no opportunity qualifies.
```

Zero qualifying opportunities is valid. Outside regular hours, treat 0DTE results as structural reference and revalidate after the open. Protection ends at that day's expiration.

## Track and review weekly

**Option track** lists the current Agent's options conversations. Reopen one to continue research, refresh quotes, and test earlier assumptions.

Click **Weekly Wrap**, inspect the suggested request, add a preferred time or destination if needed, then send it. The default is Saturday at 09:00 in your timezone, covering the preceding seven days. Check the Agent's confirmed schedule, timezone, and next run.

The review uses web options conversations, saved positions, and available broker fills. It covers position changes, executed trades, discussed opportunities, and your stated plans. It does not sync positions automatically or audit every channel. Refresh first if you need recent positions; old snapshots and missing history should appear in data notes. Manage it through [Scheduled tasks](https://docs.driven.ai/concepts/scheduled-tasks.md).

## Live trading and risk

Research, strategy cards, and sync do not place orders. Live trading requires options order tools, account authorization, and appropriate permissions. Check the account, each leg, opening/closing intent, quantities, limits, multipliers, currencies, and funding requirements. After submission, inspect fill status.

Web approval follows [connector permissions](https://docs.driven.ai/concepts/connectors.md#choose-a-permission-mode). Scheduled tasks, Telegram, and WeChat do not support web approval prompts; tools can run automatically. Do not rely on **Ask every time** to pause orders in those contexts. State execution boundaries and disable the broker connector when needed.

> [!WARNING]
>
> Options can lose their entire premium, and some short strategies can incur unlimited losses. Verify liquidity, margin, assignment risk, and expiration. Analysis is informational. Investment decisions and responsibility remain yours.

## Related

* [Driven Options product introduction](https://driven.ai/options)
* [Connectors](https://docs.driven.ai/concepts/connectors.md)
* [Skills](https://docs.driven.ai/concepts/skills.md)
* [Options risk introduction (SEC)](https://www.investor.gov/introduction-investing/general-resources/news-alerts/alerts-bulletins/investor-bulletins-63)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.