OptionSpace

Python access to OptionSpace volatility data and research tools.

• Historical fitted volatility and Greeks
• Charts and session replays
• Optional local MCP tools for agent-assisted research

Data access requires an OptionSpace account and an API key. Available data depends on your account's access.

Install

Python 3.10 or newer, on Windows, macOS or Linux. The quickest way is uv, a free Python installer: it sets up the right Python for you, keeps this installation separate from your other projects, and needs nothing activated.

Install uv once (skip if you have it), then open a new terminal:

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

# macOS or Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

Then, the same on every system:

mkdir optionspace-research
cd optionspace-research
uv init --bare --python 3.12
uv add "optionspace[charts,mcp]"
uv run optionspace --version

The extras are optional: uv add optionspace installs the data client alone, [charts] adds charts and session replays, and [mcp] the local server for AI clients.

Prefer pip? In a virtual environment: python3 -m venv .venv then .venv/bin/python -m pip install "optionspace[charts,mcp]" on macOS and Linux, or py -m venv .venv then .venv\Scripts\python -m pip install "optionspace[charts,mcp]" on Windows; use that Python wherever this page says uv run.

Quick start

Save your API key once (paste it when asked; it is not shown):

uv run optionspace login

It is kept in your operating system's credential store (Windows Credential Manager, macOS Keychain, or the Secret Service on Linux).

Query a historical smile:

import optionspace as osp

client = osp.Client()
smile = client.smile(
    "SPY",
    "2025-04-10",
    expiration="2025-04-17",
)

Usage is counted in API credits against your plan's daily allowance. client.prices() gives what each call costs, and a research call takes estimate=True to return its estimate without running. A slow research call runs as a background job on the server; the client waits for it.

To use OptionSpace from Claude Code, Claude Desktop or Cursor, run uv run optionspace mcp --print-config and follow what it prints. The assistant can also answer questions about OptionSpace itself: the server includes the documentation (docs_search, docs_read), offline.

Documentation: optionspace.ai/docs. Questions: info@optionspace.ai.

Proprietary software. Copyright (c) 2026 Options Universe Inc. (d/b/a OptionSpace). By installing or using this package you agree to the OptionSpace Terms of Service. It works only with an OptionSpace account and API key, and only with OptionSpace data. See the LICENSE file for what you may and may not do.