Get pre-trade cost illustration for regular instruments

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.

  HTTP Code	Description
  200	OK	Indicates that the request was performed correctly.
  400	BadRequest	Error Code Description InvalidRequest Indicates that the request is malformed.
  401	Unauthorized	Indicates that the request was rejected because the 'Authorization' header was missing in the request or contained an invalid security token.
  500	InternalServerError	Error Code Description InternalServerError Internal server error.
  503	ServiceUnavailable	Service Unavailable

  Close

• 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
  }