{"openapi":"3.1.0","info":{"title":"Options Analytics API","version":"1.0.0","description":"Price European and American options, solve implied volatility, compute Greeks and strategy payoffs, fit SVI surfaces, and measure realised volatility, skew, parity, expected move and open-interest max pain from caller-supplied quotes. Paid with x402 exact USDC on Base. No account is required.","contact":{"email":"support@brainiac.software"},"x-guidance":"BRAINIAC.software is a pay-per-call API for software agents. No account or API key is required.\nPayment uses x402 with exact USDC on Base (8453). Each paid resource accepts POST for the call; unpaid GET/HEAD return the same 402 payment challenge for discovery.\nHow to call an operation:\n1. POST JSON matching the requestBody. An unpaid POST (including empty body) returns 402 payment terms before body validation.\n2. Compare 402 payTo, asset, and network with /api/v1/catalog and /.well-known/x402 — not only with the 402 itself.\n3. Pay and retry with payment-signature. Invalid JSON/schema after payment-signature returns 400 and is not charged. Settlement (a charge) only on 2xx. payment-signature attached ≠ charged.\nIdempotency-Key: 64 hex chars from 32 random bytes. Reuse only for the same operation and body (replays stored response, including status=partial). A new key runs a fresh call.\nIdempotency after errors: unpaid 402 does not store the key. Post-signature 402/503 release it (retry same key). Pre-reserve schema 400 does not store it. Other post-signature responses (2xx/4xx/5xx) are stored: same key+body replays; different body → 409. Stored 4xx/5xx replays are not a second charge. Prefer a new key after fixing a 4xx; after 5xx reuse the same key only for the stored error.\nPost-signature 402/503 include prior-payment-attempt (nonce, settled false|unknown). A facilitator 502 is SETTLEMENT_UNKNOWN (stored under the Idempotency-Key; cross-instance replay needs the shared store; may already be charged) — check USDC authorizationState(payer, nonce) on Base before re-signing.\nSettlement signal: settled 2xx include payment-response. 4xx/5xx do not. Do not book a cost from payment-signature alone.\nCoverage billing: HTTP 200 with status complete, partial, or failed is charged at the full listed price. Retrying missing checks needs a new settled call. 4xx/5xx are not charged.\nmissing_items.reason: timeout/rate_limited → one delayed retry (new key); upstream_down → after recovery; not_supported → never.\nInvariants: any missing_items ⇒ not status complete; sources[] is provenance only (source, url, retrievedAt), never success/error keyed by check.\nFree lookup: GET /api/v1/results/{result_id} returns stored coverage JSON (404 RESULT_NOT_FOUND if unknown/expired; not a 402). Prior-Result-Id sets replaces_result_id.\nOutputs are prechecks/drafts for human review — not official determinations, legal advice, or certified filings."},"servers":[{"url":"https://www.brainiac.software"}],"paths":{"/api/v1/options-analytics/black-scholes-greeks":{"post":{"operationId":"price_a_european_option_and_its_greeks","summary":"Price a European option and its Greeks","description":"Price a European option with Black-Scholes-Merton and return delta, gamma, vega, theta, rho, vanna and charm from caller-supplied spot, strike, time, rate, dividend yield and volatility. Pure computation with a high-accuracy normal CDF.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"spot":{"type":"number","exclusiveMinimum":0},"strike":{"type":"number","exclusiveMinimum":0},"timeYears":{"type":"number","minimum":0,"maximum":50},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"sigma":{"type":"number","exclusiveMinimum":0,"maximum":5},"greeks":{"default":["delta","gamma","vega","theta","rho","vanna","charm"],"minItems":1,"type":"array","items":{"type":"string","enum":["delta","gamma","vega","theta","rho","vanna","charm"]}},"dayCount":{"default":"ACT/365","type":"string","enum":["ACT/365","ACT/360","TRADING/252"]}},"required":["type","spot","strike","timeYears","sigma"],"additionalProperties":false},"example":{"type":"call","spot":49,"strike":50,"timeYears":0.384615,"rate":0.05,"dividendYield":0,"sigma":0.2,"greeks":["delta","gamma","vega","theta","rho","vanna","charm"]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"price":{"type":"number"},"d1":{"type":"number"},"d2":{"type":"number"},"delta":{"type":"number"},"gamma":{"type":"number"},"vega":{"type":"number"},"vegaPer1Pct":{"type":"number"},"theta":{"type":"number"},"thetaPerDay":{"type":"number"},"rho":{"type":"number"},"vanna":{"type":"number"},"charm":{"type":"number"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"type":{"type":"string"},"spot":{"type":"number"},"strike":{"type":"number"},"timeYears":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"},"sigma":{"type":"number"},"dayCount":{"type":"string"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"price":2.400526,"d1":0.054181,"d2":-0.069854,"delta":0.521605,"gamma":0.065544,"vega":12.105474,"vegaPer1Pct":0.121055,"theta":-4.305331,"thetaPerDay":-0.011795,"rho":8.906952,"vanna":0.139133,"charm":-0.196758,"model":"BSM","inputsUsed":{"type":"call","spot":49,"strike":50,"timeYears":0.384615,"rate":0.05,"dividendYield":0,"sigma":0.2,"dayCount":"ACT/365"},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["European exercise, constant volatility, rate and continuous dividend or borrow yield. Discrete dividends are not modell…","Vega and rho are per 1.00 change in volatility and rate; vegaPer1Pct is per 0.01. Theta is per year and thetaPerDay div…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/implied-volatility-solve":{"post":{"operationId":"solve_implied_volatility_for_option_prices","summary":"Solve implied volatility for option prices","description":"Solve implied volatility for 1 to 500 option prices with Newton and Brent root-finding on Black-Scholes-Merton, or on a Cox-Ross-Rubinstein tree for American options. Prices outside the no-arbitrage bounds return a status instead of a number.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"style":{"default":"european","type":"string","enum":["european","american"]},"spot":{"type":"number","exclusiveMinimum":0},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"options":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64},"type":{"type":"string","enum":["call","put"]},"strike":{"type":"number","exclusiveMinimum":0},"timeYears":{"type":"number","minimum":0,"maximum":50},"price":{"type":"number","exclusiveMinimum":0}},"required":["type","strike","timeYears","price"],"additionalProperties":false}},"treeSteps":{"default":200,"type":"integer","minimum":50,"maximum":2000}},"required":["spot","options"],"additionalProperties":false},"example":{"style":"european","spot":42,"rate":0.1,"dividendYield":0,"options":[{"id":"c40","type":"call","strike":40,"timeYears":0.5,"price":4.76}],"treeSteps":200}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"index":{"type":"number"},"iv":{"type":"number"},"iterations":{"type":"number"},"method":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"style":{"type":"string"},"spot":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"},"optionCount":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"results":[{"id":"c40","index":0,"iv":0.200066,"iterations":4,"method":"newton","status":"ok"}],"model":"BSM","inputsUsed":{"style":"european","spot":42,"rate":0.1,"dividendYield":0,"optionCount":1},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["status is ok, below_intrinsic (price at or under the no-arbitrage lower bound), above_upper_bound (price at or over the…","European implied volatility uses Newton steps from a Brenner-Subrahmanyam start with a Brent fallback on [1e-4, 5] when…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/american-binomial-price":{"post":{"operationId":"price_an_american_option_on_a_binomial_tree","summary":"Price an American option on a binomial tree","description":"Price an American or European option on a Cox-Ross-Rubinstein tree with optional discrete cash dividends (escrowed method), and return tree delta, gamma, theta, the early-exercise boundary and the Black-Scholes-Merton European value for comparison.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string","enum":["call","put"]},"style":{"default":"american","type":"string","enum":["american","european"]},"spot":{"type":"number","exclusiveMinimum":0},"strike":{"type":"number","exclusiveMinimum":0},"timeYears":{"type":"number","minimum":0,"maximum":50},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"sigma":{"type":"number","exclusiveMinimum":0,"maximum":5},"steps":{"default":500,"type":"integer","minimum":1,"maximum":5000},"dividends":{"default":[],"maxItems":50,"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number","exclusiveMinimum":0},"amount":{"type":"number","minimum":0}},"required":["timeYears","amount"],"additionalProperties":false}}},"required":["type","spot","strike","timeYears","sigma"],"additionalProperties":false},"example":{"type":"put","style":"american","spot":50,"strike":50,"timeYears":0.416667,"rate":0.1,"dividendYield":0,"sigma":0.4,"steps":5,"dividends":[]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"price":{"type":"number"},"europeanPrice":{"type":"number"},"delta":{"type":"number"},"gamma":{"type":"number"},"theta":{"type":"number"},"earlyExerciseBoundary":{"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number"},"criticalSpot":{"type":"number"}},"additionalProperties":true}},"steps":{"type":"number"},"convergence":{"type":"object","properties":{"priceAtHalfSteps":{"type":"null"}},"additionalProperties":true},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"type":{"type":"string"},"style":{"type":"string"},"spot":{"type":"number"},"strike":{"type":"number"},"timeYears":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"},"sigma":{"type":"number"},"steps":{"type":"number"},"dividends":{"type":"array","items":{}}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"price":4.48846,"europeanPrice":4.075982,"delta":-0.41453,"gamma":0.034146,"theta":-4.3039,"earlyExerciseBoundary":[{"timeYears":0.25,"criticalSpot":35.361113},{"timeYears":0.333334,"criticalSpot":39.689347}],"steps":5,"convergence":{"priceAtHalfSteps":null},"model":"CRR","inputsUsed":{"type":"put","style":"american","spot":50,"strike":50,"timeYears":0.416667,"rate":0.1,"dividendYield":0,"sigma":0.4,"steps":5,"dividends":[]},"sources":[{"source":"Cox-Ross-Rubinstein binomial options pricing model (1979)","url":"https://en.wikipedia.org/wiki/Binomial_options_pricing_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Cox-Ross-Rubinstein tree: u = e^(σ√Δt), d = 1/u. Delta and gamma come from tree nodes at steps 1 and 2, theta is (V₂,₁ …","Discrete cash dividends use the escrowed-dividend method: the tree is built on spot minus the present value of dividend…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/strategy-payoff":{"post":{"operationId":"compute_multi_leg_option_strategy_payoff","summary":"Compute multi-leg option strategy payoff","description":"Compute payoff and profit or loss of a multi-leg option and stock position at expiry and at a valuation date, with exact breakevens, maximum profit and loss, and unlimited-risk flags.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spot":{"type":"number","exclusiveMinimum":0},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"multiplier":{"default":100,"type":"number","exclusiveMinimum":0},"valuationTimeYears":{"anyOf":[{"type":"number","minimum":0,"maximum":50},{"type":"null"}]},"legs":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["option","stock"]},"type":{"type":"string","enum":["call","put"]},"strike":{"type":"number","exclusiveMinimum":0},"timeYears":{"type":"number","minimum":0,"maximum":50},"qty":{"type":"number"},"premium":{"type":"number","minimum":0},"sigma":{"type":"number","exclusiveMinimum":0,"maximum":5}},"required":["kind","qty","premium"],"additionalProperties":false}},"grid":{"type":"object","properties":{"from":{"type":"number","minimum":0},"to":{"type":"number","exclusiveMinimum":0},"step":{"type":"number","exclusiveMinimum":0}},"required":["from","to","step"],"additionalProperties":false}},"required":["spot","legs"],"additionalProperties":false},"example":{"spot":100,"rate":0.04,"dividendYield":0,"multiplier":100,"valuationTimeYears":0,"legs":[{"kind":"option","type":"call","strike":100,"timeYears":0.25,"qty":1,"premium":5.47,"sigma":0.25},{"kind":"option","type":"call","strike":110,"timeYears":0.25,"qty":-1,"premium":1.92,"sigma":0.25}],"grid":{"from":80,"to":120,"step":1}}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"netPremium":{"type":"number"},"breakevens":{"type":"array","items":{"type":"number"}},"maxProfit":{"type":"number"},"maxLoss":{"type":"number"},"unlimitedProfit":{"type":"boolean"},"unlimitedLoss":{"type":"boolean"},"grid":{"type":"array","items":{"type":"object","properties":{"spot":{"type":"number"},"pnlAtExpiry":{"type":"number"},"pnlAtValuation":{"type":"number"}},"additionalProperties":true}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"spot":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"},"multiplier":{"type":"number"},"valuationTimeYears":{"type":"number"},"legCount":{"type":"number"},"frontExpiryYears":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"netPremium":-355,"breakevens":[103.55],"maxProfit":645,"maxLoss":-355,"unlimitedProfit":false,"unlimitedLoss":false,"grid":[{"spot":80,"pnlAtExpiry":-355,"pnlAtValuation":-337.518626},{"spot":81,"pnlAtExpiry":-355,"pnlAtValuation":-332.879352},"…"],"model":"intrinsic at expiry","inputsUsed":{"spot":100,"rate":0.04,"dividendYield":0,"multiplier":100,"valuationTimeYears":0,"legCount":2,"frontExpiryYears":0.25},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Expiry P/L = Σ (leg value − premium) × qty × multiplier. Option legs use the multiplier (default 100); stock legs are p…","Breakevens and max profit/loss are exact on the piecewise-linear expiry payoff, evaluated at spot 0, each strike and th…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/probability-of-profit":{"post":{"operationId":"compute_lognormal_option_probabilities","summary":"Compute lognormal option probabilities","description":"Compute lognormal probabilities of finishing above or below levels, touching a level before expiry, and finishing in profit for a strategy given its breakevens, under risk-neutral or real-world drift.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spot":{"type":"number","exclusiveMinimum":0},"sigma":{"type":"number","exclusiveMinimum":0,"maximum":5},"timeYears":{"type":"number","exclusiveMinimum":0,"maximum":50},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"measure":{"default":"risk_neutral","type":"string","enum":["risk_neutral","real_world"]},"drift":{"anyOf":[{"type":"number","minimum":-1,"maximum":2},{"type":"null"}]},"levels":{"default":[],"maxItems":50,"type":"array","items":{"type":"number","exclusiveMinimum":0}},"breakevens":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"number","exclusiveMinimum":0}},"profitAbove":{"type":"boolean"},"profitBetween":{"type":"array","prefixItems":[{"type":"number","exclusiveMinimum":0},{"type":"number","exclusiveMinimum":0}],"items":false,"minItems":2,"maxItems":2}},"required":["spot","sigma","timeYears"],"additionalProperties":false},"example":{"spot":100,"sigma":0.25,"timeYears":0.25,"rate":0.04,"dividendYield":0,"measure":"risk_neutral","levels":[110],"breakevens":[103.55],"profitAbove":true}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"levels":{"type":"array","items":{"type":"object","properties":{"level":{"type":"number"},"pAbove":{"type":"number"},"pBelow":{"type":"number"},"pTouch":{"type":"number"}},"additionalProperties":true}},"probabilityOfProfit":{"type":"number"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"spot":{"type":"number"},"sigma":{"type":"number"},"timeYears":{"type":"number"},"measure":{"type":"string"},"driftUsed":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"levels":[{"level":110,"pAbove":0.228141,"pBelow":0.771859,"pTouch":0.45173}],"probabilityOfProfit":0.396824,"model":"lognormal","inputsUsed":{"spot":100,"sigma":0.25,"timeYears":0.25,"measure":"risk_neutral","driftUsed":0.04,"rate":0.04,"dividendYield":0},"sources":[{"source":"Lognormal (geometric Brownian motion) terminal and first-passage probabilities","url":"https://en.wikipedia.org/wiki/Geometric_Brownian_motion","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["ln S_T ~ N(ln S + (m − σ²/2)T, σ²T) with m = rate − dividendYield (risk_neutral) or the supplied drift (real_world). Ri…","pTouch is the exact first-passage probability of a Brownian motion with drift ν = m − σ²/2 and continuous monitoring; i…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/iv-rank-percentile":{"post":{"operationId":"compute_iv_rank_and_iv_percentile","summary":"Compute IV rank and IV percentile","description":"Compute IV rank and IV percentile of the current implied volatility against caller-supplied history over a trailing window of observations.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"current":{"type":"number","exclusiveMinimum":0},"history":{"minItems":2,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"iv":{"type":"number","exclusiveMinimum":0}},"required":["date","iv"],"additionalProperties":false}},"windowDays":{"default":252,"type":"integer","minimum":5,"maximum":2520}},"required":["current","history"],"additionalProperties":false},"example":{"current":0.3,"history":[{"date":"2026-05-01","iv":0.2},{"date":"2026-05-02","iv":0.25},{"date":"2026-05-03","iv":0.3},{"date":"2026-05-04","iv":0.35},{"date":"2026-05-05","iv":0.4},{"date":"2026-05-06","iv":0.22},{"date":"2026-05-07","iv":0.28}],"windowDays":252}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"ivRank":{"type":"number"},"rankNote":{"type":"null"},"ivPercentile":{"type":"number"},"min":{"type":"number"},"max":{"type":"number"},"current":{"type":"number"},"observations":{"type":"number"},"window":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"}},"additionalProperties":true},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"windowDays":{"type":"number"},"historyPoints":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"ivRank":0.5,"rankNote":null,"ivPercentile":0.571429,"min":0.2,"max":0.4,"current":0.3,"observations":7,"window":{"from":"2026-05-01","to":"2026-05-07"},"model":"rank and percentile","inputsUsed":{"windowDays":252,"historyPoints":7},"sources":[{"source":"Caller-supplied option quotes, positions and history processed locally","url":"https://www.brainiac.software/api/v1/options-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["IV rank = (current − min)/(max − min) over the window, clipped to [0, 1]; IV percentile = share of window observations …","Outputs are standard-model calculations on caller-supplied inputs for human review. No market data is fetched, and this…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/historical-volatility":{"post":{"operationId":"compute_realised_volatility_from_ohlc_bars","summary":"Compute realised volatility from OHLC bars","description":"Compute close-to-close, Parkinson, Garman-Klass, Rogers-Satchell and Yang-Zhang realised volatility from OHLC bars, optionally excluding flagged days and returning a rolling series.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bars":{"minItems":3,"maxItems":10000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"open":{"type":"number","exclusiveMinimum":0},"high":{"type":"number","exclusiveMinimum":0},"low":{"type":"number","exclusiveMinimum":0},"close":{"type":"number","exclusiveMinimum":0},"exclude":{"default":false,"type":"boolean"}},"required":["date","open","high","low","close"],"additionalProperties":false}},"estimators":{"default":["close_to_close","parkinson","garman_klass","rogers_satchell","yang_zhang"],"minItems":1,"type":"array","items":{"type":"string","enum":["close_to_close","parkinson","garman_klass","rogers_satchell","yang_zhang"]}},"annualization":{"default":252,"type":"integer","minimum":1,"maximum":366},"window":{"anyOf":[{"type":"integer","minimum":3,"maximum":9007199254740991},{"type":"null"}]}},"required":["bars"],"additionalProperties":false},"example":{"bars":[{"date":"2026-10-01","open":100,"high":101.2,"low":99.4,"close":100.9},{"date":"2026-10-02","open":100.8,"high":101.5,"low":99.9,"close":100.3},{"date":"2026-10-03","open":100.2,"high":100.9,"low":99.1,"close":99.7},{"date":"2026-10-04","open":99.6,"high":102.6,"low":99.2,"close":102.3},{"date":"2026-10-05","open":102.4,"high":103.8,"low":101.7,"close":103.2}],"estimators":["close_to_close","parkinson","garman_klass","rogers_satchell","yang_zhang"],"annualization":252}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"close_to_close":{"type":"number"},"parkinson":{"type":"number"},"garman_klass":{"type":"number"},"rogers_satchell":{"type":"number"},"yang_zhang":{"type":"number"},"observations":{"type":"number"},"excluded":{"type":"number"},"rolling":{"type":"null"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"barCount":{"type":"number"},"estimators":{"type":"array","items":{"type":"string"}},"annualization":{"type":"number"},"window":{"type":"null"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"close_to_close":0.239708,"parkinson":0.211121,"garman_klass":0.21012,"rogers_satchell":0.198717,"yang_zhang":0.208377,"observations":5,"excluded":0,"rolling":null,"model":"realised volatility","inputsUsed":{"barCount":5,"estimators":["close_to_close","parkinson","…"],"annualization":252,"window":null},"sources":[{"source":"Realised volatility estimators: Parkinson (1980), Garman-Klass (1980), Rogers-Satchell (1991), Yang-Zhang (2000)","url":"https://en.wikipedia.org/wiki/Volatility_(finance)","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Close-to-close uses the sample standard deviation (n−1) of log returns. Parkinson, Garman-Klass and Rogers-Satchell ave…","Bars flagged exclude are dropped together with the returns that touch them; an estimator is null when too few bars rema…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.04"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/volatility-surface-fit":{"post":{"operationId":"fit_an_svi_volatility_surface","summary":"Fit an SVI volatility surface","description":"Fit a raw-SVI slice per expiry to strike implied volatilities with the Zeliade quasi-explicit method, interpolate the surface in total variance, and report butterfly and calendar static-arbitrage violations.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"forwardByExpiry":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number","exclusiveMinimum":0}},"points":{"minItems":5,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number","exclusiveMinimum":0,"maximum":50},"strike":{"type":"number","exclusiveMinimum":0},"iv":{"type":"number","exclusiveMinimum":0,"maximum":10}},"required":["timeYears","strike","iv"],"additionalProperties":false}},"query":{"maxItems":1000,"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number","exclusiveMinimum":0},"strike":{"type":"number","exclusiveMinimum":0}},"required":["timeYears","strike"],"additionalProperties":false}}},"required":["forwardByExpiry","points"],"additionalProperties":false},"example":{"forwardByExpiry":{"0.5":100},"points":[{"timeYears":0.5,"strike":74.08,"iv":0.654967},{"timeYears":0.5,"strike":81.87,"iv":0.56823},{"timeYears":0.5,"strike":90.48,"iv":0.474486},{"timeYears":0.5,"strike":100,"iv":0.4},{"timeYears":0.5,"strike":110.52,"iv":0.401419},{"timeYears":0.5,"strike":122.14,"iv":0.441458},{"timeYears":0.5,"strike":134.99,"iv":0.486808}],"query":[{"timeYears":0.5,"strike":100}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"slices":{"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number"},"forward":{"type":"number"},"params":{"type":"object","properties":{"a":{"type":"number"},"b":{"type":"number"},"rho":{"type":"number"},"m":{"type":"number"},"sigma":{"type":"number"}},"additionalProperties":true},"rmseIv":{"type":"number"},"status":{"type":"string"},"butterflyArbitrage":{"type":"array","items":{}},"rawPoints":{"type":"array","items":{"type":"object","properties":{"strike":{"type":"number"},"iv":{"type":"number"}},"additionalProperties":true}}},"additionalProperties":true}},"calendarArbitrage":{"type":"array","items":{}},"query":{"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number"},"strike":{"type":"number"},"iv":{"type":"number"}},"additionalProperties":true}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"pointCount":{"type":"number"},"expiries":{"type":"array","items":{"type":"number"}},"queryCount":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"slices":[{"timeYears":0.5,"forward":100,"params":{"a":0.039964,"b":0.400074,"rho":-0.400043,"m":-0.000048,"sigma":0.100087},"rmseIv":0.000005,"status":"ok","butterflyArbitrage":[],"rawPoints":[{"strike":74.08,"iv":0.654967},{"strike":81.87,"iv":0.56823},"…"]}],"calendarArbitrage":[],"query":[{"timeYears":0.5,"strike":100,"iv":0.399996}],"model":"raw SVI","inputsUsed":{"pointCount":7,"expiries":[0.5],"queryCount":1},"sources":[{"source":"Raw SVI (Gatheral 2004) with Zeliade quasi-explicit calibration (2009) and Gatheral-Jacquier static-arbitrage conditions","url":"https://www.zeliade.com/whitepapers/zwp-0005.pdf","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Raw SVI w(k) = a + b[ρ(k − m) + √((k − m)² + σ²)] on total variance, fitted per expiry by the Zeliade quasi-explicit me…","Expiries with fewer than 5 distinct strikes return status insufficient_points and the raw points. A failed fit returns …","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/put-call-parity-check":{"post":{"operationId":"check_put_call_parity_and_implied_forward","summary":"Check put-call parity and implied forward","description":"Infer the implied forward and carry from call and put quote pairs, solve the rate by least squares when omitted, and flag pairs whose bid and ask break the European or American parity band.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"style":{"default":"european","type":"string","enum":["european","american"]},"spot":{"type":"number","exclusiveMinimum":0},"rate":{"anyOf":[{"type":"number","minimum":-0.2,"maximum":1},{"type":"null"}]},"timeYears":{"type":"number","exclusiveMinimum":0,"maximum":50},"pairs":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"strike":{"type":"number","exclusiveMinimum":0},"callBid":{"type":"number","minimum":0},"callAsk":{"type":"number","minimum":0},"putBid":{"type":"number","minimum":0},"putAsk":{"type":"number","minimum":0}},"required":["strike","callBid","callAsk","putBid","putAsk"],"additionalProperties":false}},"toleranceAbs":{"default":0.01,"type":"number","minimum":0}},"required":["spot","timeYears","pairs"],"additionalProperties":false},"example":{"spot":100,"rate":0.05,"timeYears":0.5,"pairs":[{"strike":100,"callBid":5.9,"callAsk":6.1,"putBid":3.9,"putAsk":4.1}],"toleranceAbs":0.05}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"impliedForward":{"type":"number"},"impliedCarry":{"type":"number"},"impliedRate":{"type":"null"},"pairs":{"type":"array","items":{"type":"object","properties":{"strike":{"type":"number"},"mid":{"type":"object","properties":{"call":{"type":"number"},"put":{"type":"number"}},"additionalProperties":true},"forward":{"type":"number"},"residual":{"type":"number"},"violation":{"type":"boolean"}},"additionalProperties":true}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"style":{"type":"string"},"spot":{"type":"number"},"rate":{"type":"number"},"timeYears":{"type":"number"},"toleranceAbs":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"impliedForward":102.05063,"impliedCarry":0.040598,"impliedRate":null,"pairs":[{"strike":100,"mid":{"call":6,"put":4},"forward":102.05063,"residual":0,"violation":false}],"model":"european parity","inputsUsed":{"style":"european","spot":100,"rate":0.05,"timeYears":0.5,"toleranceAbs":0.05},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Outputs are standard-model calculations on caller-supplied inputs for human review. No market data is fetched, and this…","European parity C − P = e^(−rT)(F − K). Forward is the median of per-pair forwards from mid quotes; carry is ln(F/S)/T …"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/expected-move":{"post":{"operationId":"compute_market_implied_expected_move","summary":"Compute market-implied expected move","description":"Compute the one and two standard deviation expected move and price ranges from implied volatility or from the at-the-money straddle price.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spot":{"type":"number","exclusiveMinimum":0},"daysToExpiry":{"type":"number","exclusiveMinimum":0,"maximum":3650},"iv":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"straddlePrice":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"dayBasis":{"default":365,"anyOf":[{"type":"number","const":365},{"type":"number","const":252}]}},"required":["spot","daysToExpiry"],"additionalProperties":false},"example":{"spot":100,"daysToExpiry":30,"iv":0.3,"dayBasis":365}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"oneSigma":{"type":"number"},"twoSigma":{"type":"number"},"range1":{"type":"array","items":{"type":"number"}},"range2":{"type":"array","items":{"type":"number"}},"method":{"type":"string"},"ivFromStraddle":{"type":"null"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"spot":{"type":"number"},"daysToExpiry":{"type":"number"},"dayBasis":{"type":"number"},"timeYears":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"oneSigma":8.600733,"twoSigma":17.201465,"range1":[91.399267,108.600733],"range2":[82.798535,117.201465],"method":"iv","ivFromStraddle":null,"model":"normal approximation","inputsUsed":{"spot":100,"daysToExpiry":30,"dayBasis":365,"timeYears":0.082192},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["From IV: move = S·σ·√(days/dayBasis). From a straddle: move ≈ straddle price (an at-the-money straddle ≈ 0.7979·S·σ√T, …","Ranges are S ± move and S ± 2·move under a normal approximation; they are not probability-calibrated lognormal bounds a…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/skew-metrics":{"post":{"operationId":"compute_25_delta_skew_metrics","summary":"Compute 25-delta skew metrics","description":"Compute 25-delta risk reversal, butterfly, skew slope and term-structure slope from strike and implied volatility quotes by expiry, with linear interpolation in log-moneyness and no extrapolation.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"spot":{"type":"number","exclusiveMinimum":0},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"deltaConvention":{"default":"spot","type":"string","enum":["spot","forward"]},"expiries":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number","exclusiveMinimum":0,"maximum":50},"points":{"minItems":3,"maxItems":500,"type":"array","items":{"type":"object","properties":{"strike":{"type":"number","exclusiveMinimum":0},"iv":{"type":"number","exclusiveMinimum":0,"maximum":10}},"required":["strike","iv"],"additionalProperties":false}}},"required":["timeYears","points"],"additionalProperties":false}}},"required":["spot","expiries"],"additionalProperties":false},"example":{"spot":100,"rate":0,"dividendYield":0,"deltaConvention":"spot","expiries":[{"timeYears":0.25,"points":[{"strike":90,"iv":0.26},{"strike":100,"iv":0.24},{"strike":110,"iv":0.22}]}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"expiries":{"type":"array","items":{"type":"object","properties":{"timeYears":{"type":"number"},"atmIv":{"type":"number"},"call25dStrike":{"type":"number"},"call25dIv":{"type":"number"},"put25dStrike":{"type":"number"},"put25dIv":{"type":"number"},"riskReversal25":{"type":"number"},"butterfly25":{"type":"number"},"skewSlopePerLogMoneyness":{"type":"number"},"notes":{"type":"array","items":{}}},"additionalProperties":true}},"termSlope":{"type":"null"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"spot":{"type":"number"},"rate":{"type":"number"},"dividendYield":{"type":"number"},"deltaConvention":{"type":"string"},"expiryCount":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"expiries":[{"timeYears":0.25,"atmIv":0.24,"call25dStrike":108.479458,"call25dIv":0.222921,"put25dStrike":92.514363,"put25dIv":0.25477,"riskReversal25":-0.031849,"butterfly25":-0.001155,"skewSlopePerLogMoneyness":-0.199165,"notes":[]}],"termSlope":null,"model":"linear log-moneyness smile","inputsUsed":{"spot":100,"rate":0,"dividendYield":0,"deltaConvention":"spot","expiryCount":1},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["IV is interpolated linearly in log-moneyness ln(K/F) with F = S·e^((r−q)T); no extrapolation, so a 25-delta strike outs…","The 25-delta strike solves BSM call delta = 0.25 and put delta = −0.25 by fixed-point iteration with the smile IV at th…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/position-greeks-aggregate":{"post":{"operationId":"aggregate_portfolio_option_greeks","summary":"Aggregate portfolio option Greeks","description":"Aggregate share delta, dollar delta, gamma, vega, theta per day and beta-weighted delta across option and stock positions, computing Black-Scholes-Merton Greeks unless the caller supplies them.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"benchmarkSpot":{"type":"number","exclusiveMinimum":0},"positions":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"underlying":{"type":"string","minLength":1,"maxLength":32},"spot":{"type":"number","exclusiveMinimum":0},"beta":{"default":1,"type":"number"},"kind":{"type":"string","enum":["option","stock"]},"type":{"type":"string","enum":["call","put"]},"strike":{"type":"number","exclusiveMinimum":0},"timeYears":{"type":"number","minimum":0,"maximum":50},"rate":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"dividendYield":{"default":0,"type":"number","minimum":-0.2,"maximum":1},"sigma":{"type":"number","exclusiveMinimum":0,"maximum":5},"qty":{"type":"number"},"multiplier":{"type":"number","exclusiveMinimum":0},"delta":{"type":"number"},"gamma":{"type":"number"},"vega":{"type":"number"},"theta":{"type":"number"}},"required":["underlying","spot","kind","qty"],"additionalProperties":false}}},"required":["benchmarkSpot","positions"],"additionalProperties":false},"example":{"benchmarkSpot":500,"positions":[{"underlying":"AAA","spot":49,"beta":1.2,"kind":"option","type":"call","strike":50,"timeYears":0.384615,"rate":0.05,"sigma":0.2,"qty":10,"multiplier":100},{"underlying":"AAA","spot":49,"beta":1.2,"kind":"stock","qty":-300}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"byUnderlying":{"type":"array","items":{"type":"object","properties":{"underlying":{"type":"string"},"shareDelta":{"type":"number"},"dollarDelta":{"type":"number"},"gamma":{"type":"number"},"vega":{"type":"number"},"thetaPerDay":{"type":"number"}},"additionalProperties":true}},"total":{"type":"object","properties":{"shareDelta":{"type":"number"},"dollarDelta":{"type":"number"},"gamma":{"type":"number"},"vega":{"type":"number"},"thetaPerDay":{"type":"number"},"betaWeightedDelta":{"type":"number"}},"additionalProperties":true},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"benchmarkSpot":{"type":"number"},"positionCount":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"byUnderlying":[{"underlying":"AAA","shareDelta":221.604585,"dollarDelta":10858.624684,"gamma":65.544073,"vega":12105.473954,"thetaPerDay":-11.795428}],"total":{"shareDelta":221.604585,"dollarDelta":10858.624684,"gamma":65.544073,"vega":12105.473954,"thetaPerDay":-11.795428,"betaWeightedDelta":26.060699},"model":"BSM","inputsUsed":{"benchmarkSpot":500,"positionCount":2},"sources":[{"source":"Black-Scholes-Merton model (Black and Scholes 1973, Merton 1973); formulas as in Hull, Options, Futures and Other Deriv…","url":"https://en.wikipedia.org/wiki/Black%E2%80%93Scholes_model","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Share delta = Σ delta × qty × multiplier (stock delta 1, multiplier default 100 for options and 1 for stock). Dollar de…","Gamma, vega and theta are summed × qty × multiplier. Option Greeks come from Black-Scholes-Merton unless the position s…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/covered-call-yield":{"post":{"operationId":"compute_covered_call_and_cash_secured_put_yield","summary":"Compute covered call and cash-secured put yield","description":"Compute static and if-called returns, annualised returns, downside protection and breakeven for a covered call, or the return on collateral for a cash-secured put.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"strategy":{"type":"string","enum":["covered_call","cash_secured_put"]},"stockPrice":{"type":"number","exclusiveMinimum":0},"strike":{"type":"number","exclusiveMinimum":0},"premium":{"type":"number","exclusiveMinimum":0},"daysToExpiry":{"type":"integer","minimum":1,"maximum":1095},"dividendsBeforeExpiry":{"default":0,"type":"number","minimum":0},"commission":{"default":0,"type":"number","minimum":0}},"required":["strategy","strike","premium","daysToExpiry"],"additionalProperties":false},"example":{"strategy":"covered_call","stockPrice":50,"strike":55,"premium":1.2,"daysToExpiry":45,"dividendsBeforeExpiry":0,"commission":0}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"strategy":{"type":"string"},"staticReturn":{"type":"number"},"ifCalledReturn":{"type":"number"},"staticAnnualized":{"type":"number"},"ifCalledAnnualized":{"type":"number"},"compoundAnnualized":{"type":"number"},"ifCalledCompoundAnnualized":{"type":"number"},"downsideProtection":{"type":"number"},"breakeven":{"type":"number"},"netDebit":{"type":"number"},"collateral":{"type":"null"},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"stockPrice":{"type":"number"},"strike":{"type":"number"},"premium":{"type":"number"},"daysToExpiry":{"type":"number"},"dividendsBeforeExpiry":{"type":"number"},"commission":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"strategy":"covered_call","staticReturn":0.02459,"ifCalledReturn":0.127049,"staticAnnualized":0.199454,"ifCalledAnnualized":1.03051,"compoundAnnualized":0.217794,"ifCalledCompoundAnnualized":1.63824,"downsideProtection":0.024,"breakeven":48.8,"netDebit":48.8,"collateral":null,"model":"static and if-called return","inputsUsed":{"stockPrice":50,"strike":55,"premium":1.2,"daysToExpiry":45,"dividendsBeforeExpiry":0,"commission":0},"sources":[{"source":"Caller-supplied option quotes, positions and history processed locally","url":"https://www.brainiac.software/api/v1/options-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Covered call: static = (premium + dividends − commission)/net debit; if called = (premium + dividends + strike − stock …","Returns are per share before taxes, margin interest and assignment timing. Annualised figures are simple ×365/days; com…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/occ-symbol-parse":{"post":{"operationId":"parse_or_build_occ_option_symbols","summary":"Parse or build OCC option symbols","description":"Parse or build OCC Options Symbology Initiative 21-character option symbols, validating the calendar date and flagging roots that look adjusted.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"parse":{"default":[],"maxItems":1000,"type":"array","items":{"type":"string","maxLength":40}},"build":{"default":[],"maxItems":1000,"type":"array","items":{"type":"object","properties":{"root":{"type":"string","pattern":"^[A-Za-z0-9]{1,6}$"},"expiry":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"type":{"type":"string","enum":["call","put"]},"strike":{"type":"number","exclusiveMinimum":0,"exclusiveMaximum":100000}},"required":["root","expiry","type","strike"],"additionalProperties":false}}},"additionalProperties":false},"example":{"parse":["SPX   141122P01950000","LAMR150117C00052500"],"build":[{"root":"AAPL","expiry":"2027-01-15","type":"call","strike":150}]}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"parsed":{"type":"array","items":{"type":"object","properties":{"input":{"type":"string"},"root":{"type":"string"},"expiry":{"type":"string"},"type":{"type":"string"},"strike":{"type":"number"},"valid":{"type":"boolean"},"possiblyAdjusted":{"type":"boolean"}},"additionalProperties":true}},"built":{"type":"array","items":{"type":"object","properties":{"symbol":{"type":"string"},"compact":{"type":"string"}},"additionalProperties":true}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"parseCount":{"type":"number"},"buildCount":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"parsed":[{"input":"SPX   141122P01950000","root":"SPX","expiry":"2014-11-22","type":"put","strike":1950,"valid":true,"possiblyAdjusted":false},{"input":"LAMR150117C00052500","root":"LAMR","expiry":"2015-01-17","type":"call","strike":52.5,"valid":true,"possiblyAdjusted":false}],"built":[{"symbol":"AAPL  270115C00150000","compact":"AAPL270115C00150000"}],"model":"OCC OSI","inputsUsed":{"parseCount":2,"buildCount":1},"sources":[{"source":"OCC Options Symbology Initiative (OSI) 21-character option symbol, in force since 12 Feb 2010","url":"https://www.theocc.com/","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Format: root right-padded to 6 characters, expiry YYMMDD (20YY), C or P, strike × 1000 zero-padded to 8 digits. The sym…","Roots ending in a digit (for example AAPL1) are parsed but flagged possiblyAdjusted: the deliverable of an adjusted con…","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}},"/api/v1/options-analytics/max-pain-oi":{"post":{"operationId":"compute_max_pain_and_open_interest_walls","summary":"Compute max pain and open-interest walls","description":"Compute the max-pain strike, per-strike payout, put/call open-interest ratio and the highest open-interest call and put walls for one expiry from a supplied option chain.","tags":["options-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"multiplier":{"default":100,"type":"number","exclusiveMinimum":0},"chain":{"minItems":2,"maxItems":2000,"type":"array","items":{"type":"object","properties":{"strike":{"type":"number","exclusiveMinimum":0},"callOi":{"type":"integer","minimum":0,"maximum":9007199254740991},"putOi":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["strike","callOi","putOi"],"additionalProperties":false}},"topWalls":{"default":3,"type":"integer","minimum":1,"maximum":50}},"required":["chain"],"additionalProperties":false},"example":{"multiplier":100,"chain":[{"strike":90,"callOi":100,"putOi":500},{"strike":95,"callOi":300,"putOi":400},{"strike":100,"callOi":800,"putOi":700},{"strike":105,"callOi":600,"putOi":200},{"strike":110,"callOi":900,"putOi":50}],"topWalls":3}}}},"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"Fresh random 32-byte value encoded as 64 hexadecimal characters. Reuse unchanged only for retries of the same operation and request.","schema":{"type":"string","pattern":"^[0-9a-fA-F]{64}$"}}],"responses":{"200":{"description":"Illustrative endpoint-specific JSON response shape. For coverage operations, HTTP 200 is used for status complete, partial, and failed; all three settle and are charged at the full listed price. A settled 2xx includes a payment-response response header (facilitator settlement receipt; may include a transaction reference). Conditional fields depend on the result and data-source availability.","headers":{"payment-response":{"description":"Present on settled 2xx only. Facilitator settlement receipt for the x402 payment (not present on 4xx/5xx, which are not charged).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"maxPain":{"type":"number"},"painByStrike":{"type":"array","items":{"type":"object","properties":{"strike":{"type":"number"},"totalPayout":{"type":"number"}},"additionalProperties":true}},"putCallOiRatio":{"type":"number"},"callWalls":{"type":"array","items":{"type":"number"}},"putWalls":{"type":"array","items":{"type":"number"}},"model":{"type":"string"},"inputsUsed":{"type":"object","properties":{"multiplier":{"type":"number"},"strikeCount":{"type":"number"},"totalCallOi":{"type":"number"},"totalPutOi":{"type":"number"},"topWalls":{"type":"number"}},"additionalProperties":true},"sources":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"url":{"type":"string"},"retrievedAt":{"type":"string"},"status":{"type":"string"}},"additionalProperties":true},"description":"Provenance only (source, url, retrievedAt). Not keyed by check id and does not carry success or error. A check in missing_items does not remove its upstream from sources[]; unavailability is only in missing_items (and unavailable findings)."},"limitations":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"example":{"maxPain":100,"painByStrike":[{"strike":90,"totalPayout":1300000},{"strike":95,"totalPayout":675000},"…"],"putCallOiRatio":0.685185,"callWalls":[110,100,"…"],"putWalls":[100,90,"…"],"model":"max pain","inputsUsed":{"multiplier":100,"strikeCount":5,"totalCallOi":2700,"totalPutOi":1850,"topWalls":3},"sources":[{"source":"Caller-supplied option quotes, positions and history processed locally","url":"https://www.brainiac.software/api/v1/options-analytics","retrievedAt":"2026-11-14","status":"ok"}],"limitations":["Payout at settlement X sums callOi × max(X − K, 0) + putOi × max(K − X, 0) over the chain times the multiplier; max pai…","One expiry per call. Open interest is as supplied (usually previous-day), and max pain is a descriptive statistic, not …","…"]}}}},"400":{"description":"Invalid JSON or request schema. Not charged (no payment-response). If this 400 is returned before the Idempotency-Key is reserved, the key is not stored — fix the body and you may reuse the key. If an operation-path 400 was stored after a payment-signature was attached, the same key + same body replays it; the same key + a different body returns 409."},"402":{"description":"Payment required. The JSON body is the x402 PaymentRequired object. An unpaid 402 does not store the Idempotency-Key. A 402 after payment-signature releases the key and includes prior-payment-attempt (nonce, settled false|unknown). Not charged; no payment-response. Before re-signing after a post-signature 402, check USDC authorizationState(payer, nonce) on Base."},"409":{"description":"Idempotency conflict, in-progress payment, or expired result cache. Same key with a different body after a stored result returns conflict. Reusing the key cannot trigger a second charge. Not charged when settlement did not occur."},"413":{"description":"Request body exceeds the 24 MB limit. Not charged."},"500":{"description":"Operation failed before settlement, so no payment is taken (no payment-response). The error is stored: reuse the same Idempotency-Key and body to retrieve it without paying again. Use a new key for a fresh attempt with a new payment-signature."},"502":{"description":"Facilitator verify/settle transport failure (often timeout). After payment-signature this is returned as SETTLEMENT_UNKNOWN with prior-payment-attempt; the outcome is stored under the Idempotency-Key. With the shared store configured, other instances replay it instead of settling again; without it, each instance keeps its own memory. The authorization may already be settled on-chain — do not re-sign until USDC authorizationState(payer, nonce) on Base is false."},"503":{"description":"Payment or retry-safe result storage is unavailable; the operation is not run. Not charged; no payment-response. A 503 after payment-signature releases the Idempotency-Key and includes prior-payment-attempt."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}],"facilitator":"https://api.cdp.coinbase.com/platform/v2/x402"}}}},"components":{"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}}}}}}}}