Rights, premiums and clear labels

Call option API

Model call option records with explicit strike, underlying, expiry and contract terms, then keep expiration payoff separate from profit.

Stock option API chains and quotations in rainbow fintech typography, branded OptionAPI.com.
Editorial illustration. Figures in artwork are not live quotes.

What the call label tells you

A call provides a right to buy the underlying under the contract’s specified terms, or the corresponding settlement entitlement where the product is cash-settled. It does not describe the complete contract by itself. Keep the underlying, exercise style, settlement method and quotation convention in explicit fields.

A simple expiration example

For a hypothetical conventional cash-equivalent payoff, let the final underlying reference be 110, the strike be 100 and the multiplier be 100. The gross expiration payoff is max(110 − 100, 0) × 100 = 1,000 monetary units. If the paid premium is 3 per quoted unit, the result after that premium is 700 before fees. These invented figures illustrate arithmetic, not a forecast or executable price.

Payoff is not a pricing model

The expiration formula does not provide a pre-expiry fair value and does not model every exercise or delivery consequence. An option can have a market premium distinct from its current intrinsic value. The OIC pricing reference explains this distinction. Keep any modeled value and its assumptions separate from quotations in the interface.

Preserve the missing context

A call record should carry its actual contract size, expiry and relevant deliverable. Do not assume every call is American-style or physically settled. If the terms are unresolved, restrict dependent calculations. Use the local fixtures to practice field interpretation before integrating licensed data or account-specific services.

Read the record.
Build with clarity.

Go from a market label to a field you can explain. Start with the guides, then inspect the local JSON examples.