Schema: AtsDegrossMarketSummary (ID: 2360)
Published by the degrossing execution engine at each auction close. This is the PUBLIC
post-auction disclosure — venue totals only, never per-client figures (per-order results are
AtsDegrossRevConResult (2356)). The WTS merges these onto LiveGridDegrossMarket (6973) rows.
Prices are PACKAGE space, like 2356/4030 — the book matches there; consumers rebase +strike for
trader R/C display. Publish-only: no archive directives and .Archive() is never called.
METADATA
| Attribute | Value |
|---|---|
| Topic | 2270-execution-engine |
| MLink Token | ClientTrading |
| MLink Endpoint | MLink-Live |
| SRSE Product | SRTrade |
Note: The symbol
=next to a field number indicates that it is a primary key.
BODY
| # | Field | Type | Default Value | Comment |
|---|---|---|---|---|
| 10= | ticker | TickerKey | underlier ticker | |
| 11= | expiry | DateKey | flex option expiry date (the market) | |
| 12= | tradeDate | DateKey | the trade date this summary is for | |
| 100 | eventNum | int | auction sequence index (= AtsDegrossAuctionSchedule (2358) auctionNumber): 1 = Trial, 2-5 = Real | |
| 101 | auctionDttm | DateTime | auction cycle timestamp of the latest event | |
| 110 | refUPrc | double | reference underlier price used | |
| 111 | strike | double | SR-chosen strike | |
| 112 | iDays | int | interest days to expiry | |
| 120 | clearingPrice | double | single clearing price at this event, PACKAGE space (0 = no cross) | |
| 121 | srClearingSDiv | double | clearing SDIV using SR rate + SR ddiv (0 = no cross; 0 with state=Unavailable = inversion failed) | |
| 122 | matchedSize | int | units crossed at this event (Trial: indicative, nothing prints) | |
| 123 | imbalanceSide | enum : BuySell | side of the residual imbalance after the event | |
| 124 | imbalanceSize | int | unmatched units on the imbalance side after the event | |
| 125 | srClearingSDivState | enum : DegrossRateState | whether srClearingSDiv is a real inversion: None = no cross, Ok = valid (a true 0 included), Unavailable = the clearing price has no admissible rate — consumers must not read the 0 as zero carry | |
| 130 | cumMatchedSize | int | units crossed across the day's Real events | |
| 131 | cumMatchedCash | double | package cash crossed across the day's Real events (clearingPrice x units x 100) | |
| 150 | timestamp | DateTime |
Get Schema API Call
- Python
- cUrl
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 = 'AtsDegrossMarketSummary'
# 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)
curl -G 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json' \
--data-urlencode 'apiKey=XXXX-XXXX-XXXX-XXXX' \
--data-urlencode 'cmd=getschema' \
--data-urlencode 'msgType=AtsDegrossMarketSummary'
Get Msg API Call
- Python
- cUrl
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 = 'AtsDegrossMarketSummary'
# 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 = 'eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|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 = ''
# 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)
curl -G 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json' \
--data-urlencode 'apiKey=XXXX-XXXX-XXXX-XXXX' \
--data-urlencode 'cmd=getmsg' \
--data-urlencode 'pkey=ReplaceThisValueForTheQueryToWork' \
--data-urlencode 'msgType=AtsDegrossMarketSummary' \
--data-urlencode 'view=eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|timestamp' \
--data-urlencode 'where='
Get Msgs API Call
- Python
- cUrl
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 = 'AtsDegrossMarketSummary'
# Replace with your desired view. A "|" separated list of views can be provided
# If no view is provided, all views will be returned
VIEW = 'eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|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 = ''
# 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 = 'eventNum: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)
curl -G 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json' \
--data-urlencode 'apiKey=XXXX-XXXX-XXXX-XXXX' \
--data-urlencode 'cmd=getmsgs' \
--data-urlencode 'msgType=AtsDegrossMarketSummary' \
--data-urlencode 'view=eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|timestamp' \
--data-urlencode 'where=' \
--data-urlencode 'limit=500' \
--data-urlencode 'order=eventNum:ASC'
Get Aggregate API Call
- Python
- cUrl
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 = 'AtsDegrossMarketSummary'
# Replace with fields you want to see aggregate values for. A "|" separated list of measures should be provided
MEASURE = 'eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|timestamp'
# Replace with fields you want to see aggregated. A "|" separated list of fields should be provided
GROUP = 'imbalanceSide|srClearingSDivState'
# 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 = ''
# 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)
curl -G 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json' \
--data-urlencode 'apiKey=XXXX-XXXX-XXXX-XXXX' \
--data-urlencode 'cmd=getaggregate' \
--data-urlencode 'msgType=AtsDegrossMarketSummary' \
--data-urlencode 'measure=eventNum|auctionDttm|refUPrc|strike|iDays|clearingPrice|srClearingSDiv|matchedSize|imbalanceSide|imbalanceSize|srClearingSDivState|cumMatchedSize|cumMatchedCash|timestamp' \
--data-urlencode 'group=imbalanceSide|srClearingSDivState' \
--data-urlencode 'where='
Get Count API Call
- Python
- cUrl
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 = 'AtsDegrossMarketSummary'
# 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 = ''
# 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)
curl -G 'https://mlink-live.nms.saturn.spiderrockconnect.com/rest/json' \
--data-urlencode 'apiKey=XXXX-XXXX-XXXX-XXXX' \
--data-urlencode 'cmd=getcount' \
--data-urlencode 'msgType=AtsDegrossMarketSummary' \
--data-urlencode 'where='