Parse or build OCC option symbols API

Parse or build OCC Options Symbology Initiative 21-character option symbols, validating the calendar date and flagging roots that look adjusted.

The Parse or build OCC option symbols operation is part of the Black-Scholes Greeks Implied Volatility API on BRAINIAC.software. Parse or build OCC Options Symbology Initiative 21-character option symbols, validating the calendar date and flagging roots that look adjusted. It is exposed as POST /api/v1/options-analytics/occ-symbol-parse and priced at $0.02 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Black-Scholes-Merton and Cox-Ross-Rubinstein pricing models, Hull Options, Futures and Other Derivatives worked examples Raw SVI (Gatheral 2004) with Zeliade quasi-explicit calibration (2009) OCC Options Symbology Initiative (OSI) option symbol format Caller-supplied option chains, quotes, rates, dividends, positions and price history processed locally Limitations: Pure computation on caller input: no market data, rate or dividend feed is called, and nothing is fetched at request time. Models are European Black-Scholes-Merton with continuous dividend yield, the Cox-Ross-Rubinstein tree with escrowed discrete dividends, and raw SVI; Bjerksund-Stensland is not implemented. Times are in years (calendar days / 365 unless a day count is passed); rates and dividend yields are continuously compounded decimals and volatility is an annualised decimal. Outputs are calculations for human review. They are not investment advice, and open-interest and volatility statistics are descriptive rather than forecasts. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Price a European option and its Greeks, Solve implied volatility for option prices, Price an American option on a binomial tree, Compute multi-leg option strategy payoff. Open the group documentation for the full request schema, field notes, and response examples before integrating.

POST$0.02 USDC
/api/v1/options-analytics/occ-symbol-parse

Example request

curl -i -X POST "https://www.brainiac.software/api/v1/options-analytics/occ-symbol-parse" \
  -H 'content-type: application/json' \
  -H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
  --data-binary @- <<'JSON'
{
  "parse": [
    "SPX   141122P01950000",
    "LAMR150117C00052500"
  ],
  "build": [
    {
      "root": "AAPL",
      "expiry": "2027-01-15",
      "type": "call",
      "strike": 150
    }
  ]
}
JSON

An unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.

FAQ

  • Do I need an API key? No. Pay the listed USDC amount with x402.
  • What network? Base (eip155:8453), USDC.
  • Is this an official determination? No. Results are for human review against the cited sources.

Related APIs

Black-Scholes Greeks Implied Volatility APIFull docsHow it works