Get Market Events

Returns public, finalized MINED CLOB trades newest first. An exact market slug selects that market; if no market matches, an exact group slug combines all group markets. Stable-slug aliases are not resolved. No authentication is required.

GET /markets/{slug}/events

Get Finalized Market Trades

cURL

curl --request GET \
  --url https://api.limitless.exchange/markets/{slug}/events

200

{
  "events": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "makerAmount": "1000000",
      "matchedSize": "2000000",
      "price": 0.5,
      "side": 0,
      "takerAmount": "1000000",
      "title": "<string>",
      "tokenId": "<string>",
      "txHash": "<string>",
      "profile": {
        "username": "<string>",
        "displayName": "<string>",
        "pfpUrl": "<string>",
        "socialUrl": "<string>",
        "rankName": "Bronze"
      }
    }
  ],
  "limit": 50,
  "page": 2,
  "totalPages": 2,
  "totalRows": 2
}

Returns public, finalized CLOB trade activity. Each event represents a MINED trade; this endpoint does not report order placement, cancellation, or liquidity-change events. No authentication is required.

Slug scope

The path accepts either an exact market slug or an exact market-group slug. Market lookup runs first. A market slug returns trades for that market; a group slug combines trades from all markets in the group. Stable-slug aliases are not resolved.

The feed is backed only by finalized CLOB trades. Resolving a market that has no such activity returns an empty page.

Trade fields and units

Events are ordered newest first. side is the taker side and uses the numeric mapping 0 = BUY, 1 = SELL.

matchedSize is the taker’s filled position-token amount in raw 6-decimal units. makerAmount and takerAmount currently both contain the trade’s collateral cost in raw 6-decimal units. These three values are decimal strings; divide them by 1e6 for display amounts. price is the weighted average fill price as a JSON number.

When available, profile publicly attributes the taker by username, display name, profile-picture URL, social URL, and rank. The field is omitted when no public profile can be resolved.

Pagination

page defaults to 1 and limit defaults to 100. Both must be integers greater than or equal to 1, and limit cannot exceed 100.

A populated page returns events, limit, page, totalPages, and totalRows. The current runtime returns the reduced shape below whenever a page has no events, including an out-of-range page:

{
  "events": [],
  "totalPages": 0
}

The reduced empty-page shape intentionally omits limit, page, and totalRows.

Freshness and caching

Successful responses use Cache-Control: public, max-age=30, s-maxage=30, stale-while-revalidate=30. Newly mined trades may therefore not appear immediately. A 404 response uses a 5-minute cache and a further 5-minute stale-while-revalidate window.

Errors

Status	Meaning
400	page or limit is invalid, or an unknown query field was supplied.
404	The slug matches neither an exact market nor an exact market group.
500	The trade activity lookup failed unexpectedly.

Path Parameters

slug · string · required

Exact market or market-group slug. Market lookup takes precedence; stable-slug aliases are not resolved.

Example:

"presidential-election-2024"

Query Parameters

page · integer · default: 1

One-based page number. Defaults to 1.

Required range: x >= 1

Example:

1

limit · integer · default: 100

Maximum trades per page. Defaults to 100.

Required range: 1 <= x <= 100

Example:

20

Response

200

application/json

Finalized CLOB trade page. A page with no events currently returns only events and totalPages.

Option 1

Option 2

events · object[] · required

Show child attributes

limit · integer · required

Required range: 1 <= x <= 100

page · integer · required

Required range: x >= 1

totalPages · integer · required

Required range: x >= 1

totalRows · integer · required

Required range: x >= 1