valuation

Retrieve current valuation

Changed on Oct 29, 2026

Retrieve an account's current valuation.

get/accounts/{account_id}/valuation

Request

Base URL
https://api.engine.usesophic.com
Auth
HTTP bearer

Path parameters

account_idstring required

The ID of the account to retrieve the valuation for.

Response

accountstring required

The ID of the account.

asofstring date-time required

The time of the account valuation.

currency'EUR' | 'USD' | 'GBP' required

total_cash_valuestring required

The total value of the account cash balances.

total_position_valuestring required

The total value of the account positions.

total_valuestring required

The total account value.

Example response

{
  "asof": "2026-07-14T09:34:12Z",
  "cash_valuations": [
    {
      "asof": "2026-07-14T09:34:12Z",
      "cash_balance": {
        "available_for_trading": "10000.00",
        "available_for_withdrawal": "9750.00",
        "reserved": "250.00",
        "total": "12500.00"
      },
      "value": "25000.00"
    }
  ],
  "position_valuations": [
    {
      "asof": "2026-07-14T09:34:12Z",
      "position": {
        "automatic_rollover_cutoff": "2025-09-25",
        "available_for_trading": "1000.00",
        "average_price": "98.75",
        "closed_at": "2025-07-15T10:30:00Z",
        "created_at": "2025-01-15T10:30:00Z",
        "instrument": {
          "about": "Common stock listed on the Nasdaq Global Select Market.",
          "asset_class": [
            {
              "weight": "0.48640000"
            }
          ],
          "days_to_maturity": 182,
          "decimal_precision": 2,
          "exchange": "XNAS",
          "icon_url": "https://storage.googleapis.com/sophic-assets/instrument-icons/in_x7GqT.png",
          "initial_auction_date": "2024-12-30",
          "initial_issue_date": "2025-01-02",
          "isin": "US5949181045",
          "issuer": "United States Department of the Treasury",
          "issuer_country": "US",
          "issuer_credit_rating": "AA+",
          "latest_auction_date": "2025-01-27",
          "latest_issue_date": "2025-01-30",
          "maturity_date": "2025-07-03",
          "name": "Apple Inc.",
          "symbol": "US5949181045",
          "ticker": "AAPL",
          "trading_configuration": {
            "buy": {
              "min_cash_amount": "20000.00000000",
              "min_initial_cash_amount": "100000.00000000",
              "min_initial_quantity": "100.00000000",
              "min_quantity": "10.00000000",
              "modes": [
                "cash"
              ]
            },
            "sell": {
              "min_cash_amount": "1000.00000000",
              "min_quantity": "10.00000000",
              "modes": [
                "quantity"
              ]
            }
          },
          "trading_increment": "0.00010000"
        },
        "modified_at": "2025-07-01T14:32:18Z",
        "most_recent_maturity_period": "3m",
        "opened_at": "2025-01-15T10:30:00Z",
        "reserved": "50.00",
        "settled": "1000.00",
        "total": "1250.00",
        "total_buy_trades": 3,
        "unsettled": "250.00",
        "ytm": "4.25"
      },
      "price": "99.25",
      "value": "99250.00"
    }
  ],
  "total_cash_value": "25000.00",
  "total_position_value": "99250.00",
  "total_value": "124250.00"
}

Changes

Oct 29, 20266a63920239d8 Revision changes
- breaking
  the // response's property type changed from no type to object for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to string for status
- breaking
  the // response's property type changed from no type to object for status
- warning
  added the new EUR enum value to the // response property for the response status
- warning
  added the new EUR enum value to the response property for the response status
- warning
  added the new EUR enum value to the // response property for the response status
- warning
  added the new GBP enum value to the // response property for the response status
- warning
  added the new GBP enum value to the response property for the response status
- warning
  added the new GBP enum value to the // response property for the response status
- warning
  added the new USD enum value to the // response property for the response status
- warning
  added the new USD enum value to the response property for the response status
- warning
  added the new USD enum value to the // response property for the response status
- info
  added the optional property /// to the response with the status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  removed from the // response property allOf list for the response status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
- info
  added the required property /// to the response with the status
Oct 6, 2026aa43bab6253c Revision changes
- breaking
  response property context/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 400
- info
  added the required property ////// to the response with the status
- info
  added the required property ////// to the response with the status
- info
  added the required property ////// to the response with the status
- info
  added the required property ////// to the response with the status
- info
  added the required property ////// to the response with the status
- info
  added the required property ////// to the response with the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status
- info
  the response required property ////// became read-only for the status

Operation history (10 revisions)