Understanding Altrady's Position Info widget

Introduction

The Position Info widget provides analytics and trading controls for positions on the currently-selected market (e.g. Kucoin ETH/USDT) and Trading Account (e.g. Kucoin paper account). It displays real-time metrics including the Break Even Price and current PnL, and provides quick access to key trading actions.
Use this widget to monitor profitability, assess risk, and manage your position effectively — all in one place.

Contents

Overview
How to Activate the Position Info Widget
Position Info Widget Components
Position Types
Position Metadata and Position Creation
Fields Shown in the Position Info Widget
Creating and Closing Positions
Why Create a Position?
Creating a Date-Based Position
Creating an Open Position by Setting the Start Date using the Calendar
Closing a Position by setting the End Date Using the Calendar
Creating an Open Position by Setting the Start Date-using the Chart
Video: How to Create an Open Position
Closing a Position by Setting the End Date Using the Chart
Summary Analytics
Controls for Open Positions
PnL Breakdown
Investments
Grid Bot Positions
Related Articles

Overview

The Position Info widget in Altrady is used to help traders track their profit and loss (PnL) across all trades for the currently selected market (e.g. GATE: PI/USDT) and Trading Account (e.g. Gate.io Paper).

It eliminates the need for manual calculations by automatically displaying key trading metrics, including the break-even price, Average Entry price, realized and unrealized PnL, fees paid, and the number of coins bought and sold. Traders can use this widget to analyze their performance for a specified set of trades, manage positions efficiently, and make informed trading decisions.

For more information about what constitutes a position in Altrady, refer to the table at the beginning of the following article: Position Management and Controls.

How to Activate the Position Info Widget

Step-1: To activate the Position Info widget, open the Trading Terminal of Altrady, click on the Widgets button, and tick the Position Info option.


Step-2: The Position Info widget will appear on the screen in the larger group of widgets toward the bottom of the screen.

Position Info Widget Components

Each of these sections are explained in detail below.

Metadata
Summary analytics
Controls
PnL Breakdown
Investments

Position Types

The following sections outline the contents of the Position Info widget numbered above, for the two main position types:

Smart Positions including Signal Bot Positions (hereafter called Smart Positions).
Date-based Positions, including Spot and Futures positions (hereafter called Date-based Positions.
Grid Bot Positions, include some additional data and are discussed separately below.

Position Metadata and Position Creation

The top section displays the identifying information for the selected position, and in some cases, a Save icon or a 3 dot menu with options related to the position as a whole.

The elements included in this section depend on the position's current status (i.e. no position, open/draft, open/saved, closed), and the position type.

The image below shows the different position types and how they are displayed when selected in the Position Info widget. These are detailed below.



No Positions: when there is no start date, no position type, and no Invested Amount, there are no open or closed positions for this market.

Draft Date-Based Position: if the position is marked as Not Created, with an Invested Amount but no start date and no position type, then it is a draft date-based position. Only date-based positions can exist in draft mode.

This type of position is seen when there are filled orders for the market currently opened in the chart and those orders are not yet included in a position.

By definition, a draft position has not been saved. Until it is saved, the position will not be included in My Positions (or the Dashboard). Some calculations do not occur until the position is saved. Click the Save icon to save a draft position. If there is no Save icon, enter a Start Date for the position and the Save icon should appear.

Saved Date-Based Position: When there is a Start date, a position type, and an invested amount, the Date-based position is no longer a draft, but a Saved position. The position will be displayed in the My Positions (Open) widget as a Spot or Futures position.

Pending Smart Position: when the position type is Smart or Signal Bot and there is no summary analytics data, this indicates that a Smart Order has been placed but no orders have yet been filled. The position is a placeholder and is saved. It can be edited using the controls in the Position Info widget or the Trading widget. This position will also be displayed with nil analytics data, in the My Positions widget, as a Smart Position.

Open Smart Position: when the position selected in the Position Info widget has a type of Smart or Signal Bot and has one or more filled entry orders, there will be summary data (e.g. invested amount) displayed in the Position Info widget. This indicates that there have been filled orders for the Smart Position selected in the Position Info widget. The same Open position can be viewed from the My Positions widget, and it will be displayed as a Smart Position with analytics data.

Closed Position: if an End Date is shown in the Position Info widget, the Position is closed. This applies to all position types. A Closed Position cannot be reopened. However, it can be deleted and a new position can be created (see below). The same Closed position can be viewed from the My Positions (Closed) widget.

Fields Shown in the Position Info Widget

Position: clicking this button will either display a list of Open and Closed positions (if there are any for the currently-selected market). It also allows for the creation of a new position.


3 Dot Menu: the options available in the displayed menu when clicking this menu will vary depending on the status (i.e. Open, Closed) of the position and the type (i.e. Smart, Spot, Futures, Signal, Grid) of the position.


Start Date: this field can be clicked to set a start date via the Position Info widget's calendar, or it can be populated with a Start date using the chart, as described within these sections: Creating an Open Position by Setting the Start Date Using the Calendar, Creating an Open Position by Setting the Start Date Using the Chart


End Date: this field can be clicked to set a start date via the Position Info widget's calendar, or it can be populated with an End date using the chart, as described in the same sections linked above for the Start date setting. Note that, setting an End date will mark the position as closed.


Duration: this section displays a measure of how long the position has been open for, from the set Start date until the set End date. If there is no End date, the duration displayed indicates how long the position has remained opened for, since the Start date.


Creation Flag (i.e. "Not Created", "Open", "Closed"): this denotes the status of the position. Not Created indicates that the position is a draft position, and has not been saved yet (thus it will not be viewable in the My Positions widget). Open indicates that the position only has a Start date and no end date — additionally, it means the position is running and it should be viewable from the My Positions widget. Closed indicates that the position has both a Start date and End date and is no longer running — this position should be shown as Closed in the My Positions widget.


Position Type: this denotes the type of position that is selected in the Position Info widget. Different position types include: Smart, Spot, Futures, Signal or Grid. The options to control different positions will vary from position type to position type.

Creating a New Position

Why Create a Position?

To be able to track orders in Altrady, a position must be created. This also allows for accurate tracking of key trading analytics (explained further below), which are helpful in understanding trading performance on the markets being traded. This can help with risk management and mitigation and provides a clear picture of trading activity within the position's period.

There are several different types of positions, although all positions fall under 2 categories:

Smart Position
Date-Based Position

Smart Positions are automatically created by placing a Smart Order. For more information about Smart Orders, refer to the following article: Smart Orders: Quick Start Guide.

Date-based positions on the other hand, are either created manually via the Position Info widget or are automatically created when there is an existing closed position on a market, and a non-Smart order is filled.

For more information on the different position types and how different positions are created, refer to the following article: Position Management and Controls.

Creating a Date-Based Position

To create a new position, + Create Position has to first be selected in the Position Info widget.


Following this, there are two ways of creating an Open position: using the calendar or using the chart.

Creating an Open Position by Setting the Start Date Using the Calendar

Step-1: After + Create Position has been selected in the Position Info widget as shown here: Creating a New Position — set a Start date/time on the position. This can be done by clicking on Set Start Date beneath Start. Doing so, will display a calendar where the Start date/time can be set.


Step-2: Once the calendar is displayed, the Start date and Start time can be selected accordingly.

Dates where trades have occurred are highlighted in green. Clicking a date on the calendar enters that date with a time of 0:00, and will include all trades on that date.

The Start month and year can be selected here.
The Start day can be selected here.
The Start time can be selected here. Note that a time can be keyed in, or the clock icon can be clicked to select a time using the mouse.


Step-3: Save the position.

Once the position is saved, the start date will be adjusted to the timestamp of the first trade after the entered date. All trades from the start date until the current date are included in an open date-based position.

Check the details in the Summary and Investments sections, to see whether the position matches the correct invested amount and recovered amount. If not, either the start date is incorrect, or an end date should be entered to exclude trades after a specified date (see below for how to enter an End date).

If the Investments section shows Sold amount = Bought amount, then the position will be automatically closed.

The Sold amount will not necessarily be identical to the Bought amount if there is remaining dust (i.e. an amount less than one step size for the market). A position will still be automatically closed if there is only Dust remaining.



The Open position can be viewed from the My Positions widget as well. To learn more about the My Positions widget, refer to the following article: Understanding the "My Position" Widget of Altrady

Closing a Position by setting the End Date Using the Calendar

Step-1: Ensure that the position already has a Start date set.

Step-2: Next, click on Set End Date beneath End. Doing so, will display a calendar where the End date/time can be set.


Step-3: Once the calendar is displayed, the End date and End time can be selected accordingly.

The End month and year can be selected here.
The End day can be selected here.
The End time can be selected here. Note that a time can be keyed in, or the clock icon can be clicked to select a time using the mouse.


Step-4: Once the position has both a Start and End date, the final step would be to save the position in the Position Info widget. The save icon is displayed with a floppy disk icon. Clicking this button will Close an Open position.




For a draft position with both a Start and End date, the status will be Not Created until the save icon is clicked.


Once the save icon is clicked, a Closed position will be created.



The Closed position can be viewed from the My Positions widget as well. To learn more about the My Positions widget, refer to the following article: Understanding the "My Position" Widget of Altrady

Creating an Open Position by Setting the Start Date Using the Chart

A video showing the process for creating an open position via the chart is available here: Video: How to Create an Open Position

Step-1: When creating a new position via the chart, first select + Create Position as shown here: Creating a New Position. Following this, find the first entry trade for the position and position the cursor on the candle to the left of the first trade to be included.


Step-2: Once the cursor is positioned accordingly, right-click on the chart, then select Set Break Even Start to set a Start date on the position.


Step-3: If the position has no exit orders, or if they have not yet filled — the final step would be to save the position in the Position Info widget, after the Start date is set. The save icon is displayed with a floppy disk icon. Clicking this button would create an Open position.



The Open position can be viewed from the My Positions widget as well. To learn more about the My Positions widget, refer to the following article: Understanding the "My Position" Widget of Altrady

Video: How to Create an Open Position

A video showing how the Start date can be set via the chart, to create an Open manual Spot position, is linked below:

Closing a Position by setting the End Date Using the Chart

Step-1: Ensure that the position already has a Start date set. Next, position the cursor on the candle to the right of the last trade to be included.


Step-2: Once the cursor is positioned accordingly, right-click on the chart, then select Set Break Even End to set a End date on the position.


Step-3: Once the position has both a Start and End date, the final step would be to save the position in the Position Info widget. The save icon is displayed with a floppy disk icon. Clicking this button w**i**ll Close an Open position.




For a draft position with both a Start and End date, the status will be Not Created until the save icon is clicked.


Once the save icon is clicked, a Closed position will be created.



The Closed position can be viewed from the My Positions widget as well. To learn more about the My Positions widget, refer to the following article: Understanding the "My Position" Widget of Altrady

Summary Analytics

Invested: this refers to the total amount that has been invested into the position thus far. For a Long position, this will displayed in quote currency. For a Short position, this will be displayed in base currency. Regardless of the position side, the value of the amount will also displayed in its fiat equivalent.

Net PnL: profit and loss, taking into account fees paid, displayed as a numeral.

For positions that are Long is is calculated as such: Net PnL = (Average Exit Price - Average Entry Price) * Position Size - Fees .
For positions that are Short is is calculated as follows: Net PnL = (Average Entry Price − Average Exit Price) * Position Size − Fees.

Net PnL %: profit and loss, taking into account fees paid, expressed as a percentage. This is calculated by dividing the Net PnL result from the above calculation, by the total entry cost ( including fees) and multiplying the result by 100, which results in a percentage value.

Average Entry Price (i.e. AEP): this refers to the average cost at which a position was entered, taking into account all entry orders that have occurred on the position. For a Long position, this is calculated by dividing the total cost of all purchases including fees by the total number of coins bought. For a Short position, this is calculated by dividing the total value of all short entries including fees by the total quantity of coins shorted. Unrealized Profit (i.e. URP) is closely related to this value and is calculated by the difference between the current market price and the AEP — multiplied by the position size. AEP also takes into account the fees paid on the entry orders.

Break Even: this refers to the price at which remaining coins would need to be sold/bought (long/short) for the PnL to be zero (i.e. there is neither a gain nor a loss). This value takes into account the fees already paid, and the fees to be paid on the exit order. Before any exits have filled, the AEP and the BEP are very close in price (the difference being the exit fees are included in the BEP). If some TPs have filled the BEP will move away from the AEP: if the TP resulted in a profit, the Break Even price will decrease/increase (long/short). If the TP resulted in a loss, the BEP will increase/decrease (long/short).

Break Even Price: If the position was closed at this price, PnL would be zero. I.e. there would neither be profit nor loss.

Executed: this refers to the total number of trades that have been executed on the position, thus far. This takes into account all entry and exit trades. Note there can be multiple trades per order, especially for large positions.

Controls for Open Positions

Edit: clicking this button would open the currently selected position for editing, in the Trading widget. By doing so, certain actions can be taken on the position. To learn more about these actions, refer to the following article: Position Management and Controls.

Close Position: clicking this button would display two options for exiting or reducing the currently selected open position: Close Position Market and Close Position Limit. To learn more about these options, refer to the following article: Position Management and Controls.



Mark as Closed: clicking this button would automatically enter the end date on the position, as the date of the last trade that occurred. This would change the position's status to Closed, and would move the position to the Closed section in the My Positions widget.

PnL Breakdown

Realized PnL: this is the profit/loss that has already occurred on the position, based on trades that have already been executed.

Unrealized PnL: this is the floating profit/loss on the position, based on what is currently open on the position. If there are no coins left to sell (Long position) or no coins to be re-bought (Short position) — this value will read 0. This value is directly calculated from the difference between the current market price and the Average Entry Price.

Net PnL: this is the profit/loss that has already occurred on the position, taking into account the amount fees that have already been paid on the trades that have been executed, on the position. This is also shown in the summary analytics.

Fees Paid: this is the total amount of fees that have been paid within the position, combined together, for every trade that has been filled thus far. This value is taken into account, in some of the summary analytics (i.e. Break Even, Average Entry Price).

Investments

This section of the Position Info widget, shows data related to the amount that has been invested into a position. The left column displays the profit currency (i.e. quote currency), while the right column displays the base currency of the selected market (e.g. for the trading pair BTC/USDT; BTC is the base currency).

Spot Long: profits are in quote currency. When trading with a Long position on Spot markets, base currency is first purchased using quote currency. When the base currency is eventually sold, quote currency is gained in return. Thus, profits are in quote currency.



Spot Short: profits are in base currency. When trading with a Short position on Spot markets, base currency needs to be owned (i.e. available in balance) prior to placing a Sell order. Short positions are started by selling base currency first, after which it can be bought again at lower prices to make a profit based on the difference. Quote currency is used to re-buy base currency at lower prices, thus profits upon exiting a Short position will be in base currency.


Futures Long: profits are in quote currency. When trading Futures, only quote currency is used to make order placements and profits are always in quote currency. This is due to the fact that trading Futures involves the purchasing and selling of contracts, rather than the purchasing or selling of actual coins (i.e. base currency).



Futures Short: profits are in quote currency. Profits are in quote currency, due to the same reasons as outlined in #3. Due to these same reasons, users do not need to own base currency prior to starting a Short position, when trading on Futures markets.

Grid Bot Positions

Grid Bot positions cannot be opened, closed or cancelled via the Position info widget. However, details regarding the Grid Bot's positions can be viewed here.

Summary Analytics: the summary analytics shown for a Grid Bot position in the Position info widget are the same values as shown in the Grid Bot overview page, in the Details window. For more information about the details window, refer to the following article and section:

PnL Breakdown: this section provides a detailed summary of the profit and loss (i.e. PnL) performance for the selected Grid Bot position. This section helps evaluate how profitable or unprofitable the Grid Bot was within that period (for Closed Grid Bot positions) or how profitable the Grid Bot currently is (for Open Grid Bot positions).

Investments: this shows the total amounts invested by the Grid Bot, with the left column displaying details for quote currency and the right column displaying details for base currency. The same amounts are re-invested by the Grid Bot.

Clicking "Restart Bot" in the Position Info widget, will redirect to the Overview page of the relevant Grid Bot.

Related Articles

Position Management and Controls
Understanding the "My Position" Widget of Altrady
Smart Orders: Quick Start Guide

If you have further questions, feel free to chat with our customer support service, linked at the bottom of this page.

Updated on: 12/06/2025