> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yieldpoint.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get portfolio history

> Per-event token balance history for a wallet, keyed by chain ID then token.

Returns every balance change for the wallet, keyed by chain ID, then by token key. Each token holds an array of `{ date, timestamp, balance }` snapshots, one per on-chain event that changed the balance, with `timestamp` in Unix seconds and `balance` as a formatted decimal.

A chain appears only when the wallet has balance history on it, and each chain that appears carries all seven token keys, with empty arrays for tokens never held there. A wallet with no history returns `{}`. Balances in the wallet's Euler sub-accounts are attributed to the wallet. See [Portfolio data](/api-reference/address/portfolio) for the token keys and the attribution rule.

For end-of-day balances with dollar values, use [Get daily portfolio](/api-reference/address/get-portfolio-daily) instead.

```bash theme={"dark"}
curl https://api.yieldpoint.io/v1/address/0x1111111111111111111111111111111111111111/portfolio
```

A wallet with yUTY history on Avalanche and nothing elsewhere returns:

```json theme={"dark"}
{
  "43114": {
    "uty": [],
    "yuty": [
      { "date": "2026-04-03", "timestamp": 1775239784, "balance": 10 },
      { "date": "2026-04-03", "timestamp": 1775242040, "balance": 454956.49 }
    ],
    "pendleSy": [],
    "eulerYuty": [],
    "eulerUsdc": [],
    "pendleYt": [],
    "pendleLp": []
  }
}
```


## OpenAPI

````yaml https://api.yieldpoint.io/docs/json GET /v1/address/{address}/portfolio
openapi: 3.0.0
info:
  title: YieldPoint API
  description: ''
  version: 1.1.0
  contact: {}
servers:
  - url: https://api.yieldpoint.io
security: []
tags: []
paths:
  /v1/address/{address}/portfolio:
    get:
      tags:
        - Address
      summary: Returns per-event token balance history for a given address.
      operationId: getPortfolioHistory
      parameters:
        - name: address
          required: true
          in: path
          description: The wallet address
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PortfolioResponseDto'
components:
  schemas:
    PortfolioResponseDto:
      type: object
      additionalProperties:
        type: object
        properties:
          uty:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          yuty:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          pendleSy:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          eulerYuty:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          eulerUsdc:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          pendleYt:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
          pendleLp:
            type: array
            items:
              type: object
              properties:
                date:
                  type: string
                  description: Date in format YYYY-MM-DD
                timestamp:
                  type: number
                  description: Unix timestamp in seconds
                balance:
                  type: number
                  description: Token balance (formatted decimal)
              required:
                - date
                - timestamp
                - balance
        required:
          - uty
          - yuty
          - pendleSy
          - eulerYuty
          - eulerUsdc
          - pendleYt
          - pendleLp

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.