Skip to main content
GET
/
portfolio
/
history
Get History
curl --request GET \
  --url https://api.limitless.exchange/portfolio/history \
  --header 'lmts-api-key: <api-key>'
{
  "data": [
    {
      "blockTimestamp": 1744115608,
      "collateralAmount": "25.5",
      "market": {
        "closed": false,
        "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",
          "hidden": false,
          "priorityIndex": 0,
          "metadata": {
            "isBannered": false
          },
          "negRiskMarketId": "0xe103633b40e9b664f8acc89e8cf7b7916475961ae1708a249fa5d6c933168c00",
          "createdAt": "2025-04-07T17:20:22.135Z",
          "updatedAt": "2025-04-07T17:22:08.464Z",
          "txHash": null,
          "resolutionTxHash": null
        },
        "condition_id": "0x08518bc4bb8a3dbb89aac4425ace0876b94a5dfa77dee47a20737a19cf67e325",
        "funding": 0,
        "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"
      ],
      "outcomeIndex": 0,
      "outcomeTokenPrice": 0.51,
      "strategy": "Limit Buy",
      "transactionHash": "0x992f36465f938b21a6a5fe3c417c98c3268a616a05479d2dc53870c6cd1a0761"
    }
  ],
  "totalCount": 8,
  "nextCursor": "eyJ0Ijoi..."
}

Authorizations

​
lmts-api-key
string
header
required

Scoped API token with HMAC-SHA256 signing. Requires three headers: lmts-api-key (token ID), lmts-timestamp (ISO-8601), lmts-signature (Base64-encoded HMAC). See Authentication docs for details.

Query Parameters

​
cursor
string

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

​
limit
number
default:20

Number of items per page (1-100).

Required range: 1 <= x <= 100
Example:

20

Response

Paginated history of all user actions

​
data
object[]
required

List of history entries

​
totalCount
number | null
required

Total count of entries (null in cursor mode)

Example:

8

​
nextCursor
string | null

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.

Example:

"eyJ0Ijoi..."