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

# POST /v1/portfolios/{portfolioSlug}/address-holdings/{address}/token-value-history

`POST /v1/portfolios/{portfolioSlug}/address-holdings/{address}/token-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}/address-holdings/{address}/token-value-history`
- Auth: API key in header `x-api-key`

## Path parameters

- `address` string, required
- `portfolioSlug` string, required

## Request body

- AddressTokenValueHistoryRequestDto
  - `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
  - `tokens` object[], required: Visible token row scopes
    - `chainId` string, required: Chain ID
    - `tokenAddress` string, required: Token contract address

## Response `201`

- AddressTokenValueHistoryResponseDto
  - `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
    - `rowId` string, required: Stable visible address token row identity
    - `walletAddress` string, required: Wallet address
    - `chainId` string, required: Chain ID
    - `tokenAddress` string, required: Token contract address
    - `assetId` string, required: Asset ID
    - `value` string, required: Token value in base currency
    - `amount` string, required: Token quantity
    - `positionCount` integer, required: Number of positions on this day
    - `walletCount` integer, required: Number of wallets 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)