---
title: "Details Of A Mobile Trading Alert"
method: GET
path: "/iserver/account/mta"
tags: ["tradingAlerts"]
---

# Details Of A Mobile Trading Alert

`GET /iserver/account/mta`

Retrieve information about your MTA alert. Each login user only has one mobile trading assistant (MTA) alert with it's own unique tool id that cannot be changed. MTA alerts can not be created or deleted, only modified. When modified a new order Id is generated.

## Response `200`

The alert description for the unique MTA alert on the account.

- AlertDetails — details of the specified alert
  - `account` string — Requestor's account ID
  - `order_id` integer — Alert's tracking ID. Can be used for modifying or deleting alerts.
  - `alertName` string — Human readable name of the alert.
  - `tif` string — Time in Force effective for the Alert
  - `expire_time` string — Returns the UTC formatted date used in GTD orders.
  - `alert_active` '1' | '0' — Returns if the alert is active [1] or disabled [0].
  - `alert_repeatable` integer — Returns if the alert can be sent more than once.
  - `alert_email` string — Returns the designated email address for sendMessage functionality.
  - `alert_send_message` integer — Returns whether or not the alert will send an email.
  - `alert_message` string — Returns the body content of what your alert will report once triggered
  - `alert_show_popup` integer — Returns whether or not the alert will trigger TWS Pop-up messages
  - `alert_play_audio` integer — Returns whether or not the alert will play audio
  - `order_status` 'Presubmitted' | 'Submitted' — represent order statusAlways returns "Presubmitted".
  - `alert_triggered` integer — Returns whether or not the alert was triggered yet.
  - `fg_color` string — Foreground color. Not applicable to API.
  - `bg_color` string — Background color. Not applicable to API.
  - `order_not_editable` boolean — Returns if the order can be edited.
  - `itws_orders_only` integer — Returns whether or not the alert will trigger mobile notifications.
  - `alert_mta_currency` string — Returns currency set for MTA alerts. Only valid for alert type 8 & 9.
  - `alert_mta_defaults` string — Returns current MTA default values.
  - `tool_id` integer — Tracking ID for MTA alerts only. Returns 'null' for standard alerts.
  - `time_zone` string — Returned for time-specific conditions.
  - `alert_default_type` integer — Returns default type set for alerts. Configured in Client Portal.
  - `condition_size` integer — Returns the total number of conditions in the alert.
  - `condition_outside_rth` integer — Returns whether or not the alert will trigger outside of regular trading hours.
  - `conditions` AlertCondition[] — Returns all conditions
    - `condition_type` integer — The type of condition set.
    - `conidex` string — Returns conid and exchange in the format "conid@exchange"
    - `contract_description_1` string — Includes relevant descriptions (if applicable).
    - `condition_operator` string — Condition operator set for alert.
    - `condition_trigger_method` integer — TriggerMethod value set.
    - `condition_value` string — Condition value set.
    - `condition_logic_bind` boolean — Condition logic_bind value set.
    - `condition_time_zone` string — Condition timeZone value set.

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)