Options Flow API for Developers & AI Agents
Query recent options-flow alerts and contract prints through Pineify MCP. Compare market and sector snapshots, retaining observation times, missing values and result limits.
Connect Flow Data Directly to Your AI Stack
Use a client that supports remote Streamable HTTP and Bearer authentication. Add the endpoint, initialize the connection, and inspect tools/list before making a call. The configuration example is client-dependent; the JSON body is for an already initialized client, not a standalone HTTP command.
- Keep the token in your client secret settings, outside shared code.
- Use camelCase arguments exactly as the discovered schema defines.
- Inspect structuredContent, partial, warnings and snapshot times.
- Treat null fields and unavailable components as missing evidence.
{
"mcpServers": {
"pineify": {
"url": "https://agents.pineify.app/mcp",
"headers": {
"Authorization": "Bearer YOUR_PINEIFY_API_TOKEN"
}
}
}
}Available Options Flow MCP Tools
Four read-only tools for distinct research tasks. Results are bounded snapshots, not an unfiltered exchange tape.
Find a bounded set of recent alerts for up to ten US symbols. Sentiment is a derived label, not participant identity or a price forecast.
Key Parameters:
Use an exact contractId returned by the alert tool to inspect recent prints, NBBO fields and available Greeks with source-print provenance. Missing values remain null.
Key Parameters:
Get one market-date snapshot or bounded intraday series plus top-impact symbols. This tool does not return sector detail.
Key Parameters:
Compare eleven latest sector ETF contract snapshots. An optional selected-sector series covers constituent options; these are different scopes and can have different observation dates.
Key Parameters:
Choose the right query and inspect its limits
Use the returned schema and provenance to decide whether the data answers your question. These tools do not place orders.
| Capability | Returned scope | Input / output detail | Interpretation limit |
|---|---|---|---|
| Recent flow alerts | Observed alert records and derived sentiment | symbols, optionType, premium, DTE and flags | Check partial, warnings and page.truncated; no continuation cursor. |
| Contract prints | Exact returned contractId | Recent prints; nullable Greeks and NBBO | Do not invent an O: prefix or assume every Greek is present. |
| Market tide | One date; summary or bounded series | pointLimit only with detail=series | Observed flow is not a forecast or a complete options tape. |
| Sector snapshot | Latest sector ETF contract flow | Optional constituent-options tide for one sector | marketDate does not date-filter the eleven latest ETF rows. |
| Access | Expert or above; Bearer authentication | MCP initialization, discovery and tool calls | Rate limits and service availability apply; check current plan terms. |
References: MCP Streamable HTTP transport, TradingView data request scope, and Pineify MCP setup. Tool names and arguments were checked against the current Pineify schemas on October 21, 2026.
Frequently Asked Questions
Answers to common questions about options flow APIs, MCP integration, and data formats.
Connect a research client to Pineify MCP
Check authentication and plan access, discover the current schemas, then query a small result set and inspect its provenance.