Get Market Events

Get Finalized Market Trades

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

const options = {method: 'GET'};

fetch('https://api.limitless.exchange/markets/{slug}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/markets/{slug}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.limitless.exchange/markets/{slug}/events"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.limitless.exchange/markets/{slug}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "events": [
    {
      "createdAt": "2026-08-18T08:00:00.000Z",
      "makerAmount": "1000000",
      "matchedSize": "2000000",
      "price": 0.5,
      "profile": {
        "username": "trader",
        "displayName": "Trader",
        "pfpUrl": null,
        "socialUrl": null,
        "rankName": null
      },
      "side": 0,
      "takerAmount": "1000000",
      "title": "Will BTC close above $100,000?",
      "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
      "txHash": "0x6f8bc56efb8e52c8138e2d8900f6f1bb10e10f789739f786f128f6098c55b572"
    },
    {
      "createdAt": "2026-08-18T07:55:00.000Z",
      "makerAmount": "2500000",
      "matchedSize": "5000000",
      "price": 0.5,
      "side": 1,
      "takerAmount": "2500000",
      "title": "Will BTC close above $100,000?",
      "tokenId": "34633204485790857949828516737993423758628930235371629943999544859324645414627",
      "txHash": "0x5d96e592c61b4c46943d5fd42adbe5ef57fc247a43c4be59c02545028bc3cdaa"
    }
  ],
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "totalRows": 42
}

GET

markets

{slug}

events

Get Finalized Market Trades

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

const options = {method: 'GET'};

fetch('https://api.limitless.exchange/markets/{slug}/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/markets/{slug}/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.limitless.exchange/markets/{slug}/events"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.limitless.exchange/markets/{slug}/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "events": [
    {
      "createdAt": "2026-08-18T08:00:00.000Z",
      "makerAmount": "1000000",
      "matchedSize": "2000000",
      "price": 0.5,
      "profile": {
        "username": "trader",
        "displayName": "Trader",
        "pfpUrl": null,
        "socialUrl": null,
        "rankName": null
      },
      "side": 0,
      "takerAmount": "1000000",
      "title": "Will BTC close above $100,000?",
      "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
      "txHash": "0x6f8bc56efb8e52c8138e2d8900f6f1bb10e10f789739f786f128f6098c55b572"
    },
    {
      "createdAt": "2026-08-18T07:55:00.000Z",
      "makerAmount": "2500000",
      "matchedSize": "5000000",
      "price": 0.5,
      "side": 1,
      "takerAmount": "2500000",
      "title": "Will BTC close above $100,000?",
      "tokenId": "34633204485790857949828516737993423758628930235371629943999544859324645414627",
      "txHash": "0x5d96e592c61b4c46943d5fd42adbe5ef57fc247a43c4be59c02545028bc3cdaa"
    }
  ],
  "limit": 20,
  "page": 1,
  "totalPages": 3,
  "totalRows": 42
}

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

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

⌘I

Overview

System

Authentication

Markets

Trading

Portfolio

Market Pages & Navigation

API Tokens

Partner Accounts

Public Portfolio

Referral

Leaderboard

Slug scope

Trade fields and units

Freshness and caching

Errors

Path Parameters

Query Parameters

Response

​Slug scope

​Trade fields and units

​Pagination

​Freshness and caching

​Errors

Path Parameters

Query Parameters

Response

Slug scope

Trade fields and units

Pagination

Freshness and caching

Errors