> For the complete documentation index, see [llms.txt](https://trader-docs.b2trader.b2broker.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trader-docs.b2trader.b2broker.com/widgets/order-history.md).

# Order history

## Summary

This widget provides up-to-date information about the orders executed on a selected market partially or in full, as well as the orders that were canceled, rejected, and expired.

The data is available for the last 92 days.

<figure><img src="/files/hCtudQ2sGJgDaYUnkRUu" alt="Order history"><figcaption><p>Order history</p></figcaption></figure>

{% hint style="info" %}
The widget lists only the orders to which final statuses are assigned. For a list of orders that are still being executed, use the [Open orders](/widgets/open-orders.md) widget.
{% endhint %}

## Settings

### Adjust the time period

By default, the widget lists the orders with the *Completed* status for the last 90 days. To display orders for a specific time period, use the **Select date range** field. To display orders with specific statuses, select one or more from the dropdown above the list. The most recent order appears at the top of the list.

### Configure columns

Click the **Configure columns** button in the widget header to adjust the displayed information:

* **Mark or unmark column checkboxes**: To display or hide them; the column checkboxes highlighted in grey can’t be unmarked.
* **Drag and drop the columns**: To adjust their order in the table.

## Fields

The following information is provided about each order:

**Market**

The market type (Spot, CFD, or Perpetual) and market ticker.

***

**Full name**

The market full name or description.

***

**Side**

The order side: Buy or Sell.

***

**Order type**

The [order type](/knowledge-base/order-types.md).

***

**Time in force**

The [Time in force](/knowledge-base/time-in-force.md).

***

**Amount**

The order amount, in the base currency.

***

**Filled**

The order amount that has been filled.

***

**Fee**

The total commissions paid for executing an order and the currency in which the commission was paid.

***

**Remaining**

The order amount that wasn't filled.

***

**Avg execution price**

The order execution price, as an average price of all trades executed while filling the order.

***

**Used leverage**

For CFD trading, the leverage ratio used when placing an order.

***

**Status**

The current order [status](/knowledge-base/order-statuses.md): *Completed*, *Cancelled*, *Rejected*, or *Expired*.

***

**Created at**

The date and time when an order was placed.

***

**Updated at**

The date and time of the latest update to the order.

***

**Order ID**

The system identifier of an order.

***

**Comment**

The text note attached to the order when it was placed. Up to 100 characters. The comment can't be edited after the order is placed.

***

**Reason**

The reason for placing the order:

* **Trader**: The order was placed by you.
* **Stop-out**: The order was placed by the system, to close positions as a result of Stop out.
* **Stop loss**: The order was placed by the [Stop loss](/knowledge-base/price-triggers.md) trigger.
* **Take profit**: The order was placed by the [Take profit](/knowledge-base/price-triggers.md) trigger.
* **Webhook alert**: The order was placed via a [TradingView webhook](https://github.com/b2broker-gitbook/gitbook-bbp/blob/master/b2trader/get-started/tradingview-webhooks.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://trader-docs.b2trader.b2broker.com/widgets/order-history.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
