Agent skill

Ib Option Chain

by staskh in staskh/trading_skills

Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks.

MITAuto-check: notesBusiness, Finance & HR

Install Ib Option Chain

skills CLI
$ npx skills add staskh/trading_skills --skill ib-option-chain -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install staskh/trading_skills ib-option-chain --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/staskh/trading_skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/ib-option-chain .claude/skills/ib-option-chain && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ib-option-chain
GitHub stars
374
Used in
1 other repo
Token cost
~873 tokens
SKILL.md length
418 words
Files
2 (incl. scripts)
Skills in repo
28
Repo updated
First seen
Licence
MIT

At a glance

Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks.

  • User asks about options using IBKR data
  • SKILL.md covers IB Connection, Instructions, Arguments and Output, plus 2 more sections
  • Runs Python scripts from its folder; calls uv
  • Futures options (NQ/ES/CL/GC...)

What it does

Ib Option Chain is an agent skill from staskh/trading_skills. Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks. Use when user asks about options using IBKR data, futures options (NQ/ES/CL/GC...), or needs real-time option quotes from their broker. Requires TWS or IB Gateway running locally.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/options.py`).

It sits in Business, Finance & HR, covering Stock and market analysis. The repository describes itself as: Claude powered advisor system for option traders. The licence is MIT.

When your agent uses it

  • User asks about options using IBKR data
  • Futures options (NQ/ES/CL/GC...)
  • Needs real-time option quotes from their broker

Example prompts

  • “/ib-option-chain”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit b71a74f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ib Option Chain loads about 873 tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 418 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~873

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:22
    lt-in default. Set it in the shell or a `.env` file.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from staskh/trading_skills at commit b71a74f, republished under its MIT licence (© staskh). 418 words, ~873 tokens.

Download SKILL.mdSave it as .claude/skills/ib-option-chain/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ib-option-chain
description
Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks. Use when user asks about options using IBKR data, futures options (NQ/ES/CL/GC...), or needs real-time option quotes from their broker. Requires TWS or IB Gateway running locally.
dependencies
trading-skills

IB Option Chain

Fetch option chain data from Interactive Brokers for a specific expiration date. Handles equities/ETFs (Stock/OPT) and futures options (FOP). The asset type and exchange are resolved from IB contract details (no hardcoded symbol table): auto-detect tries a SMART stock first and falls back to a future when no stock exists (so NQ, GC, RTY resolve as futures, while AAPL resolves as a stock even though it has an obscure single-stock future). Tickers that are both a stock and a futures root (e.g. ES=Eversource, CL=Colgate) default to the equity — pass --sec-type fut to force the future.

IB Connection

TWS or IB Gateway must be running locally with API enabled:

  • Paper trading — port 7497
  • Live trading — port 7496
  • IB_PORT env var — default port when --port is omitted (e.g. IB_PORT=4001 for a Gateway container). Precedence: --port flag > IB_PORT > built-in default. Set it in the shell or a .env file.

Port fallback: If the configured port fails, automatically retry on the other port. If the retry succeeds, save to memory which account type worked (live/paper) and reuse it for all IB skill calls in this and future sessions — until the user explicitly asks for the other account. If both ports fail, ask the user to verify that TWS or IB Gateway is running with API access enabled.

Instructions

First, get available expiration dates:

bash
uv run python scripts/options.py SYMBOL --expiries

Then fetch the chain for a specific expiry:

bash
uv run python scripts/options.py SYMBOL --expiry YYYYMMDD
Show full SKILL.md (188 more words)Show less

Arguments

  • SYMBOL - Ticker symbol. Equity/ETF (e.g., AAPL, SPY, TSLA) or futures root (e.g., NQ, ES, CL, GC) — asset type is auto-detected via IB.
  • --sec-type {stk,fut} - Force the asset type. Default: auto-detect (stock-first). Use fut for ambiguous roots like ES/CL when you mean the future.
  • --expiries - List available expiration dates only
  • --expiry YYYYMMDD - Fetch chain for specific date (IB format: YYYYMMDD, no dashes)
  • --port - IB port (default: 7497 for paper trading)

Output

Returns JSON with:

  • calls - Array of call options with strike, bid, ask, lastPrice, volume, openInterest, impliedVolatility, greeks (delta/gamma/theta/vega/iv from IB model), and multiplier (futures only)
  • puts - Array of put options with same fields
  • underlying_price - Current underlying price for reference (stock/ETF price or continuous-future price)
  • asset_type - "stock" or "future"
  • source - "ibkr"

For futures, only expiries up to the front continuous-future's expiry are returned; longer-dated FOPs require the next quarter's future. Futures quote nearly 24h on Globex, so Greeks populate pre-market.

Present data as a table. Highlight high volume strikes and notable IV levels.

Dependencies

  • ib-async

Timezone

All timestamps and time-based calculations must use the America/New_York timezone. All JSON output must include generated_at (NY time string) and data_delay fields.

© staskh, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in .claude/skills/ib-option-chain of staskh/trading_skills.

  • SKILL.md
  • scripts/options.py

Open the folder on GitHubat commit b71a74f

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in staskh/trading_skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Ib Option Chain next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ib Option Chain compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ib Option Chain this skillstaskh/trading_skills3741 repos~873Automated safety check: NotesMIT
Stock APIzhangxiangliang/stock-api2k—~507Automated safety check: PassMIT
Tushare Datazillionare/zillionare3192 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp5k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle870—~5.9kAutomated safety check: PassMIT
Longbridge Researchhelsome/folio2693 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Stock API

    zhangxiangliang/stock-api

    Fetch real-time stock quotes, K-line (candlestick) history, and search symbols for China A-shares, Hong Kong, and US markets.

    2k GitHub stars~507 tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    319 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    5k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    870 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Longbridge Research

    helsome/folio

    Institution ratings, consensus price targets, EPS/revenue forecasts, finance calendar, shareholder data, fund holders, insider trades (SEC Form 4), short interest, industry rankings, peer group…

    269 GitHub starsUsed in 3 repos~2.1k tokens
    Business, Finance & HRAuto-check passed
  • Longbridge Earnings

    helsome/folio

    Earnings analysis — pre- and post-earnings. An agent skill from helsome/folio.

    269 GitHub starsUsed in 1 repo~2.5k tokens
    Business, Finance & HRAuto-check passed

More from staskh/trading_skills

All 28 skills in this repo
  • Fundamentals

    staskh/trading_skills

    Get fundamental financial data including financials, earnings, and key metrics.

    374 GitHub starsUsed in 1 repo~836 tokens
    Auto-check passed
  • Greeks

    staskh/trading_skills

    Calculate option Greeks (delta, gamma, theta, vega) and implied volatility for specific options.

    374 GitHub starsUsed in 1 repo~539 tokens
    Auto-check passed
  • Ib Account

    staskh/trading_skills

    Get account summary from Interactive Brokers including cash balance, buying power, and account value.

    374 GitHub starsUsed in 1 repo~535 tokens
    Auto-check: notes
  • Ib Find Short Roll

    staskh/trading_skills

    Find roll options for existing short positions OR find best covered call/put to open against long stock.

    374 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: notes
  • Ib Portfolio

    staskh/trading_skills

    Get portfolio positions from Interactive Brokers. An agent skill from staskh/trading_skills.

    374 GitHub starsUsed in 1 repo~471 tokens
    Auto-check: notes
  • Ib Portfolio Action Report

    staskh/trading_skills

    Generate a comprehensive portfolio action report with earnings dates and risk assessment.

    374 GitHub starsUsed in 1 repo~1k tokens
    Auto-check: notes

Questions about Ib Option Chain

What does Ib Option Chain do?

Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks. Ib Option Chain is an agent skill from staskh/trading_skills. Get option chain data from Interactive Brokers for equities, ETFs, and futures (FOP), including calls and puts with strikes, bids, asks, volume, implied volatility, and model Greeks.

When should I use Ib Option Chain?

Ib Option Chain fits situations like: user asks about options using IBKR data; futures options (NQ/ES/CL/GC...); needs real-time option quotes from their broker.

How do I install Ib Option Chain in Claude Code?

Run `npx skills add staskh/trading_skills --skill ib-option-chain -a claude-code`. Or copy the skill folder (.claude/skills/ib-option-chain in staskh/trading_skills) into .claude/skills/ib-option-chain in your project. Claude Code loads it when a task matches its description.

How do I install Ib Option Chain in Codex?

Run `npx skills add staskh/trading_skills --skill ib-option-chain -a codex`. Or copy the skill folder (.claude/skills/ib-option-chain in staskh/trading_skills) into .agents/skills/ib-option-chain in your project. Codex loads it when a task matches its description.

Can I use Ib Option Chain in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add staskh/trading_skills --skill ib-option-chain -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ib-option-chain, .gemini/skills/ib-option-chain, .github/skills/ib-option-chain and .opencode/skills/ib-option-chain in your project.

What does Ib Option Chain need to run?

Going by SKILL.md and its folder, Ib Option Chain needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Ib Option Chain access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ib Option Chain safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ib Option Chain use?

Ib Option Chain is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ib Option Chain use?

About 873 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ib Option Chain?

Skills that share tags, products or a category with Ib Option Chain: Stock API (zhangxiangliang/stock-api, 2k stars), Tushare Data (zillionare/zillionare, 319 stars), Tradingview MCP (atilaahmettaner/tradingview-mcp, 5k stars) and Digital Oracle (komako-workshop/digital-oracle, 870 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ib Option Chain?

staskh (a GitHub user) maintains it in staskh/trading_skills, which has 374 GitHub stars. The repository holds 28 skills in this directory. The repository was last updated on September 28, 2026.

Source: staskh/trading_skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.