Account valuations
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.
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.
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-09T00:00: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-09T00:00: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 a webhook 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-09T00:00: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-09T00:00: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-10T00:00: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": []
}
]
}