---
title: "POST /v1/portfolios/{portfolioSlug}/assets/value-history"
method: POST
path: "/v1/portfolios/{portfolioSlug}/assets/value-history"
tags: ["Portfolios"]
---

# POST /v1/portfolios/{portfolioSlug}/assets/value-history

`POST /v1/portfolios/{portfolioSlug}/assets/value-history`

## Request

- Base URL: `https://api.tokenbooks.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tokenbooks.io/v1/portfolios/{portfolioSlug}/assets/value-history`
- Auth: API key in header `x-api-key`

## Path parameters

- `portfolioSlug` string, required

## Request body

- PortfolioAssetValueHistoryRequestDto
  - `startDate` union, required: Inclusive UTC start timestamp
    - string, date-time
    - string
  - `endDate` union, required: Inclusive UTC end timestamp
    - string, date-time
    - string
  - `includeSpam` boolean: Whether spam tokens should be included
  - `assetIds` string[], required: Asset IDs

## Response `201`

- PortfolioAssetValueHistoryResponseDto
  - `cachedThrough` string, date, nullable, required: UTC day in YYYY-MM-DD format
  - `refreshedAt` string, date-time, nullable, required: Refresh timestamp in ISO 8601 format
  - `isStale` boolean, required: Whether a background refresh was started
  - `refreshJobId` string, nullable, required: Refresh job ID
  - `refreshQueueName` string, nullable, required: Refresh job consumer name for status polling
  - `data` object[], required
    - `day` string, date, required: UTC day in YYYY-MM-DD format
    - `assetId` string, required: Asset ID
    - `value` string, required: Asset value in base currency
    - `amount` string, required: Asset quantity
    - `walletCount` integer, required: Number of wallets on this day
    - `positionCount` integer, required: Number of positions on this day

---

[API](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api.md) · [All operations](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenbooks/apis/tokenbooks-public-api/revisions/180622e6255e?raw)