Skip to main content
GET
Get History
CLOB fills live here. Limitless does not expose a dedicated fills endpoint. This endpoint returns every CLOB fill for the authenticated account as a history entry. Use the strategy field to distinguish fill types:
  • Limit Buy / Limit Sell — CLOB maker fills (a resting limit order of yours was hit).
  • Market Buy / Market Sell — CLOB taker fills (your order crossed the book on submission).
  • Buy / Sell — AMM trades (also available via Get Trades).
  • Split / Merge — position split/merge.
  • Convert — NegRisk conversion.
  • Claim — winnings redemption.
Each entry includes outcomeTokenPrice (effective fill price), outcomeTokenAmounts, collateralAmount, blockTimestamp, and transactionHash (present once settled on-chain). Paginate with cursor and limit.
Deposits and withdrawals are not included. This endpoint covers on-platform activity only (fills, splits, merges, conversions, and claims). Raw USDC deposits and withdrawal transfers are not returned here and the API does not expose a dedicated deposit/withdrawal history endpoint. POST /portfolio/withdraw executes a withdrawal but does not return past withdrawals. To reconstruct transfers, query the on-chain USDC transfers to and from your account on Base.
No historical orderbook. The API does not expose historical order book snapshots. Get Orderbook returns only the current live snapshot. To reconstruct past activity for a market, combine your own fill history from this endpoint with Get Historical Prices and Get Feed Events.

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. Cursors are market-scoped and must be replayed with the same market value they were issued for.

limit
number
default:20

Number of items per page (1-100).

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

20

market
string

Market slug. When set, the response only includes activity for that market across every source: CLOB and AMM trades, splits/merges, NegRisk conversions, claims, and resolutions. An unknown slug returns 404. Cursors issued with this parameter are only valid when replayed with the same value.

Required string length: 1 - 200
Example:

"will-btc-close-above-100k-on-dec-31"

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