Skip to content

feat: add broker-neutral derivative discovery - #51

Merged
felipecsl merged 2 commits into
mainfrom
agent/derivative-capability-46
Jul 29, 2026
Merged

feat: add broker-neutral derivative discovery#51
felipecsl merged 2 commits into
mainfrom
agent/derivative-capability-46

Conversation

@felipecsl

Copy link
Copy Markdown
Member

Context

Raw IBKR scripts were previously required to distinguish NQ futures options and alternate index trading classes. This implements issue #46 using a capability-specific boundary rather than widening the shared account-oriented broker client.

What changed

  • defines durable derivative expiry, contract, quote, and market-data availability contracts
  • adds an IBKR adapter that keeps conids as opaque broker references
  • adds a memoized derivative capability resolver with clear unsupported-broker errors
  • preserves exact asset class, trading class, exchange, multiplier, settlement, and exercise metadata
  • covers real captured NQ QN3 and NDX/NDXP response shapes without invented provider fields
  • consumes the published @huskly/ibkr-client@^0.8.0 capability directly

Safety and compatibility

Discovery exposes no placement, What-If, warning-reply, cancellation, or raw-endpoint surface. Ambiguous identity and unusable chains fail closed. Existing Schwab commands remain unchanged.

Validation

  • yarn run check
  • yarn build
  • 7 test files passed

Closes #46

@felipecsl
felipecsl merged commit 1fc466c into main Jul 29, 2026
1 check passed
@felipecsl
felipecsl deleted the agent/derivative-capability-46 branch July 29, 2026 20:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add broker-neutral derivative identity and IBKR OPT/FOP discovery capabilities

1 participant