# Bullflow Unusual Options Flow - Options Profile

> Bullflow Unusual Options Flow - Options Profile 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 a real-time options activity profile for a given ticker, including volume, premium, execution, concentration, and unusual contract data.

## Facts

- Endpoint: GET https://api.bullflow.io/v1/data/optionsProfile?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-unusual-options-flow-options-profile-828d661c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kDpQyP1XuQT04Ahh31_Un

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-unusual-options-flow-options-profile-828d661c
```

Example prompt: Pull up the Bullflow options profile for SPY right now — I want to see if there's a call volume spike, sweep activity, any unusual contracts, and what the net directional premium looks like.

## When to prefer this

Use this endpoint when you need a comprehensive, real-time options activity snapshot for a specific ticker — especially for detecting unusual flow, sweep trades, directional premium imbalances, or call/put volume spikes. Prefer this over generic financial data APIs when the goal is identifying unusual or institutional options behavior rather than basic price/volume stock data.

## Known failure modes

- Invalid or unsupported ticker symbol returns empty or null activity data
- Non-market-hours requests may return zero-activity results with NO_RECORDED_ACTIVITY flag
- Insufficient historical data triggers INSUFFICIENT_HISTORY flag with null relative volume fields
- Missing required 'symbol' query parameter causes a validation error
- Rate limiting or payment failure returns a 402 status requiring payment

## 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 the ticker symbol, trading date, timestamp of latest data, volume metrics (total, call, put, relative daily and intraday), premium totals (total, call, put, net directional), execution side percentages (ask-side for calls and puts), concentration metrics (sweep premium, sweep volume percent, short-dated volume percent), a list of unusual contracts, the largest premium trade, and an array of activity flags such as CALL_VOLUME_SPIKE, PUT_VOLUME_SPIKE, CALL_BUYING_SURGE, or UNUSUAL_WEEKLY_ACTIVITY.

## 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": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "examples": [
        "SPY"
       ],
       "description": "Underlying stock, ETF, or supported index ticker."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "symbol",
      "tradingDate",
      "asOf",
      "activity",
      "premium",
      "execution",
      "concentration",
      "unusualContracts",
      "largestPremiumTrade",
      "flags"
     ],
     "properties": {
      "asOf": {
       "type": "string",
       "description": "Latest recorded trade time across tickers in the selected session; the intraday comparison uses its Eastern time."
      },
      "flags": {
       "type": "array",
       "items": {
        "enum": [
         "INSUFFICIENT_HISTORY",
         "NO_RECORDED_ACTIVITY",
         "CALL_VOLUME_SPIKE",
         "PUT_VOLUME_SPIKE",
         "CALL_BUYING_SURGE",
         "UNUSUAL_WEEKLY_ACTIVITY"
        ],
        "type": "string"
       }
      },
      "symbol": {
       "type": "string"
      },
      "premium": {
       "type": "object",
       "required": [
        "totalPremium",
        "callPremium",
        "putPremium",
        "netDirectionalPremium"
       ],
       "properties": {
        "putPremium": {
         "type": "number",
         "description": "Amount in US dollars."
        },
        "callPremium": {
         "type": "number",
         "description": "Amount in US dollars."
        },
        "totalPremium": {
         "type": "number",
         "description": "Amount in US dollars."
        },
        "netDirectionalPremium": {
         "type": "number",
         "description": "Amount in US dollars."
        }
       },
       "description": "Totals include multi-leg trades. Directional premium excludes multi-
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-10-14T19:00:00Z",
  "flags": [
   "NO_RECORDED_ACTIVITY",
   "INSUFFICIENT_HISTORY"
  ],
  "symbol": "SPY",
  "premium": {
   "putPremium": 0,
   "callPremium": 0,
   "totalPremium": 0,
   "netDirectionalPremium": 0
  },
  "activity": {
   "putVolume": 0,
   "callVolume": 0,
   "totalVolume": 0,
   "putCallRatio": null,
   "relativeVolumeDaily": null,
   "putRelativeVolumeDaily": null,
   "relativeVolumeIntraday": null,
   "callRelativeVolumeDaily": null,
   "putRelativeVolumeIntraday": null,
   "callRelativeVolumeIntraday": null
  },
  "execution": {
   "putAskSidePercent": null,
   "callAskSidePercent": null
  },
  "tradingDate": "2026-10-14",
  "concentration": {
   "sweepPremium": 0,
   "sweepVolumePercent": null,
   "shortDatedVolumePercent": null
  },
  "unusualContracts": [],
  "largestPremiumTrade": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bullflow-unusual-options-flow-options-profile-828d661c/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)