Endpoint Parameters

  • Request parameters

    Name Type Origin Description
    AccountKey AccountKey Route The account key to lookup the conditions for
    Amount Decimal Query-String The number of asset to be traded.
    AssetType AssetType Route The assetType of the instrument to lookup
    FieldGroups TradingConditionFieldGroup [] Query-String The field groups.
    HoldingPeriodInDays Int Query-String The holding period in days if provided else 1 day.
    Price Decimal Query-String The instrument price to be used for the calculation. Required for all non-Saxo applications.
    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.
    AccountID String Unique ID of the account.
    Amount Decimal Number of instrument.
    AssetType AssetType Asset Type
    Cost TradeCost Trade Cost for the instrument.
    CostCalculationAssumptions CostAssumption [] Calculation Assumptions
    DisplayAndFormat InstrumentDisplayAndFormat Includes Symbol and formatting info. (standard object also used in most other service groups)
    HoldingPeriodInDays Int Holding period in days.
    Instrument String Description of instrument.
    Price Decimal Price of instrument.
    Uic Int Instrument UIC.
  • Request Example

    Request URL
    GET cs/v1/tradingconditions/cost/7m4I|vtYLUnEGg77o9uQhw==/21/FxSpot/?Amount=10000&FieldGroups=DisplayAndFormat&Price=1.19376&HoldingPeriodInDays=5
  • Response Example

    Response body
    {
      "AccountCurrency": "GBP",
      "AccountID": "125567INET",
      "Amount": 10000.0,
      "AssetType": "FxSpot",
      "Cost": {
        "Long": {
          "BuySell": "Buy",
          "Currency": "USD",
          "HoldingCost": {
            "Tax": [
              {
                "Pct": 0.5,
                "Rule": {
                  "BuySell": "Sell",
                  "CalculationType": "ValueFraction",
                  "Description": "UK Stamp Duty",
                  "Value": 0.5
                },
                "Value": 92.92
              },
              {
                "Pct": 0.005,
                "Rule": {
                  "BuySell": "Sell",
                  "CalculationType": "FixedAmount",
                  "Description": "UK PTM Levy",
                  "Value": 0.5
                },
                "Value": 1.0
              }
            ]
          },
          "ReturnOnInvestment": {
            "Return": {
              "Pct": 0.019,
              "Rule": {
                "Pct": 0.5
              },
              "Value": 3.507
            },
            "ReturnIncludingCost": {
              "Pct": 0.019,
              "Rule": {
                "Pct": 0.5
              },
              "Value": 3.507
            }
          },
          "TotalCost": 6.672,
          "TotalCostPct": 0.056,
          "TradingCost": {
            "Commissions": [
              {
                "Pct": 0.05,
                "Rule": {
                  "Currency": "USD",
                  "MinCommission": 3.0
                },
                "Value": 6.0
              }
            ],
            "CurrencyConversionCost": {
              "Pct": 0.05,
              "Rule": {
                "AskRate": 2.0,
                "BidRate": 1.0
              },
              "Value": 5.0
            },
            "Spread": {
              "DisplayDecimals": 4,
              "Rule": {
                "Pct": 1E-05
              },
              "Value": 0.1
            },
            "VatOnCustodyFeePct": {
              "Pct": 0.002,
              "Rule": {
                "Pct": 0.002,
                "Value": 20.0
              },
              "Value": 20.0
            }
          }
        },
        "Short": {
          "BuySell": "Sell",
          "Currency": "USD",
          "HoldingCost": {
            "Tax": [
              {
                "Pct": 0.5,
                "Rule": {
                  "BuySell": "Sell",
                  "CalculationType": "ValueFraction",
                  "Description": "UK Stamp Duty",
                  "Value": 0.5
                },
                "Value": 92.92
              },
              {
                "Pct": 0.005,
                "Rule": {
                  "BuySell": "Sell",
                  "CalculationType": "FixedAmount",
                  "Description": "UK PTM Levy",
                  "Value": 0.5
                },
                "Value": 1.0
              }
            ]
          },
          "ReturnOnInvestment": {
            "Return": {
              "Pct": 0.019,
              "Rule": {
                "Pct": 0.5
              },
              "Value": 3.507
            },
            "ReturnIncludingCost": {
              "Pct": 0.019,
              "Rule": {
                "Pct": 0.5
              },
              "Value": 3.507
            }
          },
          "TotalCost": 6.672,
          "TotalCostPct": 0.056,
          "TradingCost": {
            "Commissions": [
              {
                "Pct": 0.05,
                "Rule": {
                  "Currency": "USD",
                  "MinCommission": 3.0
                },
                "Value": 6.0
              }
            ],
            "Spread": {
              "DisplayDecimals": 4,
              "Rule": {
                "Pct": 1E-05
              },
              "Value": 0.1
            }
          }
        }
      },
      "CostCalculationAssumptions": [
        "IncludesOpenAndCloseCost",
        "EquivalentOpenAndClosePrice"
      ],
      "DisplayAndFormat": {
        "BarrierFormat": "Normal",
        "Currency": "USD",
        "Decimals": 4,
        "Description": "Euro/US Dollar",
        "Format": "Normal",
        "OrderDecimals": 2,
        "StrikeFormat": "Normal",
        "Symbol": "EURUSD"
      },
      "HoldingPeriodInDays": 5,
      "Instrument": "EURUSD",
      "Price": 1.19376,
      "Uic": 21
    }