Skip to main content
GET
Get User History (Public)
This is the public counterpart to the authenticated /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 cursor on the first request.
  • The response includes a nextCursor value; pass it as cursor on the next request to fetch the following page.
  • When nextCursor is null or absent, you have reached the end of the history.
  • limit accepts values between 1 and 100. If omitted, the default is 20.

Address handling

The account 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

account
string
required

User Ethereum address. Any valid EIP-55 or lowercase address is accepted; the address is normalized server-side. Malformed addresses return 400.

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

Query Parameters

cursor
string

Opaque cursor for cursor-based pagination. Omit for the 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 page

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