When to use

When to use: you already have model inputs (S or forward mark, K, T, r, σ) and need fair value + hedge ratios — not market-premium IV. European BSM price + analytic Greeks (delta, gamma, vega, theta, rho). Works for equity spots and power/commodity forwards (use the maturity mark as spot). USDC exact on Solana/Base. Free fixed sample: GET /v1/demo/option-price.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

POST https://derivatives-pricer-production.up.railway.app/v1/option/price

Our checks, last 30 days

Example input (from the provider)

{
  "body": {
    "dividendYield": 0,
    "optionType": "call",
    "rate": 0.05,
    "spot": 100,
    "strike": 100,
    "timeToExpiry": 1,
    "volatility": 0.2
  },
  "bodyType": "json",
  "method": "POST",
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "body": {
          "properties": {
            "dividendYield": {
              "description": "Continuous dividend / convenience / yield q (\u2265 0, default 0).",
              "examples": [
                0,
                0.02
              ],
              "minimum": 0,
              "type": "number"
            },
            "expiration": {
              "description": "ISO-8601 end of vol/exercise window. Mutually exclusive with timeToExpiry.",
              "format": "date-time",
              "type": "string"
            },
            "forwardStart": {
              "description": "ISO-8601 start of vol/exercise window. If \u2264 now, behaves like plain option to expiration.",
              "format": "date-time",
              "type": "string"
            },
            "optionStyle": {
              "default": "european",
              "description": "Exercise style (default \"european\"). American uses CRR binomial with early exercise.",
              "enum": [
                "european",
                "american"
              ],
              "type": "string"
            },
            "optionType": {
              "description": "Call or put.",
              "enum": [
                "call",
                "put"
              ],
              "type": "string"
            },
            "rate": {
              "description": "Continuously compounded risk-free rate r (e.g. 0.05 = 5%). For futures-style early exercise set r\u2248dividendYield.",
              "examples": [
                0.03,
                0.05
              ],
              "type": "number"
            },
            "spot": {
              "description": "Underlying price S (> 0). Equity spot OR power/commodity forward mark for the option's window.",
              "examples": [
                100,
                82.5,
                45.5
              ],
              "exclusiveMinimum": 0,
              "type": "number"
            },
            "strike": {
              "description": "Strike price K (> 0) in the same units as spot.",
              "examples": [
                100,
                50
              ],
              "exclusiveMinimum": 0,
              "type": "number"
            },
            "timeToExpiry": {
              "description": "Time to expiry T in years (\u2265 0). Required unless expiration is set. Mutually exclusive with expiration.",
              "examples": [
                0.25,
                1
              ],
              "minimum": 0,
              "type": "number"
            },
            "treeSteps": {
              "description": "CRR steps for American (default 200 on single price).",
              "maximum": 500,
              "minimum": 50,
              "type": "integer"
            },
            "volatility": {
              "description": "Annualized volatility \u03c3 as a decimal (> 0). Applies over the vol-accrual window \u03c4.",
              "examples": [
                0.15,
                0.2,
                0.45
              ],
              "exclusiveMinimum": 0,
              "type": "number"
            }
          },
          "required": [
            "spot",
            "strike",
            "rate",
            "volatility",
            "optionType"
          ]
        },
        "bodyType": {
          "enum": [
            "json",
            "form-data",
            "text"
          ],
          "type": "string"
        },
        "method": {
          "enum": [
            "POST"
          ],
          "type": "string"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method",
        "bodyType",
        "body"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "description": "Fair value and Greeks. European Greeks are analytic BSM; American Greeks are finite-difference on the CRR tree. timeline.tauYears is the model life (window); calendarYearsToExpiry is purchase\u2192expiry.",
          "properties": {
            "computedAt": {
              "description": "ISO-8601 UTC timestamp of computation",
              "type": "string"
            },
            "greeks": {
              "description": "Greeks for hedge construction",
              "properties": {
                "delta": {
                  "description": "\u2202V/\u2202S",
                  "type": "number"
                },
                "gamma": {
                  "description": "\u2202\u00b2V/\u2202S\u00b2",
                  "type": "number"
                },
                "rho": {
                  "description": "\u2202V/\u2202r per 1.0 absolute rate",
                  "type": "number"
                },
                "theta": {
                  "description": "\u2202V/\u2202T per year",
                  "type": "number"
                },
                "vega": {
                  "description": "\u2202V/\u2202\u03c3 per 1.0 absolute vol",
                  "type": "number"
                }
              },
              "required": [
                "delta",
                "gamma",
                "vega",
                "theta",
                "rho"
              ],
              "type": "object"
            },
            "greeksQuality": {
              "enum": [
                "analytic",
                "finite-difference"
              ],
              "type": "string"
            },
            "inputs": {
              "description": "Echo of validated request inputs (timeToExpiry may be resolved \u03c4)",
              "type": "object"
            },
            "model": {
              "enum": [
                "black-scholes-merton",
                "binomial-crr-american"
              ],
              

This page as JSON