{"slug":"derivatives-pricer-production-up-railway-app-v1-option-scena-dcc533","title":"When to use","host":"derivatives-pricer-production.up.railway.app","method":"POST","resource":"https://derivatives-pricer-production.up.railway.app/v1/option/scenario-from-surface","category":"market","description":"When to use: book reval on an IV surface under F/rate/time/vol shocks with sticky moneyness|strike|fixed_vol. Vol order: interpolate → volAbs → volRel → smileTwist*k. Greeks are sticky-σ BS Greeks (not smile bump deltas). USDC exact on Solana/Base. Prefer scalar /v1/portfolio/scenario for per-leg sc","price_listed":0.15,"price_asked":0.15,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":907,"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","positions":[{"optionType":"call","quantity":1,"strike":100,"timeToExpiry":1,"underlying":100}],"rate":0.05,"scenario":{"rateBp":0,"smileTwist":0,"timeDays":0,"underlyingRel":0.1,"volAbs":0,"volRel":0},"sticky":"moneyness","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":"Revalue a book on an IV surface under sticky moneyness/strike/fixed_vol with optional F, rate, time, and vol shocks (incl. smileTwist).","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"},"positions":{"maxItems":50,"minItems":1,"type":"array"},"rate":{"type":"number"},"scenario":{"type":"object"},"sticky":{"enum":["moneyness","strike","fixed_vol"],"type":"string"},"surface":{"maxItems":200,"minItems":1,"type":"array"},"surfaceConvention":{"const":"log_moneyness_forward","type":"string"},"wingRule":{"const":"flat_vol","type":"string"}},"required":["surfaceConvention","rate","surface","positions","scenario"],"title":"ScenarioFromSurfaceRequest","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"},"legs":{"type":"array"},"requestId":{"type":"string"},"scenario":{"type":"object"},"sticky":{"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["legs","book","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.15,"price_match":true,"latency_ms":907,"error":null}],"description_full":"When to use: book reval on an IV surface under F/rate/time/vol shocks with sticky moneyness|strike|fixed_vol. Vol order: interpolate → volAbs → volRel → smileTwist*k. Greeks are sticky-σ BS Greeks (not smile bump deltas). USDC exact on Solana/Base. Prefer scalar /v1/portfolio/scenario for per-leg scalar σ books.","last_updated":"2026-10-10T23:48:42.107Z","schemes":["exact"]}