← Back to Skills Marketplace
ssidharhubble

Options Flow Intelligence

by ssyopro · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
47
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install options-flow-intelligence
Description
Real-time institutional options flow intelligence and momentum analysis for AI agents. Fetches live option flow data from OptionWhales API including current...
README (SKILL.md)

Options Flow Intelligence

Fetches real-time institutional options flow data from the OptionWhales API to detect whale trades, momentum shifts, and abnormal activity across US equities.

Setup

Set your API key:

export OPTIONWHALES_API_KEY="your_key_here"

Commands

# Market-wide flow (top 20 by momentum)
python scripts/optionflow.py flow

# Top momentum stocks
python scripts/optionflow.py momentum

# Abnormal trades (potential insider activity)
python scripts/optionflow.py abnormal

# Specific ticker deep dive
python scripts/optionflow.py ticker AAPL
python scripts/optionflow.py ticker TSLA
python scripts/optionflow.py ticker NVDA

Output Interpretation

  • Signal scores range from 0-100, higher = stronger institutional conviction
  • Direction shows whether smart money is buying calls (bullish) or puts (bearish)
  • Premium shows total dollar value of options activity
  • Momentum rankings show which stocks have the strongest options activity today

Integration with Trading Systems

The JSON output can be piped to other tools:

python scripts/optionflow.py flow | grep "BULLISH" | head -5

Use in automated alerting by setting up cron jobs or integrating with notification systems.

Data Freshness

Data refreshes every few minutes. For real-time streaming, consider the WebSocket API which is available on OptionWhales Pro plans. The current script focuses on REST API polling which is suitable for most use cases without requiring WebSocket infrastructure.

Usage Guidance
Before installing, confirm you are comfortable giving the skill access to an OptionWhales API key. The code appears purpose-aligned and only calls the stated OptionWhales API, but the source is unknown and the credential requirement is not fully reflected in registry metadata.
Capability Analysis
Type: OpenClaw Skill Name: options-flow-intelligence Version: 1.0.0 The skill is a straightforward API client for fetching financial market data from 'api.optionwhales.com'. The Python script (scripts/optionflow.py) uses only standard libraries to perform authenticated GET requests and contains no evidence of data exfiltration, malicious execution, or prompt injection.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The bundled script is coherent with the stated purpose: it fetches market-wide, ticker, momentum, and abnormal-options-flow data from OptionWhales. It does require external API access and a provider API key.
Instruction Scope
The skill instructs the agent/user to run a local Python script through Bash, which is expected for this command-line data-fetching skill. No destructive or account-mutating actions are shown.
Install Mechanism
There is no install script or dependency installation, and the included Python code uses only the standard library. The source/homepage are not provided, so users should verify the publisher before supplying credentials.
Credentials
The skill requires OPTIONWHALES_API_KEY and sends it to api.optionwhales.com, which is proportionate to the stated OptionWhales integration. Registry requirements list no env vars or primary credential, so the credential requirement is under-declared in metadata.
Persistence & Privilege
The code does not install persistence, request elevated privileges, modify local state, or create background jobs. Documentation mentions cron only as a user-directed optional alerting setup.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install options-flow-intelligence
  3. After installation, invoke the skill by name or use /options-flow-intelligence
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of options-flow-intelligence - Provides real-time institutional options flow and momentum analytics for US equities. - Integrates with OptionWhales API to surface whale trades, momentum shifts, and abnormal activity. - Supports commands for market-wide flow, momentum rankings, abnormal trades, and single ticker analysis. - Outputs include intent_momentum scores, premium volumes, direction bias, and momentum rankings. - Simple setup with only Python 3.7+ and an OptionWhales API key required (no additional dependencies).
Metadata
Slug options-flow-intelligence
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Options Flow Intelligence?

Real-time institutional options flow intelligence and momentum analysis for AI agents. Fetches live option flow data from OptionWhales API including current... It is an AI Agent Skill for Claude Code / OpenClaw, with 47 downloads so far.

How do I install Options Flow Intelligence?

Run "/install options-flow-intelligence" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Options Flow Intelligence free?

Yes, Options Flow Intelligence is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Options Flow Intelligence support?

Options Flow Intelligence is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Options Flow Intelligence?

It is built and maintained by ssyopro (@ssidharhubble); the current version is v1.0.0.

💬 Comments