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	Number	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	Integer	Query-String	The holding period in days if provided else 1 day.
  Price	Number	Query-String	The instrument price to be used for the calculation. Required for all non-Saxo applications.
  Uic	Integer	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	Number	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	Integer	Holding period in days.
  Instrument	String	Description of instrument.
  Price	Number	Price of instrument.
  Uic	Integer	Instrument UIC.

  HTTP Code	Description
  200	OK	Indicates that the request was performed correctly.
  400	Bad Request	Error Code Description InvalidRequest Default error code returned when it cannot be determined which part of 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.
  429	Too Many Requests	The request was rejected due to rate limit being exceeded.
  500	Internal Server Error	Internal Server Error
  503	Service Unavailable	Service Unavailable.

  Close

• Request Example

  Request URL

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

• Response Example

  Response body

  {
    "AccountCurrency": "GBP",
    "AccountID": "125567INET",
    "Amount": 10000,
    "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
            }
          ]
        },
        "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
              },
              "Value": 6
            }
          ],
          "CurrencyConversionCost": {
            "Pct": 0.05,
            "Rule": {
              "AskRate": 2,
              "BidRate": 1
            },
            "Value": 5
          },
          "Spread": {
            "DisplayDecimals": 4,
            "Rule": {
              "Pct": 1E-05
            },
            "Value": 0.1
          },
          "VatOnCustodyFeePct": {
            "Pct": 0.002,
            "Rule": {
              "Pct": 0.002,
              "Value": 20
            },
            "Value": 20
          }
        }
      },
      "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
            }
          ]
        },
        "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
              },
              "Value": 6
            }
          ],
          "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
  }