The account valuation is a total value of all securities on a specific account.
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.
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.
To get the current account valuation, perform the following operation:
GET /accounts/{account_id}/valuations/current
Example response current valuations
{
"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"
}
]
}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 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
Example response historical valuations
{
"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": []
}
]
}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_timereflects 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_timeshould 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.