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

# POST /v1/portfolios/{portfolioSlug}/defi-positions/value-history

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

## Path parameters

- `portfolioSlug` string, required

## Query parameters

- `chainId` string, required: Wallet chain ID
- `walletAddress` string, required: Wallet address
- `positionKey` string, required: Position key

## Request body

- DefiPositionValueHistoryRequestDto
  - `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

## Response `201`

- DefiPositionValueHistoryResponseDto
  - `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
    - `value` string, required: Position value in base currency
    - `hasPartialValuation` boolean, required: Whether this day has missing position valuation legs
    - `valuedLegs` integer, required: Number of valued position legs on this day
    - `totalLegs` integer, required: Number of valuation-relevant position legs 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)