Files
Casey Judice dfdfe8414d IBKR daily scanner: correct YES+NO conid schema + discover helper
Earlier ibkr.py assumed each strike = one conid (buy=Yes / sell=No). The
IBKR ForecastEx CP API actually exposes each strike as TWO separate conids
(YES = right=CALL, NO = right=PUT). Local symbol shape is
CFBTC_MMDDYYHH_<strike>_<YES|NO> e.g. CFBTC_05242616_71000_YES means
4pm ET May 24 2026, $71,000 YES side.

- data/ibkr_contracts.example.json: per entry now has yes_conid + no_conid
  + strike + close_iso + label (one row per strike).
- arb/daily.py: snapshots both conids in one batch; yes_ask/no_ask come
  directly from each side's ask (no more 1-bid derivation).
- scripts/discover_ibkr.py: walks /iserver/secdef/strikes + secdef/info to
  print the full YES/NO ladder for a given underlying + month + maturity.
  Filters by maturityDate so it doesn't mix expiries.

End-to-end verified: 3 sample strikes pair cleanly to KXBTCD-26MAY2416
(IBKR $71K -> Kalshi T70999.99 etc.). Live prices still pending the
user's ForecastEx market-data subscription / strikes closer to spot.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 10:19:26 -04:00

87 lines
3.3 KiB
Python

#!/usr/bin/env python3
"""Discover IBKR ForecastEx YES/NO conid pairs for a given asset + maturity.
Usage:
python3 scripts/discover_ibkr.py [SYMBOL] [MONTH] [MATURITY_YYYYMMDD]
Defaults: SYMBOL=CFBTC, MONTH=MAY26, MATURITY=20260524
Prints a JSON list of {strike, yes_conid, no_conid, maturity} entries you can
paste into data/ibkr_contracts.json (filling in close_iso + label per row).
Requires the Client Portal Gateway running and authenticated.
"""
import json
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
sys.path.insert(0, str(ROOT))
from arb.ibkr import _req, auth_status, search
def main():
sym = sys.argv[1] if len(sys.argv) > 1 else "CFBTC"
month = sys.argv[2] if len(sys.argv) > 2 else "MAY26"
maturity = sys.argv[3] if len(sys.argv) > 3 else "20260524"
s = auth_status()
if not s.get("authenticated"):
print("Gateway not authenticated. Sign in at https://localhost:5000",
file=sys.stderr)
sys.exit(1)
# 1. find the underlying event conid
hits = search(sym)
under = None
for h in hits:
for sec in h.get("sections") or []:
if sec.get("secType") == "EC": # Event Contract
under = h.get("conid")
break
if under: break
if not under:
print("could not find underlying event conid for %s" % sym, file=sys.stderr)
sys.exit(1)
print("# underlying: %s conid=%s" % (sym, under), file=sys.stderr)
# 2. fetch the strike ladder
strikes = _req("GET", "/iserver/secdef/strikes?conid=%s&sectype=OPT"
"&month=%s&exchange=FORECASTX" % (under, month)) or {}
all_strikes = sorted(set((strikes.get("call") or []) +
(strikes.get("put") or [])))
print("# %d strikes in %s" % (len(all_strikes), month), file=sys.stderr)
# 3. for each strike, secdef/info gives back the per-side conid; we filter
# by maturity to drop other expiries that come back from the same query.
out = []
for k in all_strikes:
try:
yes = _req("GET", "/iserver/secdef/info?conid=%s&sectype=OPT"
"&month=%s&strike=%s&right=C&exchange=FORECASTX"
% (under, month, k)) or []
no = _req("GET", "/iserver/secdef/info?conid=%s&sectype=OPT"
"&month=%s&strike=%s&right=P&exchange=FORECASTX"
% (under, month, k)) or []
except Exception as e:
print("# strike=%s err: %s" % (k, e), file=sys.stderr)
continue
yes = yes if isinstance(yes, list) else [yes]
no = no if isinstance(no, list) else [no]
ycid = next((x.get("conid") for x in yes
if str(x.get("maturityDate") or x.get("maturity_date") or
"") == maturity), None)
ncid = next((x.get("conid") for x in no
if str(x.get("maturityDate") or x.get("maturity_date") or
"") == maturity), None)
if ycid and ncid:
out.append({"strike": k, "yes_conid": ycid, "no_conid": ncid,
"maturity": maturity})
print(json.dumps(out, indent=2))
print("# wrote %d strike pair(s) for maturity %s" % (len(out), maturity),
file=sys.stderr)
if __name__ == "__main__":
main()