---
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.
  - `totalCount` number, nullable, required — Total count of entries (`null` in cursor mode)

## Other responses

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

---

[API](https://skmtc.net/limitless/apis/limitless-exchange-api.md) · [All operations](https://skmtc.net/limitless/apis/limitless-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limitless/limitless-exchange-api/versions/43f7d65e8e15/schema)