Reference
Telegram commands
This section lists all commands that are available through the Telegram interface. All commands are prefixed with the forward slash character /, e.g. /status.
status
Displays a status summary with the following values:
- Daily P/L
- Week to Date P/L
- Month to Date P/L
- Year to Date P/L
- Open Trades
- Open Premium
- Open Theta
- Net Liquidation Value
- Buying Power
- Current SPX and VIX
positions
Displays a listing of all currently open positions.
Usage
/positions [tag]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
tag | No | all | Tag name, defaults to all |
config
Retrieves the bot configuration. This command displays a configuration summary for each bot and allows for the bot to be enabled or disabled.
Optionally, a confirmation prompt will be displayed before a bot is enabled (see also: confirmEnable).
If a bot is disabled while a position is still open, the position will be closed normally (either through profit target or stop loss). Once the bot is disabled, new positions will not be opened.
Usage
/config [tag]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
tag | No | all | Tag name, defaults to all |
day
Returns a summary of the daily trading statistics.
week
Returns a summary of weekly trading statistics.
month
Returns a summary of monthly trading statistics.
year
Returns an annual summary of trading statistics.
stats
Returns statistics for an arbitrary date range.
Usage
/stats <from> [to] [summary]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
from | Yes | — | Start date, e.g. 2022-01, 2022-01-01 |
to | No | Current date | Ending date, e.g. 2022-12, 2022-12-31 |
summary | No | false | Either true or false to include a summary for each individual bot |
export
Exports closed trades within the specified date range to a CSV file.
Usage
/export <from> [to]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
from | Yes | — | Start date, e.g. 2022-01, 2022-01-01 |
to | No | Current date | Ending date, e.g. 2022-12, 2022-12-31 |
delta
Displays the delta for the contract with the specified parameters.
Usage
/delta <delta> [put|call] [minDTE = 0] [maxDTE = 30]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
delta | Yes | — | The delta of the contract to search for. This should be specified as a whole number, e.g. 10. The sign does not matter. |
put|call | No | put | Determines whether to walk the put or call option chain. |
minDTE | No | 0 | Minimum days to expiration. |
maxDTE | No | 30 | Maximum days to expiration. |
chart
Renders an inline chart that displays overall strategy performance over time.
Usage
/chart [from] [to]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
from | No | Beginning of current year | The starting date for the chart, e.g. 2022-01. |
to | No | Current date | The ending date for the chart, e.g. 2023-01. |
daychart
Renders an inline chart that displays daily P/L for all bots.
Usage
/daychart [date]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
date | No | Current day | Date to use when rendering the chart, e.g. 2024-01-18. |
config
Displays a summary of each bot's configuration with the option to toggle the enabled status.
Bots that are disabled will have the option displayed to enable, while enabled bots will display an option to disable.
tags
Displays available tags or displays the bots that are associated with a given tag.
Usage
/tags [name]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
name | No | None | Tag name |
enable
Enable all bots with the specified tag.
Usage
/enable <tag>
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
tag | Yes | None | Tag name |
disable
Disable all bots with the specified tag.
Usage
/disable <tag>
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
tag | Yes | None | Tag name |
close
Displays a listing of all bots that have open positions with a link to manually close the position.
Passing a tag parameter will close all positions with the specified tag.
A confirmation will be displayed before any positions are closed.
Usage
/close [tag]
Arguments
| Name | Required | Default Value | Description |
|---|---|---|---|
tag | No | None | Tag name |
stops
Displays a listing of all bots that have open positions with stops enabled.
Selecting a position will allow you to toggle the enabled status for each stop configured on the position.
btc
Displays a listing of all bots that have open positions with buy to close (BTC) orders.
Selecting a position will allow you to cancel (or submit) a BTC order for a position.
bp
Displays available buying power and NLV.
pause / resume
Allows you to pause or resume the Trademade engine. Pausing the engine will prevent new positions from being entered, however stop loss monitors will continue to be enabled.
restart
Restarts Trademade.