{"uid":"cap_jbaYlsET7_uFgj_dgiNZw","slug":"api-quantoracle-dev-eb25127f","name":"QuantOracle Binomial Tree Option Pricer","description":"QuantOracle: derivatives/binomial-tree","url":"https://api.quantoracle.dev/v1/derivatives/binomial-tree","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"K":{"type":"number","title":"K","description":"Strike price","exclusiveMinimum":0},"S":{"type":"number","title":"S","description":"Spot price of the underlying asset","exclusiveMinimum":0},"T":{"type":"number","title":"T","maximum":30,"description":"Time to expiration in years","exclusiveMinimum":0},"q":{"type":"number","title":"Q","default":0,"description":"Continuous dividend yield"},"r":{"type":"number","title":"R","default":0.05,"description":"Risk-free interest rate (annualized)"},"type":{"enum":["call","put"],"type":"string","title":"Type","default":"call","description":"Option type"},"sigma":{"type":"number","title":"Sigma","description":"Volatility (annualized)","exclusiveMinimum":0},"steps":{"type":"integer","title":"Steps","default":100,"maximum":200,"minimum":1,"description":"Number of tree steps (1-200; default 100 textbook standard)"},"exercise":{"enum":["american","european"],"type":"string","title":"Exercise","default":"european","description":"Exercise style"}}},"responseSchema":null,"example":{"request":{"input":{"body":{"K":105,"S":100,"T":0.5,"q":0.02,"r":0.05,"type":"put","sigma":0.25,"steps":100,"exercise":"american"},"type":"http","method":"POST","bodyType":"json"}},"response":{"ms":15.2,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","calculator":"https://quantoracle.dev/american-option-calculator","powered_by":"QuantOracle"},"delta":-0.557144,"price":9.178,"steps":100,"bs_price":8.9231,"exercise":"american","early_exercise_premium":0.255}},"exampleRequest":{"K":105,"S":100,"T":0.5,"q":0.02,"r":0.05,"type":"put","sigma":0.25,"steps":100,"exercise":"american"},"tags":["x402"],"displayCostAmount":"0.008","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jm9LOBwmYJ3apa69K5LcQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Prices American or European options using a binomial tree model and returns fair value, Greeks (delta), and early exercise premium versus Black-Scholes.","exampleAgentPrompt":"Price an American put option where the stock is trading at $100, the strike is $105, it expires in 6 months, implied vol is 25%, risk-free rate is 5%, dividend yield is 2%, using 100 steps in the binomial tree — give me the fair value, delta, and how much of the price is early exercise premium.","exampleUseCases":null,"resultDescription":"Returns the binomial-tree option price, delta, Black-Scholes reference price, early exercise premium (binomial minus BS), number of steps used, exercise style, and server computation time in milliseconds.","failureModes":["Missing required fields (S, K, T, sigma, r) returns 400 validation error","Negative or zero volatility/time causes computation failure","Invalid 'type' value (not 'call' or 'put') returns 422 unprocessable entity","Invalid 'exercise' value (not 'american' or 'european') returns 422","Very large step counts may time out or return slow responses","Insufficient USDC balance causes x402 payment failure (402)"],"whenToPreferThis":"Use this endpoint when you need to price American options (which can be exercised early) where Black-Scholes is insufficient, or when you want to quantify the early exercise premium explicitly. Preferable over closed-form models when dividends are present and early exercise is relevant. Good for single-option pricing with delta; use the options/strategy-optimizer sibling for multi-leg strategies.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:45:32.025Z","isFirstParty":false}