unusual-whales

Query unusual options flow and market data through a backend proxy.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/EternisAI/agent-sandbox --skill unusual-whales
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unusual-whales
Source: https://github.com/EternisAI/agent-sandbox/tree/main/skills/unusual-whales
Command: npx skills add https://github.com/EternisAI/agent-sandbox --skill unusual-whales

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables centralized, proxy-based access to unusual options flow and related market data, avoiding direct vendor endpoints and simplifying integration.

Core Features & Use Cases

  • Access live flow alerts, screener data, market tide, dark pool prints, and earnings history through a backend proxy.
  • Support for common workflows like monitoring whale trades, identifying unusual activity, and building alerting dashboards for stock tickers.

Quick Start

Query the unusual-whales proxy endpoints to fetch a live flow alert or option screener using the provided endpoints.

Frequently Asked Questions about unusual-whales

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor unusual options flow through a proxy instead of direct vendor endpoints?

You can monitor unusual options flow by routing GET requests through a backend proxy to fetch live flow alerts, option screeners, and dark pool prints without connecting to direct vendor endpoints.

What market data can I query for unusual options activity?

You can query unusual options activity endpoints for flow alerts, option contracts screener data, market tide, dark pool prints, and earnings history to enable real-time research across stock tickers.

How do I authenticate API requests for unusual options flow data?

Authenticate unusual options flow requests by sending GET only methods with an Authorization Bearer API key and including the UW-CLIENT-API-ID header to access the proxy endpoints.

Why does my unusual options activity query return empty results?

Unusual options activity queries return predictable empty results on weekends or when filtering with invalid stock tickers, as market data is only generated during active trading hours.

Can I use limit and filter parameters when querying options flow alerts?

Yes, you can apply limit and filter parameters to your options flow alert requests to narrow down the returned market data and focus on specific stock tickers or activity thresholds.

What's the best way to build an alerting dashboard for whale trades?

Build a whale trades alerting dashboard by querying the proxy endpoints for live flow alerts and dark pool prints, then configuring limit and filter parameters to monitor specific stock tickers.