{"slug":"derivatives-pricer-production-up-railway-app-v1-option-price-4a8a32","title":"When to use","host":"derivatives-pricer-production.up.railway.app","method":"POST","resource":"https://derivatives-pricer-production.up.railway.app/v1/option/price-from-surface","category":"market","description":"When to use: you already have an IV surface (k,T,σ) and need to price options on it — not invert premiums and not scalar σ. Interpolates total variance w=σ²T bilinear in log-moneyness k=ln(K/F); wingRule=flat_vol. Returns price, interpolated σ, k, F, BS Greeks. USDC exact on Solana/Base. Prefer /v1/","price_listed":0.08,"price_asked":0.08,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":480,"reported_calls_30d":1,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"dividendYield":0,"interpolation":"total_variance_bilinear","options":[{"optionType":"call","quantity":1,"strike":100,"timeToExpiry":1,"underlying":100}],"rate":0.05,"surface":[{"iv":0.22,"k":-0.1,"timeToExpiry":0.25},{"iv":0.2,"k":0,"timeToExpiry":0.25},{"iv":0.23,"k":0.1,"timeToExpiry":0.25},{"iv":0.21,"k":-0.1,"timeToExpiry":0.5},{"iv":0.2,"k":0,"timeToExpiry":0.5},{"iv":0.22,"k":0.1,"timeToExpiry":0.5},{"iv":0.205,"k":-0.1,"timeToExpiry":1},{"iv":0.2,"k":0,"timeToExpiry":1},{"iv":0.215,"k":0.1,"timeToExpiry":1}],"surfaceConvention":"log_moneyness_forward","wingRule":"flat_vol"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"description":"Price European options on a submitted IV surface via total-variance bilinear interpolation in log-moneyness k=ln(K/F).","properties":{"dividendYield":{"minimum":0,"type":"number"},"interpolation":{"const":"total_variance_bilinear","type":"string"},"optionStyle":{"default":"european","enum":["european","american"],"type":"string"},"options":{"maxItems":50,"minItems":1,"type":"array"},"rate":{"type":"number"},"surface":{"maxItems":200,"minItems":1,"type":"array"},"surfaceConvention":{"const":"log_moneyness_forward","type":"string"},"wingRule":{"const":"flat_vol","type":"string"}},"required":["surfaceConvention","rate","surface","options"],"title":"PriceFromSurfaceRequest","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"book":{"type":"object"},"computedAt":{"type":"string"},"requestId":{"type":"string"},"results":{"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["results","warnings","requestId","computedAt"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-11","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.08,"price_match":true,"latency_ms":480,"error":null}],"description_full":"When to use: you already have an IV surface (k,T,σ) and need to price options on it — not invert premiums and not scalar σ. Interpolates total variance w=σ²T bilinear in log-moneyness k=ln(K/F); wingRule=flat_vol. Returns price, interpolated σ, k, F, BS Greeks. USDC exact on Solana/Base. Prefer /v1/option/price when σ is a single scalar.","last_updated":"2026-10-10T23:48:40.922Z","schemes":["exact"]}