---
title: "Get History"
method: GET
path: "/portfolio/history"
tags: ["Portfolio"]
---

# Get History

`GET /portfolio/history`

Paginated history including AMM, CLOB trades, splits/merges, NegRisk conversions. Partner API tokens with `delegated_signing` scope may read a sub-account by sending the `x-on-behalf-of: <profileId>` header.

## Query parameters

- `cursor` string
- `limit` number

## Response `200`

Paginated history of all user actions

- HistoryResponseDto
  - `data` HistoryEntryDto[], required — List of history entries
    - `blockTimestamp` number, required — Block timestamp of the operation (unix seconds)
    - `collateralAmount` string, required — Collateral amount involved (human-readable, after dividing by token decimals)
    - `market` HistoryMarketDto, required
      - `closed` boolean, required — Whether the market is closed
      - `collateral` object, required — Collateral token information
      - `group` HistoryMarketGroupDto, required
        - `id` number, required — Unique identifier of the group
        - `slug` string, required — Slug identifier of the group
        - `title` string, required — Title of the group
        - `status` string, required — Status of the group
        - `deadline` string, required — Deadline for the group
        - `hidden` boolean, required — Whether the group is hidden
        - `txHash` string — Transaction hash for the group
        - `resolutionTxHash` string — Resolution transaction hash
        - `priorityIndex` number, required — Priority index of the group
        - `metadata` object, required — Group metadata
        - `negRiskMarketId` string, required — Onchain NegRisk market ID as identified by the NegriskAdapter smart-contract
        - `createdAt` string, required — Creation timestamp
        - `updatedAt` string, required — Last update timestamp
      - `condition_id` string, required — Condition ID of the market
      - `funding` number, required — Market funding amount
      - `id` number, required — Market ID
      - `slug` string, required — Market slug
      - `title` string, required — Market title
      - `deadline` string, required — Market deadline
    - `outcomeTokenAmount` string, required — Amount of outcome tokens involved (human-readable)
    - `outcomeTokenAmounts` string[], required — Amounts of outcome tokens for each outcome [YES, NO]
    - `outcomeIndex` number, required — Index of the outcome (0 = YES, 1 = NO)
    - `outcomeTokenPrice` number, required — Effective price per outcome token for this fill
    - `strategy` 'Buy' | 'Sell' | 'Limit Buy' | 'Limit Sell' | 'Market Buy' | 'Market Sell' | 'Split' | 'Merge' | 'Convert' | 'Claim', required — Type of operation. `Buy`/`Sell` = AMM trades, `Limit Buy`/`Limit Sell` = CLOB maker fills, `Market Buy`/`Market Sell` = CLOB taker fills, `Split`/`Merge` = position split/merge, `Convert` = NegRisk conversion, `Claim` = winnings redemption.
    - `transactionHash` string — On-chain transaction hash (present for settled trades, splits, merges, conversions, and claims)
  - `nextCursor` string, nullable — Opaque cursor for the next page. `null` when there are no more pages. Pass this value back as the `cursor` query parameter to fetch the next page.

## Other responses

- `400` — Invalid pagination parameters
- `401` — Unauthorized

## Changes

- **2026-04-21** `904394cb06e6` — 1 breaking, 5 warning, 3 info
  - removed the required property `totalCount` from the response with the `200` status
  - for the `query` request parameter `limit`, the max was set to `100.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - deleted the `query` request parameter `from`
  - …5 more
- **2026-04-02** `3a5517817be7` — 1 warning
  - added the new `Claim` enum value to the `data/items/strategy` response property for the response status `200`
- **2026-04-02** `a826c41835eb` — 1 info
  - removed the `Claim` enum value from the `data/items/strategy` response property for the response status `200`
- **2026-04-01** `013070af066e` — 1 warning
  - added the new `Claim` enum value to the `data/items/strategy` response property for the response status `200`
- **2026-03-26** `7583da44d16b` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `bearer` was removed from the API

[Full history](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/changes/portfolio/history/get.md)

---

[API](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api.md) · [All operations](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc.dev/limitless-labs-group/apis/limitless-exchange-api/revisions/20e1fd747a5c?raw)