# Account valuations

The account valuation is a total value of all securities on a specific [account](/products/byol/guides/accounts/accounts_create_accounts).

Account valuations can be used to

- display the current status of an account in the user interface;
- display the structure of the portfolio and carry out analysis based on this;
- display a history of account performance over time.


Upvest provides information on current and historical end of day (EOD) account valuations.

## Current account valuation

The current account valuation is based on the current positions and yesterday's EOD prices.

We offer account valuations with real-time prices to clients who have a contract with *Infront*, our [data provider](https://www.infront.co/gb/en/solutions/modules/data-feeds.html).

To get the current account valuation, perform the following operation:

**GET** [`/accounts/{account_id}/valuations/current`](/api/valuations/get_account_valuation)

**Example response current valuations**

```json
{
  "id": "404b170a-9042-11ed-9a51-2eabd0c03f8a",
  "created_at": "2023-01-10T14:15:22Z",
  "updated_at": "2023-01-10T14:15:22Z",
  "valuation_time": "2023-01-10T14:15:22Z",
  "account_id": "51cdc0cc-9042-11ed-b017-2eabd0c03f8a",
  "price_quality": "EOD",
  "total_security_value": {
    "amount": "142.29",
    "currency": "EUR"
  },
  "security_positions": [
    {
      "instrument": {
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "isin": "DE0007664005"
      },
      "value": {
        "amount": "104.81",
        "currency": "EUR",
        "price_time": "2023-01-09T09:20:00Z"
      },
      "quantity": "0.65",
      "weight": "0.736595",
      "price_quality": "EOD"
    },
    {
      "instrument": {
        "uuid": "48b798b7-3a62-4f30-8307-ee94d35b21b7",
        "isin": "FR0010524777"
      },
      "value": {
        "amount": "37.48",
        "currency": "EUR",
        "price_time": "2023-01-09T09:20:00Z"
      },
      "quantity": "1.00",
      "weight": "0.263405",
      "price_quality": "EOD"
    },
    {
      "instrument": {
        "uuid": "7499ccf8-6fa5-43ef-af9e-dd062e10ab59",
        "isin": "SE0019889775"
      },
      "quantity": "5.00",
      "value": null,
      "weight": null,
      "price_quality": "NA"
    }
  ]
}
```

## Historical account valuations

Every day at the end of trading hours, we calculate account valuations based on EOD prices and positions.
You can subscribe to the [`ACCOUNT_VALUATION.CREATED` webhook event](/products/byol/guides/positions/positions_webhooks) to receive valuations for your accounts after they have been calculated, or call an endpoint for historical account valuation if required.

As this endpoint is based on EOD data, the most recent data point it returns is that of t-1.

To list historical account valuations, call

**GET** [`/accounts/{account_id}/valuations`](/api/valuations/list_account_valuation_history)

**Example response historical valuations**

```json
{
  "meta": {
    "offset": 0,
    "limit": 100,
    "count": 3,
    "total_count": 3,
    "sort": "created_at",
    "order": "ASC"
  },
  "data": [
    {
      "id": "404b170a-9042-11ed-9a51-2eabd0c03f8a",
      "created_at": "2023-01-10T14:15:22Z",
      "updated_at": "2023-01-10T14:15:22Z",
      "valuation_time": "2023-01-10T14:15:22Z",
      "account_id": "51cdc0cc-9042-11ed-b017-2eabd0c03f8a",
      "price_quality": "EOD",
      "total_security_value": {
        "amount": "142.29",
        "currency": "EUR"
      },
      "security_positions": [
        {
          "instrument": {
            "uuid": "123e4567-e89b-12d3-a456-426614174000",
            "isin": "DE0007664005"
          },
          "value": {
            "amount": "104.81",
            "currency": "EUR",
            "price_time": "2023-01-09T09:20:00Z"
          },
          "quantity": "0.65",
          "weight": "0.736595"
        },
        {
          "instrument": {
            "uuid": "48b798b7-3a62-4f30-8307-ee94d35b21b7",
            "isin": "FR0010524777"
          },
          "value": {
            "amount": "37.48",
            "currency": "EUR",
            "price_time": "2023-01-09T09:20:00Z"
          },
          "quantity": "1.00",
          "weight": "0.263405"
        },
        {
          "instrument": {
            "uuid": "7499ccf8-6fa5-43ef-af9e-dd062e10ab59",
            "isin": "SE0019889775"
          },
          "quantity": "5.00",
          "value": null,
          "weight": null
        }
      ]
    },
    {
      "id": "adfbf024-3d31-11ef-b99b-2eabd0c03f8a",
      "created_at": "2023-01-11T14:15:22Z",
      "updated_at": "2023-01-11T14:15:22Z",
      "valuation_time": "2023-01-11T14:15:22Z",
      "account_id": "51cdc0cc-9042-11ed-b017-2eabd0c03f8a",
      "price_quality": "EOD",
      "total_security_value": {
        "amount": "104.81",
        "currency": "EUR"
      },
      "security_positions": [
        {
          "instrument": {
            "uuid": "123e4567-e89b-12d3-a456-426614174000",
            "isin": "DE0007664005"
          },
          "value": {
            "amount": "104.81",
            "currency": "EUR",
            "price_time": "2023-01-10T09:20:00Z"
          },
          "quantity": "0.65",
          "weight": "1"
        }
      ]
    },
    {
      "id": "be38000e-3d31-11ef-ac4e-2eabd0c03f8a",
      "created_at": "2023-01-12T14:15:22Z",
      "updated_at": "2023-01-12T14:15:22Z",
      "valuation_time": "2023-01-12T14:15:22Z",
      "account_id": "51cdc0cc-9042-11ed-b017-2eabd0c03f8a",
      "price_quality": "EOD",
      "total_security_value": {
        "amount": "0",
        "currency": "EUR"
      },
      "security_positions": []
    }
  ]
}
```

### Timestamps for end-of-day prices

Valuation responses include a `price_time` field in ISO 8601 timestamp format. Depending on the instrument, this value may reflect a regular timestamp (for example, `"price_time": "2025-09-19T19:59:05Z"`) or an end-of-day marker at midnight UTC (for example, `"price_time": "2025-09-24T00:00:00Z"`).

- For **real-time** prices, `price_time` reflects the exact time the price was recorded, for example `"2025-09-19T19:59:05Z"`.
- For **end-of-day (EOD)** prices, the time component of `price_time` should be ignored. Some instruments provide an EOD marker at midnight UTC, for example `"2025-09-24T00:00:00Z"`.


When the corresponding `price_quality` is `EOD`, use only the date portion of `price_time`. For example, a value of `"2025-09-24T00:00:00Z"` represents the EOD price for **2025-09-24**, not 2025-09-23. The date portion of `price_time` is always the date the EOD price applies to; the time portion carries no meaning for EOD prices and can be disregarded.