Skip to main content

​
Overview

AhamFlow ingests daily Unusual Whales (UW) end-of-day data across four categories:
  • Flow Alerts — unusual options activity with sweep/cross/multileg classification
  • Dark Pool Prints — off-exchange block trades with NBBO context
  • OI Changes — daily open interest changes per contract
  • Earnings Calendar — upcoming earnings with implied move and IV rank

​
Flow Alerts

Find unusual options activity by ticker, premium, or volume/OI ratio: 
# Large premium trades on AAPL
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/flow-alerts?ticker=AAPL&min_premium=1000000&limit=10"
Key fields in the response:
  • sweep_volume — aggressive sweep orders across exchanges
  • cross_volume — matched buyer/seller trades
  • premium — total dollar premium
  • iv — implied volatility at time of trade

​
Dark Pool

Query recent dark pool prints or get aggregated stats per ticker: 
# Recent large dark pool prints
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/darkpool-recent?ticker=SPY&limit=20"

# Aggregated dark pool stats for AAPL
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/darkpool-ticker?ticker=AAPL"
The ticker endpoint returns total prints, shares, notional value, and price range.

​
OI Changes

Track open interest changes to spot large position builds: 
# All AAPL options with OI changes
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/chain?ticker=AAPL"

# Filter by expiry
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/chain?ticker=AAPL&expiry=2026-04-17"

​
Earnings Calendar

Find upcoming earnings with IV context: 
curl -H "x-api-key: $KEY" \
  "https://api.ahamflow.dev/api/v1/options/earnings-calendar"
Returns iv_rank, implied_move, and put/call volume for each ticker with a known earnings date.