> For the complete documentation index, see [llms.txt](https://3commas.gitbook.io/3commas-official-api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://3commas.gitbook.io/3commas-official-api-docs/smarttrade/trades/get-trades-of-smarttrade.md).

# Get trades of SmartTrade

**Description:** Shows trades of existing SmartTrade<br>

**Permission:** SMART\_TRADES\_READ\
**Security:** SIGNED\ <br>

***

<mark style="color:blue;">**GET**</mark>

<mark style="color:blue;">**/v2/smart\_trades/{smart\_trade\_id}/trades**</mark>

***

\ <br>

## Path Parameters<br>

| Name                | Type      | Mandatory | Values | Description                                  |
| ------------------- | --------- | --------- | ------ | -------------------------------------------- |
| **smart-trade\_id** | `integer` | Yes       |        | Unique 3Commas ID for this SmartTrade entity |

\ <br>

## Response Parameters<br>

| Name                                   | Type                 | Description                                                                                         |
| -------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------- |
| **id**                                 | `integer`            | Unique 3Commas Trade entity ID                                                                      |
| **average\_price**                     | `null` or `string`   | The weighted average price at which the asset was bought or sold during the execution of the trades |
| **follow\_price\_type**                | `string`             | The type of price to follow for this trade (f.e. `bid`, `ask`, or `last`)                           |
| **initial\_amount**                    | `string`             | The initial amount for this trade                                                                   |
| **initial\_total**                     | `string`             | The initial total for this trade                                                                    |
| **initial\_price**                     | `number`             | The initial price for this trade                                                                    |
| **order\_price**                       | `null` or `string`   | The limit price for this trade                                                                      |
| **order\_side**                        | `string`             | The side of the order to be created by this trade                                                   |
| **order\_type**                        | `string`             | The type of trade used to open the position (e.g., `market`, `limit`, `conditional`)                |
| **pair**                               | `string`             | Trading pair in 3Commas format for this trade                                                       |
| **position\_percentage**               | `null` or `string`   | Доля в процентах шага по TP. заполняется поле только в случае "trade\_purpose": "take\_profit"      |
| **realised\_amount**                   | `string` or `null`   | Indicates the realized amount from the trade                                                        |
| **realised\_total**                    | `string` or `null`   | Indicates the total realized amount from the trade                                                  |
| **realised\_percentage**               | `number`             | Indicates the realized percentage of the total trade amount                                         |
| **realised\_price**                    | `number` or `null`   | Indicates the realized price of the trade                                                           |
| **status**                             | `string`             | 3Commas status for this Trade                                                                       |
| **take\_profit\_percentage**           | `string` or `null`   | The percentage price level for Take Profit for this Trade                                           |
| **trade\_purpose**                     | `string`             | <p>The type of trade.<br></p><p><br></p>                                                            |
| **trail\_percentage**                  | `string` or `null`   | Indicates the percentage deviation from the price for this trade                                    |
| **trail\_value**                       | `string` or `null`   | Indicates the deviation from the price for this trade (сами высчитываем) по этому трейду            |
| **trailing\_enabled**                  | `boolean`            | Indicates whether the trailing settings for this trade can be edited                                |
| **trailing\_last\_price**              | `string` or `null`   | Indicates the last price used for trailing                                                          |
| **trailing\_last\_price\_updated\_at** | `number` or `null`   | Indicates the timestamp of the last update to the trailing price                                    |
| **trigger\_condition**                 | `number` or `null`   | <p>Indicates the condition under which the trigger is activated<br></p>                             |
| <p><br></p>                            |                      |                                                                                                     |
| **trigger\_price**                     | `string` or `null`   | Indicates the price at which the trigger is activated                                               |
| **trigger\_price\_percentage**         | `string` or `null`   | Indicates the percentage for the trigger price                                                      |
| **trigger\_type**                      | `string`             | Indicates the type of trigger for the trade                                                         |
| **created\_at**                        | `string <date-time>` | ISO 8601 datetime string of when this Trade entity was created                                      |
| **updated\_at**                        | `string <date-time>` | ISO 8601 datetime string of when this Trade entity was updated                                      |
| **cancelable**                         | `boolean`            | Indicates whether this trade can be canceled                                                        |
| **force\_processable**                 | `boolean`            | Indicates whether this Trade can be close by market                                                 |

\ <br>

## Example Request<br>

```json
GET /v2/smart_trades/30848974/trades
```

## Example Response and errors

<details>

<summary>Status: 200 OK</summary>

<br>

```json
[
    {
        "id": 1006258046,
        "average_price": "0.107068273092369477911646586345381526",
        "follow_price_type": "ask",
        "initial_amount": "15.0",
        "initial_total": "1.5996",
        "order_price": "0.10664",
        "order_side": "buy",
        "order_type": "limit",
        "pair": "USDT_DOGE",
        "position_percentage": null,
        "realised_amount": "14.94",
        "realised_total": "1.5996",
        "status": "finished",
        "take_profit_percentage": null,
        "trade_purpose": "position",
        "trail_percentage": null,
        "trail_value": null,
        "trailing_enabled": false,
        "trailing_last_price": null,
        "trailing_last_price_updated_at": null,
        "trigger_condition": null,
        "trigger_price": null,
        "trigger_price_percentage": null,
        "trigger_type": "none",
        "created_at": "2024-08-12T16:24:38.384Z",
        "updated_at": "2024-08-12T16:56:10.437Z",
        "realised_percentage": "100.0",
        "initial_price": "0.10664",
        "realised_price": "0.10706",
        "cancelable": false,
        "force_processable": false
    },
    { ...
    },
    {
        "id": 1006258056,
        "average_price": null,
        "follow_price_type": "last",
        "initial_amount": "14.0",
        "initial_total": "1.4182",
        "order_price": null,
        "order_side": "sell",
        "order_type": "market",
        "pair": "USDT_DOGE",
        "position_percentage": "100.0",
        "realised_amount": "0.0",
        "realised_total": null,
        "status": "to_process",
        "take_profit_percentage": null,
        "trade_purpose": "stop_loss",
        "trail_percentage": null,
        "trail_value": null,
        "trailing_enabled": false,
        "trailing_last_price": null,
        "trailing_last_price_updated_at": null,
        "trigger_condition": "less_or_equal",
        "trigger_price": "0.1013",
        "trigger_price_percentage": null,
        "trigger_type": "conditional",
        "created_at": "2024-08-12T16:24:38.461Z",
        "updated_at": "2024-08-12T16:56:10.850Z",
        "realised_percentage": "0.0",
        "initial_price": "0.1013",
        "realised_price": null,
        "cancelable": true,
        "force_processable": true
    }
]
```

</details>

<details>

<summary>Status: 404 Not Found</summary>

<br>

```json
{
    "error": "Not found",
    "error_description": "Smart Trade not found"
}
```

</details>
