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.

INFO

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.

INFO

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": []
   }
 ]
}

Was this page helpful?