Sign in
valuation

Retrieve position valuation

Retrieve a position's current valuation.

get/positions/{position_id}/valuation

Path parameters

position_idstring required

The ID of the position to retrieve the valuation for.

The ID of the position to retrieve the valuation for.

Query parameters

asofstring date-time

Compute the valuation as-of this datetime (ISO 8601). Defaults to now.

Compute the valuation as-of this datetime (ISO 8601). Defaults to now.

Response

OK

asofstring date-time required

The time of the position valuation.

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

The price used to value the position.

valuestring required

The position value.

Example response

{
  "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.",
      "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",
      "minimum_initial_cash_investment": "1000.00",
      "minimum_trading_quantity": "1.00",
      "name": "Apple Inc.",
      "required_cash_increment": 100,
      "symbol": "US5949181045",
      "ticker": "AAPL",
      "trading_increment": "0.01"
    },
    "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"
}

Changes

Changed in 6 of the 11 revisions of this API.22120

  • 0def92bc65f53See the full diff
    • ○

      added Bill CurrencyPair Bond MoneyMarketFund AMC ETF to the position/allOf[subschema #1: Position]/instrument response property anyOf list for the response status 200

      response-property-any-of-added

    • ○

      removed discriminator from position/allOf[subschema #1: Position]/instrument response property for the response status 200

      response-property-discriminator-removed

    • ○

      removed Bill CurrencyPair Bond MoneyMarketFund AMC ETF from the position/allOf[subschema #1: Position]/instrument response property oneOf list for the response status 200

      response-property-one-of-removed

  • 2b28ad4528811See the full diff
    • ▲

      removed the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #1: Bill]/par_value from the response with the 200 status

      response-required-property-removed

  • 250f4b477cbf5See the full diff
    • ○

      added the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/currency_sentence to the response with the 200 status

      response-required-property-added

    • ○

      added the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/display_name to the response with the 200 status

      response-required-property-added

    • ○

      added the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/fund_base_currency to the response with the 200 status

      response-required-property-added

    • ○

      added the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/headline to the response with the 200 status

      response-required-property-added

    • ○

      added the required property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/rhp_years to the response with the 200 status

      response-required-property-added

  • b95b7ffdc1eb6See the full diff
    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #1: Bill]/icon_url to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #2: CurrencyPair]/icon_url to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #3: Bond]/icon_url to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #4: MoneyMarketFund]/icon_url to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #5: AMC]/icon_url to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property position/allOf[subschema #1: Position]/instrument/oneOf[subschema #6: ETF]/icon_url to the response with the 200 status

      response-optional-property-added

  • 8e8a8242f1f22115See the full diff
    • ▲

      the currency response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • ▲

      the position response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ▲

      removed the required property position/account from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/automatic_rollover from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/available_for_trading from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/average_price from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/can_update_automatic_rollover from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/closed_at from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/created_at from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/id from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/instrument from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/modified_at from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/most_recent_maturity_period from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/opened_at from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/reserved from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/settled from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/status from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/total from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/total_buy_trades from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/unsettled from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property position/ytm from the response with the 200 status

      response-required-property-removed

    • ●

      removed the optional property position/automatic_rollover_cutoff from the response with the 200 status

      response-optional-property-removed

    • ○

      added Currency to the currency response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      added Position to the position response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      removed the EUR enum value from the currency response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the GBP enum value from the currency response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the USD enum value from the currency response property for the response status 200

      response-property-enum-value-removed

  • 03da9bc8e86b1See the full diff
    • ○

      api tag valuation added

      api-tag-added

    This revision also has 53 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog