What contract ID does get-option-contract-flow accept?

It accepts the exact contract ID returned by an options-flow alert. The tool does not translate a ticker, strike, call or put selection, and expiry into an identifier, so copy a non-null contractId such as AAPL260821C00220000 without editing it.

Are the returned option Greeks live?

No, the Greeks are the latest available values attached to a sourced print, not a guaranteed live calculation. Check latestGreeks.sourcePrintId and sourceObservedAt, and expect individual values or the entire latestGreeks object to be null.

Does an ask-side print mean the trade is bullish?

No, an ask-side print does not prove bullish intent. The side filter describes where a print occurred relative to the NBBO, while spreads, closing trades, hedges, multi-leg activity, and later cancellations can change the interpretation.

How much option contract history can the MCP tool return?

It returns up to 50 recent prints for the latest available session or one supported requested market date. The response can be partial, fields can be null, and the endpoint does not provide a complete historical tape.

Can this option Greeks MCP tool predict stock prices?

No, this option Greeks MCP tool cannot predict stock prices. It provides bounded observations for research and does not promise returns, recommend a trade, calculate a strategy payoff, or place an order.

Can AI predict stock prices with this MCP tool?

No. AI cannot predict stock prices with certainty, and this MCP tool does not promise future returns. It gives an agent bounded data or validation results that still require independent review, risk controls, and source checking.

Market analysis

Option Contract Flow MCP Tool for Recent Prints and Greeks

Pineify get-option-contract-flow is a read-only MCP tool that retrieves recent prints and the latest available Greeks for one exact option contract ID. It is designed as the drill-down step after an options-flow alert returns that ID.

Connect Pineify MCP View all MCP tools

MCP tool name

get-option-contract-flow

Example prompt

Use Pineify to find recent AAPL options-flow alerts, then inspect the prints and latest available Greeks for the exact contract ID returned by the alert.

Direct answer

What get-option-contract-flow does

Use this tool when an options-flow alert identifies a contract worth inspecting. Pass the returned contractId without rebuilding it from a ticker, strike, or expiry.

Each print can include execution time, price, contract size, premium, bid and ask at the NBBO, exchange, tags, cancellation status, underlying price, and nullable Greeks. The result also identifies the market date, retrieval time, and whether the latest session or a requested date was selected.

The latestGreeks object names the source print and its observed time. That provenance matters because delta, gamma, theta, vega, rho, implied volatility, or theoretical value can be unavailable and should not be treated as a live quote.

Contract

What the agent sends and receives

Inputs

contractId: required exact contract ID, 1 to 128 characters, using only letters, numbers, periods, underscores, and hyphens
marketDate: optional supported market date in YYYY-MM-DD format; omission selects the latest available session
side: any, ask, bid, or mid; defaults to any
minPremiumUsd: nonnegative minimum premium in US dollars; defaults to 0
limit: integer from 1 to 50; defaults to 20

Structured output

Contract ID plus a bounded list of recent prints
Per-print execution time, price, size, premium, NBBO bid and ask, exchange, tags, cancellation status, and underlying context
Nullable per-print Greeks, implied volatility, and theoretical value
Latest available Greeks with source print ID and source observation time, or null when unavailable
US market metadata, snapshot date, retrieval time, selection mode, warnings, partial status, and page count

Capabilities

Where this MCP tool fits

Drill into an exact contract ID

Query the exact identifier returned by an options-flow alert, such as AAPL260821C00220000, instead of asking the tool to infer a contract from separate option terms.

Review recent contract prints

Inspect up to 50 bounded prints with execution time, price, size, premium, NBBO context, exchange, tags, cancellation status, and underlying price when those fields are available.

Trace the latest available Greeks

Read nullable delta, gamma, theta, vega, rho, implied volatility, and theoretical value together with the source print ID and source observation time.

Filter by date, side, and premium

Request a supported YYYY-MM-DD market date, choose any, ask, bid, or mid as the trade-side filter, and set a nonnegative minimum premium in US dollars.

Agent workflow

A bounded call from question to review

1
Get the exact contract ID
Run find-options-flow-alerts first and copy a non-null contractId from the returned alert. Do not construct the ID from AAPL or SPY option terms.
2
Bound the print query
Pass the ID, then optionally choose a supported market date, an ask, bid, or mid filter, a minimum premium, and a result limit from 1 to 50.
3
Check timestamps and provenance
Review snapshot.marketDate, retrievedAt, warnings, and partial before interpreting prints. Treat latestGreeks as the newest available sourced values, not a live calculation.
4
Separate observation from a trading decision
Use the print and Greek fields as research context. Confirm quotes, liquidity, risk, and current market conditions elsewhere before making any decision.

Prompt examples

Questions an agent can route to this tool

"Use Pineify to find recent AAPL options-flow alerts, then inspect the prints and latest available Greeks for the exact contract ID returned by the alert."

"For contract AAPL260821C00220000, return up to 20 recent prints and explain the NBBO context without treating ask-side activity as proof of bullish intent."

"Inspect up to 10 ask-side prints above $25,000 in premium for the exact SPY contract ID from the previous alert, then report the Greeks source time and any missing fields."

Operator notes

How I review the result

When I receive AAPL260821C00220000 from an alert, I pass that string through unchanged. I do not recreate it from AAPL, the strike, and the expiry because this endpoint does not resolve option terms.

When I inspect an SPY contract, I compare executedAt with latestGreeks.sourceObservedAt before discussing exposure. I label a missing or older Greek value instead of presenting it as current.

I use ask, bid, and mid as execution-side filters, not as automatic bullish, bearish, or neutral conclusions. I also check the contract type, cancellation flag, size, premium, and NBBO before describing a print.

Boundaries to keep in the prompt

The tool cannot resolve a ticker, strike, option type, and expiry into a contract ID. It requires the exact ID returned by an options-flow alert.
Results are bounded to 50 recent prints for the latest available session or a supported requested market date. They are not a complete historical tape or a live streaming feed.
The side filter only accepts any, ask, bid, or mid. Execution side does not establish trader intent or market direction, and the tool does not forecast prices.
Greeks and related numeric fields are nullable. latestGreeks reports the newest available sourced values and provenance, which may differ in time from other prints or may be unavailable.
The tool does not return a full option chain, calculate strategy payoff, provide investment advice, or execute a trade. It is an information tool, not investment advice.

Pineify MCP is an information and code-validation tool, not investment advice. It does not promise returns, place trades, or modify a portfolio. Review timestamps, source fields, code diagnostics, and risk assumptions before acting.

MCP tool family

Continue the workflow

Browse all 14 tools

Find Options Flow Alerts MCP Tool

Find recent unusual US options-flow alerts and obtain the exact contract ID needed for this drill-down.

Technical Analysis Snapshot MCP Tool

Compare contract-level observations with the latest available technical fields for the underlying ticker.

Market Tide MCP Tool

Place one contract print sequence beside broader call and put premium conditions for the US market.

Related Pineify tools

Options Profit Calculator

Visualize and calculate the maximum profit, loss, and breakeven points for any options strategy.

Try it

Options Risk/Reward Visualizer

Visualize options strategy risk and reward with real-time data. Interactive P/L diagrams, Greeks sensitivity charts, breakeven analysis, and key risk metrics for any options strategy.

Try it

FAQ