Bullflow Market Data API

Checks and payment terms on this page refer to the first endpoint's example. Other endpoints have not been checked individually.

Base URLhttps://api.bullflow.io/v1

• GET/data/darkPoolTrades$0.01Dark pool trades. One page of dark pool trades for an inclusive date range of at most 30 days. Follow nextCursor to retrieve additional pages.
  6 parameters and an example

  • toquery, required2026-10-14Inclusive end date. Supply with from; maximum range is 30 calendar days.
  • fromquery, required2026-10-14Inclusive start date. Supply with to; do not combine with date.
  • limitquery10Maximum number of records in this page.
  • cursorqueryUse nextCursor from the previous page with the same filters.
  • tickerquerySPYUnderlying stock, ETF, or supported index ticker.
  • minNotionalqueryMinimum trade notional in USD.

  curl -i 'https://api.bullflow.io/v1/data/darkPoolTrades?to=2026-10-14&from=2026-10-14&limit=10&ticker=SPY'

• GET/data/eodGex$0.01End-of-day gamma exposure. Closing gamma exposure by strike and expiration. Defaults to the latest eligible trading session; each session becomes eligible after 17:15 America/New_York. date and open_interest_date identify the represented sessions.
  2 parameters and an example

  • datequeryTrading date in YYYY-MM-DD format.
  • tickerquery, requiredSPYUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/eodGex?ticker=SPY'

• GET/data/gexAlerts$0.01Gamma exposure alerts. Near-node and largest-node movement alerts for the closest options expiration. Defaults to the current U.S. Eastern date; days without alerts return an empty list. Supply date or a from/to range of at most 30 days.
  7 parameters and an example

  • toqueryInclusive end date. Supply with from; maximum range is 30 calendar days.
  • datequeryTrading date in YYYY-MM-DD format.
  • fromqueryInclusive start date. Supply with to; do not combine with date.
  • typequery
  • limitqueryMaximum number of records in this page.
  • cursorqueryUse nextCursor from the previous page with the same filters.
  • tickerqueryUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/gexAlerts'

• GET/data/lastTradePrice$0.01Latest trade price. Latest available trade price for a stock or supported index. timestamp is the trade time when available; market closures can leave the latest trade in an earlier session.
  1 parameter and an example

  • tickerquery, requiredSPYUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/lastTradePrice?ticker=SPY'

• GET/data/netPremiumSeries$0.01Net premium time series. Cumulative call and put net premium over the selected period or date range. Premium values are in USD.
  6 parameters and an example

  • toqueryInclusive end date for a custom range; supply with from.
  • fromqueryInclusive start date for a custom range; supply with to.
  • periodquery1D
  • tickerquery, requiredSPYUnderlying stock, ETF, or supported index ticker.
  • sweeps_onlyquery
  • include_multilegquery

  curl -i 'https://api.bullflow.io/v1/data/netPremiumSeries?period=1D&ticker=SPY'

• GET/data/netgex$0.01Net gamma exposure. Gamma exposure by strike and expiration. Uses open interest by default; type=volume uses cumulative contract volume from the current or most recent trading day. Check as_of for response timing.
  2 parameters and an example

  • typequery
  • tickerquery, requiredSPYUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/netgex?ticker=SPY'

• GET/data/netvex$0.01Net vanna exposure. Vanna exposure by strike and expiration, with the underlying spot price and response timestamp.
  1 parameter and an example

  • tickerquery, requiredSPYUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/netvex?ticker=SPY'

• GET/data/optionsProfile$0.01Ticker options activity profile. Recorded options volume, premium, execution-side activity, relative-volume ratios, and unusual contracts for the latest available session. Ratios can be null when comparison history is insufficient; coverage is not a complete market-wide total.
  1 parameter and an example

  • symbolquery, requiredSPYUnderlying stock, ETF, or supported index ticker.

  curl -i 'https://api.bullflow.io/v1/data/optionsProfile?symbol=SPY'

• GET/data/optionsTopTickers$0.01Top options tickers. Rank tickers by recorded options volume, premium, or directional net premium. Choose date or an inclusive from/to range of at most 30 days. With no dates, uses the latest available session.
  8 parameters and an example

  • toqueryInclusive end date. Supply with from; maximum range is 30 calendar days.
  • datequeryTrading date in YYYY-MM-DD format.
  • fromqueryInclusive start date. Supply with to; do not combine with date.
  • metricquery
  • sweeps_onlyquery
  • exclude_etfsquery
  • ticker_countquery
  • bullish_bearishqueryBalance bullish and bearish leaders when metric=net_premium.

  curl -i 'https://api.bullflow.io/v1/data/optionsTopTickers'

• GET/data/peakReturn$0.01Option peak return. Highest option price and percent return observed after the supplied trade timestamp, relative to the entry price.
  3 parameters and an example

  • symquery, requiredO:SPY261016C00650000Option contract symbol, for example O:SPY261016C00650000.
  • old_pricequery, required1.35Entry price in USD per share.
  • trade_timestampquery, required1791984600Trade Unix timestamp in seconds.

  curl -i 'https://api.bullflow.io/v1/data/peakReturn?sym=O%3ASPY261016C00650000&old_price=1.35&trade_timestamp=1791984600'

• GET/gexClosingSnapshotSummaryFreeFree closing GEX summary
  Example

  curl -i 'https://api.bullflow.io/v1/gexClosingSnapshotSummary'

• GET/gexClosingSnapshotsFreeFree closing GEX availability
  Example

  curl -i 'https://api.bullflow.io/v1/gexClosingSnapshots'

• GET/gexDelayedSnapshotFreeFree 15-minute-delayed GEX snapshot
  Example

  curl -i 'https://api.bullflow.io/v1/gexDelayedSnapshot'

• GET/gexDelayedSnapshotsFreeFree delayed GEX availability
  Example

  curl -i 'https://api.bullflow.io/v1/gexDelayedSnapshots'

• GET/optionsFlowClosingSnapshotSummaryFreeFree closing options-flow summary
  Example

  curl -i 'https://api.bullflow.io/v1/optionsFlowClosingSnapshotSummary'

• GET/optionsFlowClosingSnapshotsFreeFree closing options-flow availability
  Example

  curl -i 'https://api.bullflow.io/v1/optionsFlowClosingSnapshots'

• GET/optionsFlowRelatedTickersFreeFree related options-flow summaries
  Example

  curl -i 'https://api.bullflow.io/v1/optionsFlowRelatedTickers'

A dash means the listing gives no price or method. {Braces} mark a value you fill in. Copy buttons copy an example URL.