v32

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-076085232.1 KB

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
}