Skip to main content
Version: 8.6.3.4

Schema: OptionCalculator (ID: 5030)

This table allows custom option pricing based on either user or SR supplied input values.

METADATA​

AttributeValue
Topic5030-srse-calculators
MLink TokenInternal
MLink EndpointMLink-Live
SRSE ProductSRAnalytics

Note: The symbol = next to a field number indicates that it is a primary key.

BODY​

#FieldTypeDefault ValueComment
10=userNamestring(24)
11=okeyOptionKey
100voldouble0volatility
103volSrcenum : FieldSrcDefault
106uPrcdouble0underlying price
109uPrcSrcenum : FieldSrcDefault
112yearsdouble0years-to-expiration (default uses SR volatility time value)
115yearsSrcenum : FieldSrcDefault
118sdivdouble0continuous stock dividend using for pricing
121sdivSrcenum : FieldSrcDefault
124ratedouble0discount rate used for pricing
127rateSrcenum : FieldSrcDefault
130exTypeenum : ExerciseTypeNoneexercise type of the option (American or European)
133exTypeSrcenum : FieldSrcDefault
136effStrikedouble0effective strike used for pricing (default is okey.Strike)
139effStrikeSrcenum : FieldSrcDefault
142symRatiodouble0underlying symbol ratio (for non-standard options); discrete dividend will be scaled by this factor
145symRatioSrcenum : FieldSrcDefault
148divStringtext1discrete dividend string [ yearsToExpiry, years1:amt1, years2:amt2, ...] or [ -1, date1:amt1, date2:amt2, ... ]
151divSrcenum : FieldSrcDefault
154modelTypeenum : CalcModelTypeNoneNormal or LogNormal (default is product specific)
157modelTypeSrcenum : FieldSrcDefault
160prcFrameworkenum : PricingFrameworkNoneNone, Spot, Forward, Future, Physical (default is product specific)
163prcFrameworkSrcenum : FieldSrcDefault
166calcPrecisionenum : CalcPrecisionNormalnumerical precision (# of steps) if a numerical method is used; [more steps will be slower to calculate]
169incGreeksenum : YesNoNo
172pricedouble0price (premium)
175deltafloat0delta
178gammafloat0gamma
181thetafloat0theta
184vegafloat0vega
187volgafloat0volga
190vannafloat0vanna
193rhofloat0rho
196phifloat0phi
199deDecayfloat0delta decay
202errorstring(32)
205pricerModelstring(8)
208timestampDateTime2000-01-01

Get Schema API Call​

import requests 

# Replace with your desired MLINK URL 
MLINK_PROD_URL = 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json'

# Replace with your MLINK API Key
API_KEY = 'XXXX-XXXX-XXXX-XXXX'

# Replace with your desired MsgType.  
MSG_TYPE = 'OptionCalculator'

# Request Parameters for Get Schema Of The MsgType
params = {
    # Required Parameters
    "apiKey": API_KEY,
    "cmd": 'getschema',
    "msgType": MSG_TYPE, 
}

response = requests.get(MLINK_PROD_URL, params=params)

Get Msg API Call​

import requests 

# Replace with your desired MLINK URL 
MLINK_PROD_URL = 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json'

# Replace with your MLINK API Key
API_KEY = 'XXXX-XXXX-XXXX-XXXX'

# Replace with your desired MsgType.  
MSG_TYPE = 'OptionCalculator'

# Replace with your pkey value for getting the specific message desired
PKEY = 'ReplaceThisValueForTheQueryToWork'

# Replace with your desired view. A "|" separated list of views can be provided
# If no view is provided, all views will be returned. 
VIEW = 'vol|volSrc|uPrc|uPrcSrc|years|yearsSrc|sdiv|sdivSrc|rate|rateSrc|exType|exTypeSrc|effStrike|effStrikeSrc|symRatio|symRatioSrc|divString|divSrc|modelType|modelTypeSrc|prcFramework|prcFrameworkSrc|calcPrecision|incGreeks|price|delta|gamma|theta|vega|volga|vanna|rho|phi|deDecay|error|pricerModel|timestamp'

# Replace with your desired where clause.
# a string in the form "field1:eq:valuse" or "(field1:ne:value1 & field1:ne:value2)
# "WHERE" clauses can contain the following comparison symbols:
# :gt: is greater than
# :ge: is greater than or equal to
# :lt: is less than
# :le: is less than or equal to
# :eq: is equal
# :ne: is not equal
# %26 is an AND statement
# | is an OR statement
# :sw: is starts with
# :ew: is ends with
# :cv: is contains values
# :nv: is does not contain value
# :cb: is contained between (two dates for instance) separated by '$'
WHERE = 'userName:eq:ExampleString'

# Request Parameters for getmsg Of The MsgType
params = {
    # Required Parameters
    "apiKey": API_KEY,
    "cmd": 'getmsg',
    "pkey": PKEY,
    "msgType": MSG_TYPE,
    # Optional Parameters
    "view": VIEW, 
    "where": WHERE
}

response = requests.get(MLINK_PROD_URL, params=params)

Get Msgs API Call​

import requests 

# Replace with your desired MLINK URL 
MLINK_PROD_URL = 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json'

# Replace with your MLINK API Key
API_KEY = 'XXXX-XXXX-XXXX-XXXX'

# Replace with your desired MsgType.  
MSG_TYPE = 'OptionCalculator'

# Replace with your desired view. A "|" separated list of views can be provided
# If no view is provided, all views will be returned
VIEW = 'vol|volSrc|uPrc|uPrcSrc|years|yearsSrc|sdiv|sdivSrc|rate|rateSrc|exType|exTypeSrc|effStrike|effStrikeSrc|symRatio|symRatioSrc|divString|divSrc|modelType|modelTypeSrc|prcFramework|prcFrameworkSrc|calcPrecision|incGreeks|price|delta|gamma|theta|vega|volga|vanna|rho|phi|deDecay|error|pricerModel|timestamp'

# Replace with your desired where clause.
# a string in the form "field1:eq:value" or "(field1:ne:value1 & field1:ne:value2)
# "WHERE" clauses can contain the following comparison symbols:
# :gt: is greater than
# :ge: is greater than or equal to
# :lt: is less than
# :le: is less than or equal to
# :eq: is equal
# :ne: is not equal
# %26 is an AND statement
# | is an OR statement
# :sw: is starts with
# :ew: is ends with
# :cv: is contains values
# :nv: is does not contain value
# :cb: is contained between (two dates for instance) separated by '$'
WHERE = 'userName:eq:ExampleString'

# Replace with your desired limit of how many messages you receive. The default limit is 500
LIMIT = 500

# Order clause eg. "(field1:DESC | field1:ASC | field2:DESC:ABS | field2:ASC:ABS" (default is unordered; default is faster)
ORDER = 'vol:ASC'

# Request Parameters for getmsgs Of The MsgType
params = {
    # Required Parameters
    "apiKey": API_KEY,
    "cmd": 'getmsgs',
    "msgType": MSG_TYPE,
    # Optional Parameters
    "view": VIEW, 
    "where": WHERE,
    "limit": LIMIT,
    "order": ORDER
}

response = requests.get(MLINK_PROD_URL, params=params)

Get Aggregate API Call​

import requests 

# Replace with your desired MLINK URL 
MLINK_PROD_URL = 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json'

# Replace with your MLINK API Key
API_KEY = 'XXXX-XXXX-XXXX-XXXX'

# Replace with your desired MsgType.  
MSG_TYPE = 'OptionCalculator'

# Replace with fields you want to see aggregate values for. A "|" separated list of measures should be provided
MEASURE = 'vol|volSrc|uPrc|uPrcSrc|years|yearsSrc|sdiv|sdivSrc|rate|rateSrc|exType|exTypeSrc|effStrike|effStrikeSrc|symRatio|symRatioSrc|divString|divSrc|modelType|modelTypeSrc|prcFramework|prcFrameworkSrc|calcPrecision|incGreeks|price|delta|gamma|theta|vega|volga|vanna|rho|phi|deDecay|error|pricerModel|timestamp'

# Replace with fields you want to see aggregated. A "|" separated list of fields should be provided
GROUP = 'volSrc|uPrcSrc|yearsSrc|sdivSrc|rateSrc|exType|exTypeSrc|effStrikeSrc|symRatioSrc|divSrc|modelType|modelTypeSrc|prcFramework|prcFrameworkSrc|calcPrecision|incGreeks'

# Replace with your desired where clause.
# a string in the form "field1:eq:value" or "(field1:ne:value1 & field1:ne:value2)
# "WHERE" clauses can contain the following comparison symbols:
# :gt: is greater than
# :ge: is greater than or equal to
# :lt: is less than
# :le: is less than or equal to
# :eq: is equal
# :ne: is not equal
# %26 is an AND statement
# | is an OR statement
# :sw: is starts with
# :ew: is ends with
# :cv: is contains values
# :nv: is does not contain value
# :cb: is contained between (two dates for instance) separated by '$'
WHERE = 'userName:eq:ExampleString'

# Request Parameters for getaggregate Of The MsgType
params = {
    # Required Parameters
    "apiKey": API_KEY,
    "cmd": 'getaggregate',
    "msgType": MSG_TYPE,
    "measure": MEASURE,
    "group": GROUP,
    # Optional Parameters
    "where": WHERE,
}

response = requests.get(MLINK_PROD_URL, params=params)

Get Count API Call​

import requests 

# Replace with your desired MLINK URL 
MLINK_PROD_URL = 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json'

# Replace with your MLINK API Key
API_KEY = 'XXXX-XXXX-XXXX-XXXX'

# Replace with your desired MsgType.  
MSG_TYPE = 'OptionCalculator'

# Replace with your desired where clause.
# a string in the form "field1:eq:value" or "(field1:ne:value1 & field1:ne:value2)
# "WHERE" clauses can contain the following comparison symbols:
# :gt: is greater than
# :ge: is greater than or equal to
# :lt: is less than
# :le: is less than or equal to
# :eq: is equal
# :ne: is not equal
# %26 is an AND statement
# | is an OR statement
# :sw: is starts with
# :ew: is ends with
# :cv: is contains values
# :nv: is does not contain value
# :cb: is contained between (two dates for instance) separated by '$'
WHERE = 'userName:eq:ExampleString'

# Request Parameters for getCount Of The MsgType
params = {
# Required Parameters
"apiKey": API_KEY,
"cmd": 'getcount',
"msgType": MSG_TYPE,
# Optional Parameters
"where": WHERE,
}

response = requests.get(MLINK_PROD_URL, params=params)