Get User History (Public)
Paginated trading history for a specific user address. Returns AMM and CLOB trades, splits/merges, and NegRisk conversions using the same cursor-based pagination as the authenticated /portfolio/history endpoint. No authentication required.
/portfolio/history endpoint. It returns the same paginated history shape for any address, without requiring HMAC authentication.When to use
Use this endpoint to read another user’s trading history. Common cases include rendering a public profile, a feed, or a leaderboard drill-down. If you are reading your own history and want a stable, private view, use the authenticated/portfolio/history endpoint instead.
Pagination
The endpoint uses cursor-based pagination:- Omit
cursoron the first request. - The response includes a
nextCursorvalue; pass it ascursoron the next request to fetch the following page. - When
nextCursorisnullor absent, you have reached the end of the history. limitaccepts values between1and100. If omitted, the default is20.
Address handling
Theaccount path parameter accepts any valid Ethereum address in either checksummed (EIP-55) or lowercase form. The API normalizes the address server-side, so 0xABC… and 0xabc… resolve to the same user.
- A malformed address returns
400 Bad Request. - An address that has never interacted with Limitless returns
404 Not Found.
Path Parameters
User Ethereum address. Any valid EIP-55 or lowercase address is accepted; the address is normalized server-side. Malformed addresses return 400.
"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
Query Parameters
Opaque cursor for cursor-based pagination. Omit for the first page. For subsequent pages, pass the nextCursor value from the previous response.
Number of items per page (1-100).
1 <= x <= 10020
Response
Paginated history page
List of history entries
Total count of entries (null in cursor mode)
8
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.
"eyJ0Ijoi..."