Valuation Events (Beta)

Valuation events can be used to bulk-create valuations for all owners of a given security.

The application will calculate the most recent adjusted value for each position and then generate new valuations after applying the estimated return.

Note: The "Enable knowledge date" calculation setting must be enabled to use this functionality.


Base route	/v1/valuation_events
Endpoints	POST /v1/valuation_events
Produces	JSON
Pagination	No
Application permissions required	"Create, edit, and delete offline transactions" "Edit and delete all online transactions" is required to create valuations for online assets
OAuth scopes	POST `TRANSACTIONS_WRITE`

Resource attributes

Attribute	Description
`event_name`	String -- Name of the event to be created.
`investment_id`	Number -- Entity ID of the investment. The investment must be value-based.
`trade_date`	Date -- Date of the event. Generated valuations will use this trade date.
`knowledge_date`	Date -- Knowledge date of the event. Generated valuations will use this knowledge date.
`estimated_return`	Number -- Estimated return as a decimal value, such as `0.05` for 5%.

Optional attributes

Attribute	Description
`is_estimate`	Boolean -- Whether generated valuations should be marked as estimates. Defaults to `true` when omitted.

Create a valuation event

POST /v1/valuation_events

Example:

curl -X POST "https://{firm}.addepar.com/api/v1/valuation_events" \
  -H "Accept: application/vnd.api+json" \
  -H "Content-Type: application/vnd.api+json" \
  -H "Authorization: Basic {credentials}" \
  -H "Addepar-Firm: 1" \
  -d '{
  "data": {
    "type": "valuation_events",
    "attributes": {
      "event_name": "test",
      "investment_id": 123,
      "trade_date": "2026-09-01",
      "knowledge_date": "2026-09-01",
      "estimated_return": 0.05,
      "is_estimate": true
    }
  }
}'

{
  "data": {
    "id": "2",
    "type": "valuation_events",
    "attributes": {
      "estimated_return": 0.05,
      "knowledge_date": "2026-09-01",
      "investment_id": "123",
      "valuations": [
        {
          "entity_id": 25,
          "entity_name": "Holding Account 1",
          "baseline_trade_date": "2012-07-01",
          "starting_value": {
            "value": 100000.0,
            "currency": "USD"
          },
          "cashflow_adj": 0.0,
          "resulting_value": {
            "value": 105000.0,
            "currency": "USD"
          },
          "status": "created"
        }
      ],
      "event_name": "test",
      "created_at": "2026-09-10",
      "modified_at": "2026-09-10T21:21:15Z",
      "trade_date": "2026-09-01",
      "is_estimate": true
    },
    "links": {
      "self": "/v1/valuation_events/2"
    }
  },
  "included": []
}

Response Codes:

400 Bad Request: Missing required attributes, investment_id is not a numeric string, investment_id does not refer to a value-based asset, estimated_return is not finite, or no eligible valuations can be generated.
403 Forbidden: Lacking the required permissions to create valuation events, the required OAuth scope, or the feature is disabled for the firm.
404 Not Found: The investment identified by investment_id does not exist.