Endpoint Parameters

  • Request parameters

    Name Type Origin Description
    AccountKey AccountKey Route The account key to lookup the conditions for
    AssetType AssetType Route The assetType of the instrument to lookup
    FieldGroups ScheduledTradingConditionsFieldGroup [] Query-String Specify which field groups to return
    Uic Int Route The uic for the instrument to lookup
  • Response Parameters

    View Response Codes
    Name Type Description
    AccountCurrency String Currency of the selected account, used when listing currency conversion fees for the selected instrument back to the account currency.
    AccumulatedVolume Decimal The Accumulated FX volume calculated on the basis of discount profile period(Currently defaults to one month).
    AmountCurrency String Currency of the amount being listed.
    AmountOutstanding Decimal (Requires License) Outstanding debt of the bond.
    ApplicableFxCommissionRate Decimal The applicable commission rate for FX
    AssetType AssetType Asset Type
    AssetTypeClassification String Code indicating a mutual fund's classification. (Only available for instruments with AssetType = MutualFund).
    BondType BondType The type of bond.
    BorrowingRate Decimal The borrowing costs as a percentage per year for holding short positions in single-stock CFDs.
    CarryingCost CarryingCost For instruments where carrying costs are applied (futures, exchange traded options) , the percentage markup on the interbank interest rate applied for holding the position.
    CollateralValue Decimal The percentage of the instrument collateral value that can be used for margin trading.
    CommissionLimits CommissionLimit [] The commission structure for the selected instrument.
    Coupon Decimal (Requires License) The coupon value of the instrument.
    CouponDistributionFrequency CouponFrequency (Requires License) Frequency of coupon distribution
    CouponFixingFrequency CouponFrequency (Requires License) The frequency with which the floating rate changes.
    CouponFixToFloatDate Date (Requires License) Date when coupon will change from Fix to Float
    CouponFormula String (Requires License) Formula used to compute coupon value (ReferenceRate +/- Margin)
    CouponType BondsCouponType (Requires License) Fixed or floating rate coupon.
    CurrencyConversion CurrencyConversion The currency conversion.
    CurrentSpread Decimal Current spread.
    CustodyFees CustodyFee Custody fee per year for holding cash positions.
    DeflationFloorProtectionType LocalizedInfo Deflation floor protection, applicable only for Inflation Linked Bonds.
    ExchangeFeeRules ExchangeFeeRules [] Exchange fee rules if applied separately.
    ExposureLimits Exposure [] The maximum allowed exposure to the instrument.
    Financing Financing Financing charge markup.
    FinancingInterest FinancingInterest Financing interest.
    FirstCouponDate Date (Requires License) Date of next coupon payment.
    ForexPriceBands ForexPriceBand [] Forex pricebands.
    FundCountry String The country where a mutual fund is listed. (Only available for instruments with AssetType = MutualFund).
    FundCountryCode String Fund Country Code. (Only available for instruments with AssetType = MutualFund).
    FxForwardMaxOrderAutoPlaceAmount Decimal Indicates the maximum amount where orders of fx forwards are accepted.
    FxForwardMaxStreamingAmount Decimal Indicates the highest amount for which streaming prices for fx forwards can be expected.
    FxSpotMaxOrderAutoPlaceAmount Decimal Indicates the maximum amount where orders of fx spot are accepted.
    FxSpotMaxStreamingAmount Decimal Indicates the highest amount for which streaming prices for fx spot can be expected.
    HasKID Bool Whether the funds has an associated KID.
    HoldingFee HoldingFee Holding fee if applied.
    IndexRatio Decimal (Requires License) Interest Charged when MarginLending is used
    IndicativeSpread IndicativeSpread The spread used for fx forwards is indicative and depends on how far in the future the value date of the forward is. The different time horizon is called tenors and this collection shows a current snapshot of the spreads for the different tenors.
    InitialCollateralValue Decimal Initial Collateral Value for margin lending type account
    InstrumentCurrency String Instrument Currency.
    InstrumentMarginRequirements InstrumentMarginRequirement [] The margin requirements for the instrument. A margin requirement indicates the money reserved on the client’s account to cover a potential loss.
    InterestPerDay Financing Interest charged per day for SRDs
    InterestRateInstrumentMarginRequirement InstrumentMarginRequirement The base rate (1Y) interest rate margin requirement for the instrument.
    InternalCosts InternalCosts Internal costs are costs charged by a fund, but not booked by Saxo. They are simply running costs at the fund’s end for holding a position in the fund.
    IsBaseContractOnlineTradeable Bool Some instruments are tradable, but not through the API. This value indicates that a dealer is needed to manually place the trade.
    IsShortTraded Bool Indicates if the instrument is short traded.
    IsSrdEligible Bool Is eligible for SRD
    IssueDate Date (Requires License) Bond issue date.
    IssuePrice Decimal (Requires License) Bond issue price.
    IssuerName String (Requires License) The name of the entity that has issued this bond.
    IssueVolume Decimal (Requires License) The volume issued of a bond.
    IsTradable Bool Instrument is currently tradeable or not.
    LastCouponDate Date (Requires License) Last coupon date of bond.
    LoanInterest LoanInterest Loan interest.
    MaintenanceCollateralValue Decimal Maintenance Collateral Value for margin lending type account
    MarginSchedule MarginSchedule A margin schedule is an indication of the change in margin requirement rules as they change during a day.
    MarginTierRequirement MarginTierRequirement A margin tier expresses how much money is reserved on a client’s account to cover a potential loss. The tiers are expressed in the exposure to the instrument across positions. Values can vary depending on when the position is being held.
    Maturity Date (Requires License) The maturity date of a bond.
    MaxAutoExecute Decimal Indicates the maximum amount or number of contracts that are automatically accepted. Relevant for fx (spot and options), cfds and mutual funds. The value is not set for all instruments.
    MaximumCollateralAmount Decimal The maximum collateral value that we offer for a single share for margin lending type account
    MaximumCollateralAmountCurrency String The currency of MaximumCollateralAmount value
    MaximumCouponRate Decimal (Requires License) Maximum coupon rate (applicable for capped FRN’s)
    MaxStreamingAmountFarDate Decimal Max streaming amount for far dates for an fx forward.
    MaxStreamingAmountNearDate Decimal Max streaming amount for near dates for an fx forward.
    MinimumCouponRate Decimal (Requires License) Minimum coupon rate (applicable for floored FRN’s)
    MinOrderSize Decimal The minimum size of an order. For FX that is the nominal size of the resulting position (i.e. 5,000 USD for EURUSD). For listed products it is the value of the resulting position calculated in the instruments currency as a function of its price. Mutual Funds are special in that the order size can be denoted in a different currency than that of the instrument. That currency can be found in MinOrderSizeCurrency field.
    MinOrderSizeCurrency String Currency in which min order size is mentioned.
    Notes String [] (Requires License) Instrument notes.
    PortfolioBasedMargin PortfolioBasedMargin Portfoilio based margin
    PriceUnitDisplayName String The price unit display name.
    Rating Decimal Risk Rating.
    RiskIndicator Decimal Risk Indicator
    RolloverFee RolloverFee Rollover fee for SRDs - Charged if position is rolled over
    Rules Rule [] Rule set for trading.
    ScheduledTradingConditions ScheduledTradingConditions [] Scheduled Trading Conditions
    SpreadAsLowAs Decimal Lowest possible spread. Value only relevant for fx.
    SwapPoints SwapPoints Swap points per day.
    Taxes Tax [] (Requires License) List of taxes applied.
    TicketFee Fee A ticket fee is a charge for doing a trade. Ticket fees are for fx (both spot and options). A ticket fee is applied if below the TicketFeeThreshold.
    TicketFeeThreshold Decimal The commission threshold.
    Uic Int Instrument unique identifier
  • Request Example

    Request URL
    GET cs/v1/tradingconditions/instrument/7m4I|vtYLUnEGg77o9uQhw==/21/FxSpot/?FieldGroups=ScheduledTradingConditions
  • Response Example

    Response body
    {
      "AccountCurrency": "GBP",
      "AmountCurrency": "EUR",
      "AssetType": "FxSpot",
      "CarryingCost": {
        "FixedRate": 2.0,
        "InterbankRate": {
          "AskRate": 1.0,
          "BidRate": 2.0,
          "TradeDate": "0001-01-01"
        },
        "MarkUpRate": 2.0
      },
      "CommissionLimits": [
        {
          "Currency": "USD",
          "MinCommission": 3.0,
          "OrderAction": "ExecuteOrder",
          "RateOnAmount": 5E-05
        }
      ],
      "ExposureLimits": [
        {
          "Currency": "USD",
          "Identifier": "EUR",
          "Level": "Currency",
          "RuleType": "Value",
          "Value": 115000000.0
        },
        {
          "Currency": "USD",
          "Identifier": "USD",
          "Level": "Currency",
          "RuleType": "Value",
          "Value": 115000000.0
        },
        {
          "Currency": "USD",
          "Identifier": "Fx-NOP",
          "Level": "Asset",
          "RuleType": "Value",
          "Value": 50000000.0
        }
      ],
      "Financing": {
        "AskMarkUp": 2.0,
        "BidMarkDown": 2.0,
        "FixedRateAsk": 2.0,
        "FixedRateBid": 3.0,
        "InterbankRate": {
          "AskRate": 1.0,
          "BidRate": 2.0,
          "TradeDate": "0001-01-01"
        }
      },
      "FinancingInterest": {
        "InterbankRate": {
          "AskRate": 1.0,
          "BidRate": 2.0,
          "TradeDate": "0001-01-01"
        },
        "Markup": 1.0,
        "TradeDate": "0001-01-01"
      },
      "ForexPriceBands": [
        {
          "AutoExecuteEnabled": true,
          "AutoQuoteEnabled": true,
          "DisplayDecimals": 5,
          "MaxBand": 100000.0,
          "Spread": 1E-05,
          "SpreadType": "Variable",
          "UpperBandLimit": 100000.0
        },
        {
          "AutoExecuteEnabled": true,
          "AutoQuoteEnabled": true,
          "DisplayDecimals": 5,
          "MaxBand": 100000.0,
          "Spread": 2E-05,
          "SpreadType": "Variable",
          "UpperBandLimit": 25000000.0
        }
      ],
      "InstrumentCurrency": "USD",
      "IsTradable": true,
      "LoanInterest": {
        "InterbankRate": {
          "AskRate": 1.0,
          "BidRate": 2.0,
          "TradeDate": "0001-01-01"
        },
        "Markup": 2.0
      },
      "MarginTierRequirement": {
        "Entries": [
          {
            "ExtraWeekMarginRate": 0.015,
            "InitialMarginRate": 0.015,
            "IntraWeekMarginRate": 0.015,
            "TierLowerBound": 0.0
          },
          {
            "ExtraWeekMarginRate": 0.065,
            "InitialMarginRate": 0.055,
            "IntraWeekMarginRate": 0.045,
            "TierLowerBound": 1000000.0
          },
          {
            "ExtraWeekMarginRate": 0.025,
            "InitialMarginRate": 0.025,
            "IntraWeekMarginRate": 0.025,
            "TierLowerBound": 25000000.0
          },
          {
            "ExtraWeekMarginRate": 0.003,
            "InitialMarginRate": 0.003,
            "IntraWeekMarginRate": 0.003,
            "TierLowerBound": 50000000.0
          },
          {
            "ExtraWeekMarginRate": 0.035,
            "InitialMarginRate": 0.035,
            "IntraWeekMarginRate": 0.035,
            "TierLowerBound": 100000000.0
          },
          {
            "ExtraWeekMarginRate": 0.045,
            "InitialMarginRate": 0.045,
            "IntraWeekMarginRate": 0.045,
            "TierLowerBound": 150000000.0
          },
          {
            "ExtraWeekMarginRate": 0.05,
            "InitialMarginRate": 0.05,
            "IntraWeekMarginRate": 0.05,
            "TierLowerBound": 250000000.0
          }
        ],
        "TierCurrency": "USD"
      },
      "MinOrderSize": 1000.0,
      "MinOrderSizeCurrency": "EUR",
      "PortfolioBasedMargin": {
        "ExtremeStressFactor": 15.6,
        "Initial": 185.5,
        "IntraWeek": 8.7,
        "LiquidityThresholdAmount": 569987.0,
        "LiquidityThresholdCurrency": "USD",
        "VolatilityAddOn": 1000.68,
        "VolatilityStress": 100.0
      },
      "Rating": 0.0,
      "RiskIndicator": 0.0,
      "Rules": [
        "DayTradingNotAllowed",
        "ExchangeFeeConstituents",
        "NoMoreBuyOnExchange",
        "NoMoreBuyOnInstrument",
        "OrderAmendmentNotAllowed"
      ],
      "SpreadAsLowAs": 7E-05,
      "SwapPoints": {
        "AskPoint": 1.0,
        "BidPoint": 2.0,
        "Date": "0001-01-01",
        "Markup": 1.0,
        "TimeZoneAbbreviation": "CTE",
        "TimeZoneOffset": "00:00:00"
      },
      "TicketFeeThreshold": 50000.0,
      "Uic": 21
    }