---
title: "Place an order"
method: POST
path: "/accounts/{account_id}/orders"
tags: ["trading"]
---

# Place an order

`POST /accounts/{account_id}/orders`

Places a buy-side or sell-side market or limit order. Buys are cash-based; sells require a unit quantity.

## Path parameters

- `account_id` string, required

## Request body

- PlaceOrderRequest
  - `automatic_rollover` boolean, nullable — Whether the resulting position rolls into a similar instrument at maturity; valid only for eligible buy orders.
  - `cash_amount` union — Pre-fee cash amount required for buy orders.
    - number
    - string
  - `instrument` string, required — The ID of the instrument to buy or sell.
  - `limit_price` union — Positive price required for limit orders and rejected for market orders.
    - number
    - string
  - `order_type` 'market' | 'limit', required
  - `quantity` union — Positive unit quantity required for sell orders.
    - number
    - string
  - `quote` string, nullable — ID of a previously issued order quote. FX orders replay the locked rate; security cash buys may reference a prior quote for a deviation check against the quoted amount.
  - `side` 'buy' | 'sell', required

## Response `201`

Created

- Order
  - `account` string, nullable — ID of the parent account. Present on customer orders; `null` for system-placed orders.
  - `automatic_rollover` boolean, nullable — Customer's automatic rollover preference; set only on eligible buy orders.
  - `cancelled_at` string, date-time, nullable — The time the order was cancelled.
  - `cancelled_reason` string, nullable — The reason for cancelling the order, if cancelled.
  - `cash_amount` string, nullable — The amount to invest (before fees). Buy orders are cash-based (you specify how much to invest, not how many units to buy).
  - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
  - `currency` 'EUR' | 'USD' | 'GBP'
  - `fees` string, required — The total fees for this order.
  - `filled_at` string, date-time, nullable — The time the order was filled.
  - `id` string, required — Unique resource identifier.
  - `instrument` union, required — The instrument to buy or sell.
    - Bill
      - `about` string, nullable — Summary of the instrument.
      - `days_to_maturity` integer, required — Calendar days remaining until maturity.
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
      - `exchange` string, nullable — MIC of the listing venue.
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `initial_auction_date` string, date, nullable, required — Date of the first auction.
      - `initial_issue_date` string, date, required — Date the instrument was first issued.
      - `instrument_type` 'bill', required — Instrument type.
      - `isin` string, required — International Securities Identification Number.
      - `issuer` string, required — Name of the issuer.
      - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
      - `issuer_credit_rating` string, required — Issuer credit rating.
      - `latest_auction_date` string, date, nullable, required — Date of the latest auction, including tap issues.
      - `latest_issue_date` string, date, nullable, required — Date of the latest issue, including tap issues.
      - `maturity_date` string, date, required — Date the instrument matures.
      - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
      - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
      - `name` string, required — Display name of the instrument.
      - `par_value` string, nullable, required — Nominal value per unit used for price quotation.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `supports_automatic_rollover` boolean, required — Whether positions can roll over automatically at maturity.
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `ticker` string, nullable — Ticker symbol of the security.
      - `trading_currency` 'EUR' | 'USD' | 'GBP', required
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
    - CurrencyPair
      - `about` string, nullable — Summary of the instrument.
      - `base_currency` 'EUR' | 'USD' | 'GBP', required
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `exchange` string, nullable — MIC of the listing venue.
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `instrument_type` 'currency_pair', required — Instrument type.
      - `name` string, required — Display name of the instrument.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `quote_currency` 'EUR' | 'USD' | 'GBP', required
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
    - Bond
      - `about` string, nullable — Summary of the instrument.
      - `coupon` string, required — Annual coupon rate as a percentage.
      - `coupon_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly' | 'biennial', required
      - `coupon_type` 'fixed_coupon' | 'floating_coupon' | 'zero_coupon' | 'stepped_coupon' | 'deferred_coupon' | 'pay_in_kind_coupon' | 'indexed_coupon' | 'credit_linked_coupon', required
      - `day_count_convention` '30_360' | 'actual_360' | 'actual_365_fixed' | 'actual_actual'
      - `days_to_maturity` integer, required — Calendar days remaining until maturity.
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
      - `exchange` string, nullable — MIC of the listing venue.
      - `first_coupon_date` string, date, nullable — Date of the first scheduled coupon payment.
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `initial_auction_date` string, date, nullable, required — Date of the first auction.
      - `initial_issue_date` string, date, required — Date the instrument was first issued.
      - `instrument_type` 'bond', required — Instrument type.
      - `isin` string, required — International Securities Identification Number.
      - `issuer` string, required — Name of the issuer.
      - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
      - `issuer_credit_rating` string, required — Issuer credit rating.
      - `latest_auction_date` string, date, nullable, required — Date of the latest auction, including tap issues.
      - `latest_issue_date` string, date, nullable, required — Date of the latest issue, including tap issues.
      - `maturity_date` string, date, required — Date the instrument matures.
      - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
      - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
      - `name` string, required — Display name of the instrument.
      - `next_coupon_date` string, date, nullable — Next scheduled coupon payment date.
      - `par_value` string, nullable, required — Nominal value per unit used for price quotation.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `supports_automatic_rollover` boolean, required — Whether positions can roll over automatically at maturity.
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `ticker` string, nullable — Ticker symbol of the security.
      - `trading_currency` 'EUR' | 'USD' | 'GBP', required
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
      - `upcoming_coupon_amount_per_unit` string, nullable — Next coupon cash amount per unit of face quantity.
    - MoneyMarketFund
      - `about` string, nullable — Summary of the instrument.
      - `benchmark` string, nullable, required — Benchmark used to evaluate fund performance.
      - `dealing_deadline` string, time, required — Daily cutoff time for placing orders.
      - `dealing_deadline_time_and_day` string, required — Next dealing cutoff shown as time and date.
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
      - `exchange` string, nullable — MIC of the listing venue.
      - `fund_management_company` string, required — Company that manages the fund.
      - `fund_ongoing_charges` string, required — Annual ongoing charges as a percentage.
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `initial_issue_date` string, date, required — Date the fund was first issued.
      - `instrument_type` 'money_market_fund', required — Instrument type.
      - `investment_objective` string, nullable, required — Investment objective of the fund.
      - `is_passed_dealing_deadline` boolean, required — Whether today's dealing cutoff has passed.
      - `is_qualifying_mmf` boolean, required — Whether the fund qualifies as a QMMF under MiFID.
      - `isin` string, required — International Securities Identification Number.
      - `issuer` string, required — Name of the issuer.
      - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
      - `issuer_credit_rating` string, required — Issuer credit rating.
      - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
      - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
      - `name` string, required — Display name of the instrument.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `ticker` string, nullable — Ticker symbol of the security.
      - `trading_currency` 'EUR' | 'USD' | 'GBP', required
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
    - AMC
      - `about` string, nullable — Summary of the instrument.
      - `dealing_deadline` string, time, required — Daily cutoff time for placing orders.
      - `dealing_deadline_time_and_day` string, required — Next dealing cutoff shown as time and date.
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
      - `exchange` string, nullable — MIC of the listing venue.
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `initial_issue_date` string, date, required — Date the instrument was first issued.
      - `instrument_type` 'amc', required — Instrument type.
      - `is_passed_dealing_deadline` boolean, required — Whether today's dealing cutoff has passed.
      - `isin` string, required — International Securities Identification Number.
      - `issuer` string, required — Name of the issuer.
      - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
      - `issuer_credit_rating` string, required — Issuer credit rating.
      - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
      - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
      - `name` string, required — Display name of the instrument.
      - `portfolio_manager` string, nullable, required — Name of the portfolio manager.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `provider` string, nullable, required — Provider of the instrument.
      - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
      - `risk_profile` string, nullable, required — Risk profile.
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `share_class` string, nullable, required — Share class.
      - `strategy` string, nullable, required — Investment strategy.
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `ticker` string, nullable — Ticker symbol of the security.
      - `trading_currency` 'EUR' | 'USD' | 'GBP', required
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
    - ETF
      - `about` string, nullable — Summary of the instrument.
      - `currency_sentence` string, nullable, required — Plain-language description of the fund's currency risk.
      - `decimal_precision` integer, required — Decimal places used by the trading increment.
      - `display_name` string, nullable, required — Short card headline derived from the legal name with share-class tokens removed.
      - `distribution_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly', required
      - `distribution_policy` 'accumulating' | 'distributing', required
      - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
      - `exchange` string, nullable — MIC of the listing venue.
      - `expense_ratio` string, nullable, required — Annual expense ratio as a fraction of assets.
      - `fund_base_currency` 'EUR' | 'USD' | 'GBP', required
      - `fund_category` string, nullable, required — Fund category.
      - `fund_domicile` string, nullable, required — ISO 3166-1 alpha-2 domicile country code.
      - `fund_management` string, nullable, required — Legal company that manages the fund.
      - `headline` string, nullable, required — One-line "what do I own" summary shown on the holding card.
      - `hedge_currency` 'EUR' | 'USD' | 'GBP', required
      - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
      - `id` string, required — Unique resource identifier.
      - `initial_issue_date` string, date, nullable, required — Fund inception date.
      - `instrument_type` 'etf', required — Instrument type.
      - `isin` string, required — International Securities Identification Number.
      - `issuer` string, nullable, required — Brand-level name of the fund issuer.
      - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
      - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
      - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
      - `name` string, required — Display name of the instrument.
      - `net_assets` string, nullable — Total net asset value of the fund.
      - `price_type` 'percent' | 'money', required
      - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
      - `replication_method` 'physical' | 'sampling' | 'synthetic', required
      - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
      - `rhp_years` integer, nullable, required — Recommended holding period in years from the PRIIPs KID.
      - `rollout_stage` 'ga' | 'beta' | 'provisional', required
      - `sri` 1 | 2 | 3 | 4 | 5 | 6 | 7, required
      - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
      - `ticker` string, required — Ticker symbol of the ETF listing.
      - `tracking_index` string, nullable, required — Index tracked by the fund.
      - `trading_currency` 'EUR' | 'USD' | 'GBP', required
      - `trading_increment` string, required — Smallest quantity increment accepted for orders.
      - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
  - `is_cancellable` boolean, required — Whether the order can be cancelled now; true only for limit orders in a cancellable phase with no fills.
  - `limit_price` string, nullable — Limit price per unit; `null` for market orders.
  - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
  - `net_cash_amount` string, nullable — The amount to invest after fees. This is what gets traded.
  - `order_type` 'market' | 'limit', required
  - `position` string, nullable — ID of the position this order belongs to; `null` until the order executes.
  - `purpose` 'user_request' | 'rollover' | 'square_off' | 'backfill', required
  - `quantity` string, nullable — Requested unit quantity for sell orders.
  - `quote` string, nullable — ID of the quote used to place this order. On FX orders, locks the executing rate; when omitted, the order trades at the live rate.
  - `settled_at` string, date-time, nullable — The time the order was settled.
  - `side` 'buy' | 'sell', required
  - `status` 'held' | 'placed' | 'executing' | 'cancelling' | 'filled' | 'settled' | 'cancelled', required
  - `traded_notional` string, required — The total notional value executed.
  - `traded_quantity` string, required — The total quantity executed.
  - `trades` OrderTrade[], required — All trades executed to fill this order.
    - `account` string, nullable, required — ID of the account that owns the trade.
    - `accrued_interest` string, nullable — The accrued interest included in the notional amount.
    - `counterparty` string, nullable, required — The ID of the counterparty.
    - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
    - `executed_at` string, date-time, required — The time the trade was executed.
    - `execution_audit_trail` string, nullable, required — The execution audit trail.
    - `execution_broker` string, required — The executing broker.
    - `execution_reference` string, required — The execution reference.
    - `id` string, required — Unique resource identifier.
    - `instrument` union, required — The traded instrument.
      - Bill
        - `about` string, nullable — Summary of the instrument.
        - `days_to_maturity` integer, required — Calendar days remaining until maturity.
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
        - `exchange` string, nullable — MIC of the listing venue.
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `initial_auction_date` string, date, nullable, required — Date of the first auction.
        - `initial_issue_date` string, date, required — Date the instrument was first issued.
        - `instrument_type` 'bill', required — Instrument type.
        - `isin` string, required — International Securities Identification Number.
        - `issuer` string, required — Name of the issuer.
        - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
        - `issuer_credit_rating` string, required — Issuer credit rating.
        - `latest_auction_date` string, date, nullable, required — Date of the latest auction, including tap issues.
        - `latest_issue_date` string, date, nullable, required — Date of the latest issue, including tap issues.
        - `maturity_date` string, date, required — Date the instrument matures.
        - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
        - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
        - `name` string, required — Display name of the instrument.
        - `par_value` string, nullable, required — Nominal value per unit used for price quotation.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `supports_automatic_rollover` boolean, required — Whether positions can roll over automatically at maturity.
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `ticker` string, nullable — Ticker symbol of the security.
        - `trading_currency` 'EUR' | 'USD' | 'GBP', required
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
      - CurrencyPair
        - `about` string, nullable — Summary of the instrument.
        - `base_currency` 'EUR' | 'USD' | 'GBP', required
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `exchange` string, nullable — MIC of the listing venue.
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `instrument_type` 'currency_pair', required — Instrument type.
        - `name` string, required — Display name of the instrument.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `quote_currency` 'EUR' | 'USD' | 'GBP', required
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
      - Bond
        - `about` string, nullable — Summary of the instrument.
        - `coupon` string, required — Annual coupon rate as a percentage.
        - `coupon_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly' | 'biennial', required
        - `coupon_type` 'fixed_coupon' | 'floating_coupon' | 'zero_coupon' | 'stepped_coupon' | 'deferred_coupon' | 'pay_in_kind_coupon' | 'indexed_coupon' | 'credit_linked_coupon', required
        - `day_count_convention` '30_360' | 'actual_360' | 'actual_365_fixed' | 'actual_actual'
        - `days_to_maturity` integer, required — Calendar days remaining until maturity.
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
        - `exchange` string, nullable — MIC of the listing venue.
        - `first_coupon_date` string, date, nullable — Date of the first scheduled coupon payment.
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `initial_auction_date` string, date, nullable, required — Date of the first auction.
        - `initial_issue_date` string, date, required — Date the instrument was first issued.
        - `instrument_type` 'bond', required — Instrument type.
        - `isin` string, required — International Securities Identification Number.
        - `issuer` string, required — Name of the issuer.
        - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
        - `issuer_credit_rating` string, required — Issuer credit rating.
        - `latest_auction_date` string, date, nullable, required — Date of the latest auction, including tap issues.
        - `latest_issue_date` string, date, nullable, required — Date of the latest issue, including tap issues.
        - `maturity_date` string, date, required — Date the instrument matures.
        - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
        - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
        - `name` string, required — Display name of the instrument.
        - `next_coupon_date` string, date, nullable — Next scheduled coupon payment date.
        - `par_value` string, nullable, required — Nominal value per unit used for price quotation.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `supports_automatic_rollover` boolean, required — Whether positions can roll over automatically at maturity.
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `ticker` string, nullable — Ticker symbol of the security.
        - `trading_currency` 'EUR' | 'USD' | 'GBP', required
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
        - `upcoming_coupon_amount_per_unit` string, nullable — Next coupon cash amount per unit of face quantity.
      - MoneyMarketFund
        - `about` string, nullable — Summary of the instrument.
        - `benchmark` string, nullable, required — Benchmark used to evaluate fund performance.
        - `dealing_deadline` string, time, required — Daily cutoff time for placing orders.
        - `dealing_deadline_time_and_day` string, required — Next dealing cutoff shown as time and date.
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
        - `exchange` string, nullable — MIC of the listing venue.
        - `fund_management_company` string, required — Company that manages the fund.
        - `fund_ongoing_charges` string, required — Annual ongoing charges as a percentage.
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `initial_issue_date` string, date, required — Date the fund was first issued.
        - `instrument_type` 'money_market_fund', required — Instrument type.
        - `investment_objective` string, nullable, required — Investment objective of the fund.
        - `is_passed_dealing_deadline` boolean, required — Whether today's dealing cutoff has passed.
        - `is_qualifying_mmf` boolean, required — Whether the fund qualifies as a QMMF under MiFID.
        - `isin` string, required — International Securities Identification Number.
        - `issuer` string, required — Name of the issuer.
        - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
        - `issuer_credit_rating` string, required — Issuer credit rating.
        - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
        - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
        - `name` string, required — Display name of the instrument.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `ticker` string, nullable — Ticker symbol of the security.
        - `trading_currency` 'EUR' | 'USD' | 'GBP', required
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
      - AMC
        - `about` string, nullable — Summary of the instrument.
        - `dealing_deadline` string, time, required — Daily cutoff time for placing orders.
        - `dealing_deadline_time_and_day` string, required — Next dealing cutoff shown as time and date.
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
        - `exchange` string, nullable — MIC of the listing venue.
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `initial_issue_date` string, date, required — Date the instrument was first issued.
        - `instrument_type` 'amc', required — Instrument type.
        - `is_passed_dealing_deadline` boolean, required — Whether today's dealing cutoff has passed.
        - `isin` string, required — International Securities Identification Number.
        - `issuer` string, required — Name of the issuer.
        - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
        - `issuer_credit_rating` string, required — Issuer credit rating.
        - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
        - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
        - `name` string, required — Display name of the instrument.
        - `portfolio_manager` string, nullable, required — Name of the portfolio manager.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `provider` string, nullable, required — Provider of the instrument.
        - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
        - `risk_profile` string, nullable, required — Risk profile.
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `share_class` string, nullable, required — Share class.
        - `strategy` string, nullable, required — Investment strategy.
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `ticker` string, nullable — Ticker symbol of the security.
        - `trading_currency` 'EUR' | 'USD' | 'GBP', required
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
      - ETF
        - `about` string, nullable — Summary of the instrument.
        - `currency_sentence` string, nullable, required — Plain-language description of the fund's currency risk.
        - `decimal_precision` integer, required — Decimal places used by the trading increment.
        - `display_name` string, nullable, required — Short card headline derived from the legal name with share-class tokens removed.
        - `distribution_frequency` 'annual' | 'semi_annual' | 'quarterly' | 'monthly', required
        - `distribution_policy` 'accumulating' | 'distributing', required
        - `enforce_trading_rules` boolean, required — Whether order amounts must satisfy the instrument trading rules.
        - `exchange` string, nullable — MIC of the listing venue.
        - `expense_ratio` string, nullable, required — Annual expense ratio as a fraction of assets.
        - `fund_base_currency` 'EUR' | 'USD' | 'GBP', required
        - `fund_category` string, nullable, required — Fund category.
        - `fund_domicile` string, nullable, required — ISO 3166-1 alpha-2 domicile country code.
        - `fund_management` string, nullable, required — Legal company that manages the fund.
        - `headline` string, nullable, required — One-line "what do I own" summary shown on the holding card.
        - `hedge_currency` 'EUR' | 'USD' | 'GBP', required
        - `icon_url` string, nullable — Public CDN URL of the instrument's icon.
        - `id` string, required — Unique resource identifier.
        - `initial_issue_date` string, date, nullable, required — Fund inception date.
        - `instrument_type` 'etf', required — Instrument type.
        - `isin` string, required — International Securities Identification Number.
        - `issuer` string, nullable, required — Brand-level name of the fund issuer.
        - `issuer_country` string, nullable, required — ISO 3166-1 alpha-2 country code of the issuer.
        - `minimum_initial_cash_investment` string, required — Minimum cash amount accepted for an initial investment.
        - `minimum_trading_quantity` string, required — Smallest quantity accepted for an order.
        - `name` string, required — Display name of the instrument.
        - `net_assets` string, nullable — Total net asset value of the fund.
        - `price_type` 'percent' | 'money', required
        - `pro_traders_only` boolean, required — Whether the instrument is restricted to professional investors.
        - `replication_method` 'physical' | 'sampling' | 'synthetic', required
        - `required_cash_increment` integer, required — Cash increment accepted above the minimum investment.
        - `rhp_years` integer, nullable, required — Recommended holding period in years from the PRIIPs KID.
        - `rollout_stage` 'ga' | 'beta' | 'provisional', required
        - `sri` 1 | 2 | 3 | 4 | 5 | 6 | 7, required
        - `symbol` string, required — Market identifier, such as an ISIN or currency pair.
        - `ticker` string, required — Ticker symbol of the ETF listing.
        - `tracking_index` string, nullable, required — Index tracked by the fund.
        - `trading_currency` 'EUR' | 'USD' | 'GBP', required
        - `trading_increment` string, required — Smallest quantity increment accepted for orders.
        - `trading_status` 'buy_sell' | 'buy_only' | 'sell_only' | 'not_trading', required
    - `is_reportable` boolean, nullable, required — Whether the trade is reportable.
    - `meta` object, nullable, required — Additional trade metadata.
    - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
    - `notional` string, required — The executed notional amount.
    - `notional_currency` 'EUR' | 'USD' | 'GBP', required
    - `order` string, required — The ID of the order.
    - `position` string, nullable, required — ID of the resulting position.
    - `price` string, required — The execution price per unit.
    - `quantity` string, required — The executed quantity.
    - `quantity_currency` 'EUR' | 'USD' | 'GBP', required
    - `settled_at` string, date-time, nullable, required — The time the trade settled.
    - `settlement_batch_id` string, nullable, required — The ID of the settlement batch.
    - `settlement_date` string, date, nullable, required — The scheduled settlement date.
    - `side` 'buy' | 'sell', required
    - `status` 'executed' | 'settled', required
    - `trading_venue` string, nullable, required — The venue where the trade was executed.
    - `tvtic` string, nullable, required — The trading venue transaction identification code.
    - `ytm` string, nullable, required — The yield to maturity at execution.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/versions/250f4b477cbf/schema)