Endpoint Parameters
-
Request parameters
Name Type Origin Description AccountKey AccountKey Route The account key to lookup the conditions for FieldGroups ScheduledTradingConditionsFieldGroup [] Query-String Specify which field groups to return OptionRootId Integer Route The optionRootId for the option to lookup Uic Integer Query-String The uic for the instrument to lookup -
Response Parameters
View Response CodesName Type Description AccountCurrency String Currency of the selected account, used when listing currency conversion fees for the selected instrument back to the account currency. AssetType AssetType Asset Type CarryingCost CarryingCost For instruments where carrying costs are applied (futures, Exchange traded options) , the percentage markup on the intebank interest rate applied for holding the position. CommissionLimits CommissionLimit [] The commission structure for the selected instrument. CurrencyConversion CurrencyConversion The currency conversion. CurrentSpread Number Current spread. ExchangeFeeRules ExchangeFeeRules [] Exchange fee rules if applied separately. ExerciseCutOffTime String The last time the option can be traded. ExpirationTime String The last time on the expiry date the option can be traded. ExposureLimits Exposure [] The maximum allowed exposure to the instrument. FinanceInterestMarkUp Number Finance interest markup. HoldingFee HoldingFee Holding fee if applied. InstrumentCurrency String Instrument Currency. IsTradable Boolean Indicates whether the instrument is currently tradable. LoanInterest LoanInterest Loan interest. LoanInterestCharge Obsolete Number - Interest Charged when MarginLending is used Note : Use LoanInterest, as LoanInterestCharge is going to be decommissioned. MarginRequirement ContractOptionRootMarginRequirement The margin requirement for the contract option PortfolioBasedMargin PortfolioBasedMargin Portfolio based margin Rating Number Risk Rating. ScheduledContractOptionTradingConditions ScheduledContractOptionTradingCondition [] Scheduled Trading Conditions for Contract Options SettlementStyle SettlementStyle An option is either cash settled or settled with a position in the underlying asset. This value indicates what the behavior of the specific option is. SwapInterestMarkUp Number Swap interest markup Taxes Tax [] (Requires License) List of taxes applied. Uic Integer Instrument unique identifier -
Request Example
Request URL
GET /cs/v1/tradingconditions/ContractOptionSpaces/7m4I|vtYLUnEGg77o9uQhw==/232?FieldGroups=ScheduledTradingConditions&Uic=30256728
-
Response Example
Response body
{ "AccountCurrency": "GBP", "AssetType": "FxSpot", "CarryingCost": { "FixedRate": 1, "InterbankRate": { "AskRate": 2, "BidRate": 1, "TradeDate": "2024-12-18T00:00:00Z" }, "MarkUpRate": 1.5 }, "CommissionLimits": [ { "Currency": "USD", "OrderAction": "ExecuteOrder", "PerUnitRate": 6 } ], "ExerciseCutOffTime": "2024-12-19T16:30:00Z", "ExpirationTime": "2024-12-19T14:30:00Z", "ExposureLimits": [ { "Identifier": "CL", "Level": "BaseContractNet", "RuleType": "Amount", "Value": 200 } ], "FinanceInterestMarkUp": 9.99, "HoldingFee": { "FromPeriodInDays": 120, "Value": 1.6 }, "InstrumentCurrency": "USD", "IsTradable": true, "MarginRequirement": { "MinimumUnderlyingValue": 0.5, "Premium": 1, "TradingProfile": "Basic", "UnderlyingValueOvernightExposure": 1 }, "PortfolioBasedMargin": { "ExtremeStressFactor": 15.6, "Initial": 185.5, "IntraWeek": 8.7, "LiquidityThresholdAmount": 569987, "LiquidityThresholdCurrency": "USD", "VolatilityAddOn": 1000.68, "VolatilityStress": 100 }, "Rating": 5, "SettlementStyle": "PhysicalDelivery", "SwapInterestMarkUp": 1.11, "Taxes": [ { "BuySell": "Buy", "CalculationTriggerType": "Normal", "CalculationType": "ValueFraction", "Description": "UK Stamp Duty", "Value": 0.5 } ], "Uic": 0 }