# Bullflow Options Top Tickers

> Bullflow Options Top Tickers is a paid API for AI agents from api.bullflow.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-29).

Returns the top stock tickers ranked by unusual options flow activity (volume, premium, or net premium) for a given trading date or date range.

## Facts

- Endpoint: GET https://api.bullflow.io/v1/data/optionsTopTickers?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bullflow-options-top-tickers-0e7bfa99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vJoYrbJ9Xz4x_JzcT1DX5

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bullflow-options-top-tickers-0e7bfa99
```

Example prompt: Pull the top 20 tickers from Bullflow's unusual options flow for today, ranked by premium, and exclude ETFs — I want to see which stocks have the heaviest unusual call and put activity.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of tickers by unusual options activity — not individual trade-level data. Ideal for daily market scans, momentum screening, or identifying where institutional or smart-money options interest is concentrated. Choose this over raw flow endpoints when you want pre-aggregated, ranked summaries across a trading session or date range.

## Known failure modes

- Invalid date format returns a validation error
- Date range exceeding 30 calendar days is rejected
- Mixing 'date' with 'from'/'to' parameters causes an error
- No trading data available for weekends or market holidays returns empty rows
- Invalid metric enum value causes a schema validation error
- ticker_count values outside the allowed enum (10,20,30,40,50) are rejected

## How this service works

Bullflow.io is a real-time unusual options flow and dark pool tracker with advanced tools to view, filter, and analyze market activity as it happens.

## Output

A JSON object containing ranked rows of ticker symbols with their aggregated call/put volume, call/put premium, net premium, and ranked side (bullish or bearish), along with metadata such as trading date, applied filters, total source trade count, matched trade count, and the metric used for ranking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "to": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Inclusive end date. Supply with from; maximum range is 30 calendar days."
      },
      "date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Trading date in YYYY-MM-DD format."
      },
      "from": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "Inclusive start date. Supply with to; do not combine with date."
      },
      "metric": {
       "enum": [
        "volume",
        "premium",
        "net_premium"
       ],
       "type": "string",
       "default": "premium"
      },
      "sweeps_only": {
       "type": "boolean",
       "default": false
      },
      "exclude_etfs": {
       "type": "boolean",
       "default": false
      },
      "ticker_count": {
       "enum": [
        10,
        20,
        30,
        40,
        50
       ],
       "type": "integer",
       "default": 20
      },
      "bullish_bearish": {
       "type": "boolean",
       "default": false,
       "description": "Balance bullish and bearish leaders when metric=net_premium."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "tradingDate",
      "from",
      "to",
      "generatedAt",
      "metric",
      "tickerCount",
      "filters",
      "sourceTradeCount",
      "matchedTradeCount",
      "count",
      "rows"
     ],
     "properties": {
      "to": {
       "type": "string",
       "description": "Trading date in YYYY-MM-DD format."
      },
      "from": {
       "type": "string",
       "description": "Trading date in YYYY-MM-DD format."
      },
      "rows": {
       "type": "array",
       "items": {
        "type": "object",
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-10-14",
  "from": "2026-10-14",
  "rows": [],
  "count": 0,
  "metric": "premium",
  "filters": {
   "sweepsOnly": false,
   "excludeEtfs": false,
   "bullishBearish": false
  },
  "generatedAt": "2026-10-14T19:00:00Z",
  "tickerCount": 20,
  "tradingDate": "2026-10-14",
  "sourceTradeCount": 0,
  "matchedTradeCount": 0
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bullflow-options-top-tickers-0e7bfa99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.bullflow.io](https://www.zero.xyz/host/api.bullflow.io/llms.txt)