{"uid":"cap_y0J4DCI5V41ZgXC3PO01L","slug":"api-quantoracle-dev-88b40e5d","name":"QuantOracle Hedging Recommender","description":"Free, fast quant finance calculators powered by a deterministic, multi-chain API. Black-Scholes, options profit, Kelly, VaR, crypto liquidation, and more.","url":"https://api.quantoracle.dev/v1/hedging/recommend?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","title":"HedgingIn","required":["position_type","position_value","asset_price","volatility"],"properties":{"r":{"type":"number","title":"R","default":0.05,"description":"Risk-free rate"},"volatility":{"type":"number","title":"Volatility","description":"Annualized volatility","exclusiveMinimum":0},"asset_price":{"type":"number","title":"Asset Price","description":"Current spot price","exclusiveMinimum":0},"position_type":{"type":"string","title":"Position Type","description":"long_stock | short_stock | long_crypto | long_options"},"position_value":{"type":"number","title":"Position Value","description":"Current dollar value of position","exclusiveMinimum":0},"time_horizon_days":{"type":"integer","title":"Time Horizon Days","default":30,"description":"Hedge time horizon in days","exclusiveMinimum":0},"max_hedge_cost_pct":{"type":"number","title":"Max Hedge Cost Pct","default":0.05,"description":"Max hedge cost as fraction of position (0.05 = 5%)","exclusiveMinimum":0}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"r":0.05,"volatility":0.35,"asset_price":125,"position_type":"long_stock","position_value":50000,"time_horizon_days":30,"max_hedge_cost_pct":0.03},"response":{"ms":15.3,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"hedges":[{"type":"collar","score":238.0726,"cost_pct":0.0074,"cost_usd":370.04,"affordable":true,"protection":"floor at 118.75, capped upside at 137.5","description":"Buy put @ 118.75, sell call @ 137.5","max_gain_if_hedged":4629.96,"max_loss_if_hedged":2870.04},{"type":"protective_put","score":53.2776,"cost_pct":0.0178,"cost_usd":888.48,"affordable":true,"protection":"full downside below strike","description":"Buy put at strike 118.75 (5% below spot)","breakeven_price":116.53,"max_loss_if_hedged":3388.48},{"note":"Requires margin account. P&L is offsetting, not capped.","type":"futures_inverse_hedge","score":1.2,"cost_pct":0.1,"cost_usd":5000,"affordable":true,"protection":"delta-neutral (100% hedged against price moves, funding costs apply)","description":"Short $50000.0 in futures or inverse short ETF","expected_daily_move_protected":1813.44},{"type":"partial_put_hedge","score":0.8,"cost_pct":0.0089,"cost_usd":444.24,"affordable":true,"protection":"half position protected below strike, half exposed","description":"Buy puts on 50% of position at strike 118.75","max_loss_if_hedged":6694.24}],"position":{"type":"long_stock","shares":400,"value_usd":50000,"spot_price":125},"num_hedges":4,"constraints":{"volatility":0.35,"horizon_days":30,"max_hedge_cost_usd":1500},"recommended":"collar"}},"exampleRequest":{"r":0.05,"volatility":0.35,"asset_price":125,"position_type":"long_stock","position_value":50000,"time_horizon_days":30,"max_hedge_cost_pct":0.03},"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tYaLNhplXvHClMrIEUcUW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Recommends optimal hedging strategies (collar, protective put, futures, etc.) for a stock or asset position given risk parameters and cost constraints","exampleAgentPrompt":"I have a $50,000 long stock position in a stock trading at $125, with 35% volatility and a risk-free rate of 5% — can you recommend the best hedging strategies for a 30-day horizon, keeping my hedge cost under 3% of the position value?","exampleUseCases":null,"resultDescription":"Returns a ranked list of hedging strategies (e.g. collar, protective put, futures inverse hedge) each with a numeric score, cost in USD and as a percentage of position value, affordability flag, description of protection offered, option strikes, max gain/loss if hedged, and breakeven price. Response includes latency in milliseconds.","failureModes":["Invalid or missing required fields (r, volatility, asset_price, position_type, position_value, time_horizon_days) return 400 validation error","Negative or zero asset price or position value returns error","Unrecognized position_type enum returns 400","max_hedge_cost_pct of 0 may return empty affordable hedges list","Service unavailable or timeout returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need a quantitative, ranked comparison of multiple hedging strategies for a specific equity or asset position, especially when you have cost constraints and want both option-based (collar, protective put) and futures-based approaches evaluated together with scores and dollar costs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T06:55:56.844Z","isFirstParty":false,"canonicalSlug":"api-quantoracle-dev-88b40e5d"}