Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
The Security List message is the response to the Security List Request GET message. It returns the list of Instruments that matches the criteria you specified in the request.
API Key Permission: Read
GET /API/swaplend/marketstructure/SecurityList
Request parameters
Field Name | Format | Req'd | Comments | |||||||
---|---|---|---|---|---|---|---|---|---|---|
MsgType | String | ✓ | y = SecurityList (lowercase Y) | |||||||
MsgSeqNum | SeqNum | ✓ | Incremental number used to identify if receiver missed a message | |||||||
SendingTime | UTCTimestamp | ✓ | Time of sending this message | |||||||
SecurityReportID | Int | Unique identifier | ||||||||
ClearingBusinessDate | LocalMktDate | E.g.: 20220818 | ||||||||
SecurityListDesc | String | All SWAPREPO/Lend traded Instruments with BTC/USD as underlying | ||||||||
SecurityRequestResult | Int | 0 = Valid request; | ||||||||
TransactTime | UTCTimestamp | 20220818-14:18:21.123 | ||||||||
TotNoRelatedSym | Int | Total number of Instruments being returned for this request. | ||||||||
MarketID | Exchange | XCDE | ||||||||
MarketSegmentID | String | SWAPREPO/Lend | ||||||||
<SecListGrp> Component Repeating block | > | NoRelatedSymInt | Number of Instrument in that response | |||||||
<Instrument> Component block | Repeating group | |||||||||
>> | Symbol | String | E.g.: BTC/USD-ID-R | |||||||
>> | Product | Int | 13 = Financing (Repo is a financing product) | |||||||
>> | SecurityGroup | String | ID = Intra-day; | |||||||
>> | SecurityType | String | REPO | |||||||
>> | MaturityDate | LocalMktDate | 20220822 (Settle date of Far_Leg) | |||||||
>> | MaturityTime | TZTimeOnly | 20220822-17:00-05 (for 5pm NY on Aug22) | |||||||
>> | SecurityStatus | String | 1 = Active | |||||||
>> | MinPriceIncrement | Float | 0.01 | |||||||
>> | SettlMethod | Char | P = Physical settlement required | |||||||
>> | SecurityDesc | String | BTC/USD Intra-day Repo | |||||||
<FinancingDetails> Component block | ||||||||||
>> | DeliveryType | Int | 0 = "Versus Payment": Deliver (if sell) or Receive (if buy) vs. (against) Payment | |||||||
<SecurityTradingRules> Component block | ||||||||||
<BaseTradingRules> Component block | ||||||||||
>>> | MinTradeVol | Qty | E.g: 1 = minimum order quantity that can be submitted | |||||||
>>> | PriceType | Int | 6 = Spread | |||||||
<UndInstrmtGrp> Component block | ||||||||||
<UnderlyingInstrument> Component block | Must be provided if Number of underlyings > 0 | |||||||||
>>> | UnderlyingSymbol | String | BTC/USD | |||||||
>>> | UnderlyingProduct | Int | 100 = CRYPTO (not yet a FIX Protocol standard value) | |||||||
>>> | UnderlyingSecurityType | String | CRYPTOCASH | |||||||
>>> | UnderlyingSecurityDesc | String | BTC/USD Cash | |||||||
> | Currency | USD = the currency this Repo is priced in | ||||||||
<InstrmtLegSecListGrp> Component Repeating block | >>||||||||||
NoLegs | 2 (always 2 for a Repo) | <InstrumentLeg> Component block | Description of the first leg of this Repo | |||||||
>>> | LegSymbol | String | BTC/USD-CASH | |||||||
>>> | LegSecurityDesc | String | BTC/USD Cash | |||||||
>>> | LegRatioQty | Float | 1 | |||||||
>>> | LegSide | Int | 2 = SELL | |||||||
>>> | LegCurrency | Currency | USD | |||||||
>>> | LegSettlType | Char | 1 = Cash (immediate settlement) | |||||||
>> | Text | String | Comment, instructions, or other identifying information. |
Example List message:
Code Block | ||
---|---|---|
| ||
{ "Header": { "MsgType": "y", "MsgSeqNum": "27683564", "SenderCompID": "SENDER", "TargetCompID": "TARGET", "SendingTime": "20220905-23:41:24.298" }, "SecurityReportID": "yd544a-ks67", "ClearingBusinessDate": "20220906", "SecurityListDesc": "All SWAPREPO/Lend Intraday Instruments with BTC/USD as underlying", "SecurityRequestResult": "0", "TransactTime": "20220905-23:41:24.045", "MarketID": "XCDE", "MarketSegmentID": SWAP"REPO/Lend", "SecListGrp": [ { "Instrument": { "Symbol": "BTC/USD-ID-R", "Product": "13", "SecurityGroup": "ID", "SecurityType": "REPO", MaturityDate: 20220906 MaturityTime: 20220906-17:00:00-05"SecurityStatus": "1", SecurityStatus: 1 "MinPriceIncrement": "0.01", "SettlMethod": "P", "SecurityDesc": "BTC/USD Intra-day Repo" DeliveryType: 0}, MinTradeVol"FinancingDetails": 1{ PriceType: 6 UndInstrmtGrp UnderlyingInstrument UnderlyingSymbol"DeliveryType": BTC/USD"0" UnderlyingProduct: 100}, UnderlyingSecurityType: CRYPTOCASH UnderlyingSecurityDesc"SecurityTradingRules": BTC/USD{ Cash Currency: USD InstrmtLegSecListGrp NoLegs InstrumentLeg LegSymbol"BaseTradingRules": BTC/USD-CASH{ LegSecurityDesc: BTC/USD Cash LegRatioQty"MinTradeVol": "1", LegSide: SELL LegCurrency: USD LegSettlType"PriceType": 1"6" InstrumentLeg LegSymbol: BTC/USD-SPOT } LegSecurityDesc: BTC/USD Spot LegRatioQty: 1}, LegSide: BUY LegCurrency"UndInstrmtGrp": USD{ LegSettlType: 0 Text | ||
Code Block | ||
| ||
{ "HeaderUnderlyingInstrument": { "MsgType "UnderlyingSymbol": "yBTC/USD", "MsgSeqNumUnderlyingProduct": "27683564100", "SenderCompID": "SENDER", "TargetCompIDUnderlyingSecurityType": "TARGETCRYPTOCASH", "SendingTime": "20220905-23:41:24.298" }, "SecurityReportIDUnderlyingSecurityDesc": "yd544a-ks67",BTC/USD Cash" "ClearingBusinessDate": "20220906", "SecurityListDesc": "All SWAP/Lend Intraday Instruments with BTC/USD as underlying", } }, "SecurityRequestResultCurrency": "0USD", "TransactTime": "20220905-23:41:24.045", "MarketIDInstrmtLegSecListGrp": "XCDE",[ "MarketSegmentID": "SWAP/Lend", "SecListGrp": { "NoRelatedSym": "2?" }, "InstrumentInstrumentLeg": [{ { "SymbolLegSymbol": "BTC/USD-ID-RCASH", "ProductLegSecurityDesc": "13BTC/USD Cash", "SecurityGroup "LegRatioQty": "ID1", "SecurityType "LegSide": "REPOSELL", "SecurityStatusLegCurrency": "1USD", "MinPriceIncrement "LegSettlType": "0.01"1" } }, "SettlMethod": "P", { "InstrumentLeg": { "SecurityDescLegSymbol": "BTC/USD Intra-day Repo"-SPOT", } ], "FinancingDetailsLegSecurityDesc": { "BTC/USD Spot", "DeliveryType": "0" }, "SecurityTradingRulesLegRatioQty": {"1", "BaseTradingRules": { "MinTradeVolLegSide": "1BUY", "PriceTypeLegCurrency": "6USD", } }, "UndInstrmtGrpLegSettlType": "0" { "UnderlyingInstrument": [ } { } "UnderlyingSymbol": "BTC/USD" ], }, ] } |
Expand | |||
---|---|---|---|
| |||
|