{"uid":"cap_e-rvj2wj6g8aPsNFWamBb","slug":"options-lonestaroracle-xyz-50a44d47","name":"Lone Star Oracle Options Flow Intelligence","description":"Options flow intelligence — unusual activity put/call ratios large block trades","url":"https://options.lonestaroracle.xyz/flow","method":"GET","headers":{},"bodySchema":{"name":"LoneStarOracle — OptionsFlow","tags":["options","flow","derivatives","unusual-activity","iv","iv-skew","put-call-ratio","sentiment","crypto","btc","eth","sol","deribit","trading"],"type":"object","version":"1.0.0","category":"finance","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"expiry":{"type":"string","title":"Expiry","default":"nearest"},"symbol":{"type":"string","title":"Symbol"},"ticker":{"type":"string","title":"Ticker"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"ticker":"AAPL","summary":"AAPL options flow: 7 unusual strikes — dominant CALL | PCR 0.72 (bullish)","pcr_signal":"bullish (heavy call buying)","iv_skew_pct":2.1,"unusual_count":7,"iv_skew_signal":"put skew — market pricing in downside protection","put_call_ratio":0.55,"total_put_volume":204000,"unusual_activity":[{"type":"CALL","expiry":"2026-04-24","iv_pct":3.1,"strike":275,"volume":68611,"in_the_money":false,"vol_oi_ratio":3.2,"open_interest":21443}],"put_call_ratio_oi":0.61,"total_call_volume":284000}}}},"description":"Unusual options and derivatives activity scanner for any US stock, ETF, or major crypto (BTC / ETH / SOL via Deribit). Returns put/call volume and OI ratios, top strikes by volume, unusual activity (volume/OI > 3x), implied volatility skew, and a directional signal. Supports nearest expiry or multi-expiry scan. Ideal for agents reading market sentiment and positioning across US equities and crypto derivatives."},"responseSchema":null,"example":{"request":{"expiry":"nearest","ticker":"AAPL"},"response":{"ticker":"AAPL","summary":"AAPL options flow: 10 unusual strikes detected — dominant CALL side | PCR 0.76 (neutral) | neutral skew","top_puts":[{"expiry":"2026-06-12","iv_pct":33.4,"strike":290,"volume":75176,"in_the_money":false,"open_interest":8401},{"expiry":"2026-06-12","iv_pct":38.5,"strike":285,"volume":46203,"in_the_money":false,"open_interest":6653},{"expiry":"2026-06-12","iv_pct":32.3,"strike":292.5,"volume":34343,"in_the_money":false,"open_interest":3585},{"expiry":"2026-06-12","iv_pct":31.1,"strike":295,"volume":32030,"in_the_money":false,"open_interest":3266},{"expiry":"2026-06-12","iv_pct":35.5,"strike":287.5,"volume":31195,"in_the_money":false,"open_interest":5937}],"top_calls":[{"expiry":"2026-06-12","iv_pct":29.6,"strike":295,"volume":87879,"in_the_money":true,"open_interest":17041},{"expiry":"2026-06-12","iv_pct":30,"strike":300,"volume":73786,"in_the_money":false,"open_interest":12648},{"expiry":"2026-06-12","iv_pct":29.1,"strike":297.5,"volume":62983,"in_the_money":false,"open_interest":8024},{"expiry":"2026-06-12","iv_pct":32.7,"strike":292.5,"volume":47682,"in_the_money":true,"open_interest":6321},{"expiry":"2026-06-12","iv_pct":35.4,"strike":290,"volume":18720,"in_the_money":true,"open_interest":6726}],"fetched_at":"2026-06-12T02:57:07.410926+00:00","pcr_signal":"neutral","iv_skew_pct":1.95,"total_put_oi":94014,"current_price":295.63,"total_call_oi":198213,"unusual_count":10,"iv_skew_signal":"neutral skew","total_put_volume":266158,"unusual_activity":[{"type":"CALL","expiry":"2026-06-12","iv_pct":29.6,"strike":295,"volume":87879,"last_price":2.11,"in_the_money":true,"vol_oi_ratio":5.2,"open_interest":17041},{"type":"PUT","expiry":"2026-06-12","iv_pct":33.4,"strike":290,"volume":75176,"last_price":0.33,"in_the_money":false,"vol_oi_ratio":8.9,"open_interest":8401},{"type":"CALL","expiry":"2026-06-12","iv_pct":30,"strike":300,"volume":73786,"last_price":0.44,"in_the_money":false,"vol_oi_ratio":5.8,"open_interest":12648},{"type":"CALL","expiry":"2026-06-12","iv_pct":29.1,"strike":297.5,"volume":62983,"last_price":1.02,"in_the_money":false,"vol_oi_ratio":7.8,"open_interest":8024},{"type":"CALL","expiry":"2026-06-12","iv_pct":32.7,"strike":292.5,"volume":47682,"last_price":3.7,"in_the_money":true,"vol_oi_ratio":7.5,"open_interest":6321},{"type":"PUT","expiry":"2026-06-12","iv_pct":38.5,"strike":285,"volume":46203,"last_price":0.08,"in_the_money":false,"vol_oi_ratio":6.9,"open_interest":6653},{"type":"PUT","expiry":"2026-06-12","iv_pct":32.3,"strike":292.5,"volume":34343,"last_price":0.76,"in_the_money":false,"vol_oi_ratio":9.6,"open_interest":3585},{"type":"PUT","expiry":"2026-06-12","iv_pct":31.1,"strike":295,"volume":32030,"last_price":1.56,"in_the_money":false,"vol_oi_ratio":9.8,"open_interest":3266},{"type":"PUT","expiry":"2026-06-12","iv_pct":35.5,"strike":287.5,"volume":31195,"last_price":0.15,"in_the_money":false,"vol_oi_ratio":5.3,"open_interest":5937},{"type":"CALL","expiry":"2026-06-12","iv_pct":32.2,"strike":302.5,"volume":17379,"last_price":0.19,"in_the_money":false,"vol_oi_ratio":4.3,"open_interest":4054}],"put_call_ratio_oi":0.474,"total_call_volume":350975,"expirations_scanned":["2026-06-12"],"put_call_ratio_volume":0.758}},"exampleRequest":{"expiry":"nearest","ticker":"AAPL"},"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_14VBKpXG027oljXTZSEw_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time options flow data for a given ticker including unusual activity, put/call ratio, top puts/calls with volume and IV, and a directional sentiment summary","exampleAgentPrompt":"What's the current options flow for AAPL using the nearest expiry — is there more call buying or put buying, and what strikes are seeing unusual volume?","exampleUseCases":null,"resultDescription":"Returns a JSON object containing the ticker, a human-readable flow summary (e.g. 'dominant CALL side | PCR 0.57 (bullish)'), the put/call ratio with sentiment label, a list of top put contracts and top call contracts each with strike, expiry, volume, open interest, IV percentage, and in-the-money status.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty flow data","No unusual activity detected for a low-volume stock may yield minimal results","Expiry filter 'nearest' may return no data outside market hours or on non-trading days","Payment failure (402) if USDC balance is insufficient or x402 header is missing","Rate limiting or timeout if the underlying data feed is delayed or unavailable"],"whenToPreferThis":"Use this endpoint when you need real-time options flow intelligence including put/call ratios, large block trade detection, and unusual activity signals for a specific equity ticker. Prefer this over generic market data APIs when directional sentiment inference from options activity is the goal, especially for identifying institutional positioning via volume and open interest spikes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:06.818Z","isFirstParty":false}