---
title: "List portfolio history"
method: GET
path: "/portfolio/{address}/history"
tags: ["Portfolio"]
---

# List portfolio history

`GET /portfolio/{address}/history`

## Request

- Base URL: `https://app.elata.bio/api`
- URL: `https://app.elata.bio/api/portfolio/{address}/history`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/elata-biosciences/apis/elata-app-store-api/docs/portfolio/:address/history/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `address` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Trade and transfer history.

- object
  - `events` PortfolioEvent[]
    - `kind` 'buy' | 'sell' | 'transferIn' | 'transferOut' | 'claim' | 'lock' | 'unlock'
    - `tokenAddress` string, nullable
    - `amount` string
    - `valueUsdAtTime` number, nullable
    - `txHash` string
    - `timestamp` string, date-time
  - `nextCursor` string, nullable

## Other responses

- `401`: Missing or invalid SIWE bearer token.

---

[API](https://skmtc.dev/elata-biosciences/apis/elata-app-store-api.md) - [All operations](https://skmtc.dev/elata-biosciences/apis/elata-app-store-api/llms.txt) - [OpenAPI document](https://skmtc.dev/elata-biosciences/apis/elata-app-store-api/revisions/55c111b65fc5?raw)