Portfolio

Get 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.

get/portfolio/history

Query parameters

cursorstring

Opaque cursor for cursor-based pagination. Omit for first page. For subsequent pages, pass the nextCursor value from the previous response.

limitnumber

Example:20

Number of items per page (1-100).

Response

Paginated history of all user actions

nextCursorstring 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.

totalCountnumber nullable required

Total count of entries (null in cursor mode)

Example response

{
  "data": [
    {
      "blockTimestamp": 1744115608,
      "collateralAmount": "25.5",
      "market": {
        "collateral": {
          "symbol": "USDC",
          "id": 7,
          "decimals": 6
        },
        "group": {
          "id": 10000037,
          "slug": "positionconverted-test-1744046422596",
          "title": "PositionConverted test",
          "status": "FUNDED",
          "deadline": "2025-04-11T22:34:56.000Z",
          "metadata": {
            "isBannered": false
          },
          "negRiskMarketId": "0xe103633b40e9b664f8acc89e8cf7b7916475961ae1708a249fa5d6c933168c00",
          "createdAt": "2025-04-07T17:20:22.135Z",
          "updatedAt": "2025-04-07T17:22:08.464Z"
        },
        "condition_id": "0x08518bc4bb8a3dbb89aac4425ace0876b94a5dfa77dee47a20737a19cf67e325",
        "id": 980,
        "slug": "btc-above-100k-jul-4",
        "title": "$BTC above $100k on Jul 4?",
        "deadline": "2025-07-04T23:59:59.000Z"
      },
      "outcomeTokenAmount": "50",
      "outcomeTokenAmounts": [
        "50",
        "0"
      ],
      "outcomeTokenPrice": 0.51,
      "strategy": "Limit Buy",
      "transactionHash": "0x992f36465f938b21a6a5fe3c417c98c3268a616a05479d2dc53870c6cd1a0761"
    }
  ],
  "nextCursor": "eyJ0Ijoi...",
  "totalCount": 8
}

Changes

Changed in 8 of the 32 revisions of this API.1710

Jun 12, 2026da9b369e16fd2See the full diff
- ○
  the endpoint scheme security HmacAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security ApiKeyAuth was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 9, 20266e8c49700a621See the full diff
- ○
  added the required property to the response with the status
  response-required-property-added
Apr 21, 2026904394cb06e6153See the full diff
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  for the query request parameter limit, the max was set to 100.00
  request-parameter-max-set
- ●
  for the query request parameter limit, the min was set to 1.00
  request-parameter-min-set
- ●
  deleted the query request parameter from
  request-parameter-removed
- ●
  deleted the query request parameter page
  request-parameter-removed
- ●
  deleted the query request parameter to
  request-parameter-removed
- ○
  added the new optional query request parameter cursor
  new-optional-request-parameter
- ○
  the query request parameter limit became optional
  request-parameter-became-optional
- ○
  added the optional property to the response with the status
  response-optional-property-added
Apr 2, 20263a5517817be71See the full diff
- ●
  added the new Claim enum value to the // response property for the response status
  response-property-enum-value-added
Apr 2, 2026a826c41835eb1See the full diff
- ○
  removed the Claim enum value from the // response property for the response status
  response-property-enum-value-removed
Apr 1, 2026013070af066e1See the full diff
- ●
  added the new Claim enum value to the // response property for the response status
  response-property-enum-value-added
This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 26, 20267583da44d16b2See the full diff
- ○
  the endpoint scheme security ApiKeyAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security bearer was removed from the API
  api-security-removed
Mar 9, 202657db5c3f80ff1See the full diff
- ○
  the endpoint scheme security limitless_session was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history