Skip to main content
POST
/
quantlib
/
pricing
/
binomial
/
american
Binomial Tree American Option
curl --request POST \
  --url https://api.fincept.in/quantlib/pricing/binomial/american \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "spot": 100,
  "strike": 105,
  "risk_free_rate": 0.05,
  "dividend_yield": 0.02,
  "volatility": 0.25,
  "time_to_maturity": 1,
  "n_steps": 100,
  "option_type": "put",
  "method": "CRR"
}
'
{
  "success": true,
  "data": {
    "price": 8.234,
    "method": "CRR",
    "n_steps": 100
  }
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key at https://api.fincept.in/auth/register

Body

application/json
​
spot
number
required

Current price of the underlying asset

Example:

100

​
strike
number
required

Strike price of the option

Example:

105

​
risk_free_rate
number
required

Risk-free interest rate (annualized, decimal format)

Example:

0.05

​
volatility
number
required

Annualized volatility (decimal format)

Example:

0.25

​
time_to_maturity
number
required

Time to expiration in years

Example:

1

​
dividend_yield
number
default:0

Continuous dividend yield (annualized, decimal format)

Example:

0.02

​
n_steps
integer
default:100

Number of time steps in the binomial tree

Example:

100

​
option_type
enum<string>
default:call

Type of option

Available options:
call,
put
Example:

"call"

​
method
enum<string>
default:CRR

Binomial tree method: CRR (Cox-Ross-Rubinstein), JR (Jarrow-Rudd), LR (Leisen-Reimer), TIAN (Tian)

Available options:
CRR,
JR,
LR,
TIAN
Example:

"CRR"

Response

Successful calculation

​
success
boolean
Example:

true

​
data
object