Skip to main content
POST
Prospect Theory Value Function

Authorizations

X-API-Key
string
header
required

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

Body

application/json
outcome
number
required

Outcome to evaluate (positive = gain, negative = loss relative to reference)

Example:

-100

alpha
number
default:0.88

Diminishing sensitivity exponent for gains (typically 0.88)

Required range: 0 <= x <= 1
Example:

0.88

beta
number
default:0.88

Diminishing sensitivity exponent for losses (typically 0.88)

Required range: 0 <= x <= 1
Example:

0.88

lambda_param
number
default:2.25

Loss aversion parameter (typically 2.25, meaning losses hurt 2.25x more than gains)

Required range: x >= 1
Example:

2.25

wealth
number
default:0

Reference point (typically 0 for gains/losses relative to status quo)

Example:

0

Response

Successful Response

success
boolean
Example:

true

data
object