Get Trading Activity Feed

Get the public trading activity feed

curl --request GET \
  --url https://api.limitless.exchange/feed/trading

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/feed/trading",
  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/feed/trading"

	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/feed/trading")

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

{
  "requestedAudience": "all",
  "effectiveAudience": "all",
  "events": [
    {
      "id": "<string>",
      "entryType": "BOUGHT",
      "occurredAt": "<string>",
      "facts": {},
      "profile": {
        "id": 123,
        "account": "<string>",
        "displayName": "<string>",
        "username": "<string>",
        "pfpUrl": "<string>",
        "rankName": "<string>",
        "xHandle": "<string>"
      },
      "subject": {
        "kind": "MARKET",
        "id": 123,
        "slug": "<string>",
        "groupSlug": "<string>",
        "groupTitle": "<string>",
        "groupImageUrl": "<string>",
        "title": "<string>",
        "status": "<string>",
        "imageUrl": "<string>",
        "tradable": true,
        "createdAt": "<string>",
        "startAt": "<string>",
        "deadline": "<string>",
        "resolvedAt": "<string>",
        "winningOutcomeIndex": 123,
        "payoutNumerators": [
          123
        ],
        "prices": [
          123
        ]
      },
      "parlay": {
        "name": "<string>",
        "legs": [
          {
            "marketId": 123,
            "imageUrl": "<string>",
            "outcomeLabels": [
              "<string>"
            ],
            "outcomeImageUrls": [
              "<string>"
            ],
            "leagueName": "<string>",
            "homeTeam": "<string>",
            "awayTeam": "<string>",
            "homeScore": 123,
            "awayScore": 123,
            "startsAt": "<string>"
          }
        ]
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "emptyReason": "NO_FOLLOWS"
}

GET

feed

trading

Get the public trading activity feed

curl --request GET \
  --url https://api.limitless.exchange/feed/trading

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.limitless.exchange/feed/trading",
  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/feed/trading"

	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/feed/trading")

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

{
  "requestedAudience": "all",
  "effectiveAudience": "all",
  "events": [
    {
      "id": "<string>",
      "entryType": "BOUGHT",
      "occurredAt": "<string>",
      "facts": {},
      "profile": {
        "id": 123,
        "account": "<string>",
        "displayName": "<string>",
        "username": "<string>",
        "pfpUrl": "<string>",
        "rankName": "<string>",
        "xHandle": "<string>"
      },
      "subject": {
        "kind": "MARKET",
        "id": 123,
        "slug": "<string>",
        "groupSlug": "<string>",
        "groupTitle": "<string>",
        "groupImageUrl": "<string>",
        "title": "<string>",
        "status": "<string>",
        "imageUrl": "<string>",
        "tradable": true,
        "createdAt": "<string>",
        "startAt": "<string>",
        "deadline": "<string>",
        "resolvedAt": "<string>",
        "winningOutcomeIndex": 123,
        "payoutNumerators": [
          123
        ],
        "prices": [
          123
        ]
      },
      "parlay": {
        "name": "<string>",
        "legs": [
          {
            "marketId": 123,
            "imageUrl": "<string>",
            "outcomeLabels": [
              "<string>"
            ],
            "outcomeImageUrls": [
              "<string>"
            ],
            "leagueName": "<string>",
            "homeTeam": "<string>",
            "awayTeam": "<string>",
            "homeScore": 123,
            "awayScore": 123,
            "startsAt": "<string>"
          }
        ]
      }
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>",
  "emptyReason": "NO_FOLLOWS"
}

Returns a feed of trading activity from the last 24 hours, newest first. Entries cover buys, sells, market resolutions, and pack (parlay) placements and resolutions. Public for the all and featured audiences; the following audience requires authentication.

When to use

Use this endpoint to render an activity feed of what traders are doing on the platform right now. Choose a global stream, a curated list of featured traders, or a personal stream of the profiles the signed-in viewer follows. The API filters out small activity server-side so the feed stays meaningful.

Audiences

The audience query parameter selects which profiles the feed reads:

all (default): activity from every profile. Public.
featured: activity from a curated set of featured traders. Public.
following: activity from the profiles the viewer follows. Requires authentication; an unauthenticated request returns 401 Unauthorized.

If the first featured page has no entries, the API serves the all stream instead and sets effectiveAudience: "all" in the response. A new viewer never lands on an empty screen. The returned cursor carries the effective audience, and continuation requests keep paging that same stream. On the following audience, emptyReason distinguishes two empty states without a second request: NO_FOLLOWS when the viewer follows nobody, NO_RECENT_ACTIVITY when the followed profiles have been quiet. It is null everywhere else.

Entry types

Each entry carries an entryType and a facts object with immutable event-time values:

BOUGHT / SOLD: side, outcome, contracts, execution price, notional, and collateral symbol. SOLD entries also carry realizedPnl, averageEntryPrice, and roi when close data fully covers the fill; otherwise those fields are null and the entry shows the fill only. Close data typically lands a few minutes after the fill. The API backfills the figures onto recent SOLD entries within minutes rather than waiting for hourly reconciliation.
RESOLVED: the aggregated result (WON, LOST, or BREAK_EVEN) for a profile in one market or group, with realized PnL, cost basis, payout, and a per-market position breakdown.
PARLAY_PLACED / PARLAY_RESOLVED: the pack’s legs, stake, multiplier, and potential payout, plus the payout, realized PnL, and result once resolved.

Display fields

Beyond facts, each entry carries display data that the API resolves at read time, when you fetch the page:

profile: the trader’s account, display name, username, profile picture, rank name, and connected X handle (xHandle, null when no X account is connected).
subject: the market or group the entry is about. null on parlay entries. See Subject fields.
parlay (parlay entries only): the source pack’s name (null for a custom parlay or a deleted pack) and ordered leg details, including crest image, named outcomes, league, teams, live score, and fixture kickoff. Use parlay.legs[].startsAt for match times; facts.legs[].startsAt is the market deadline, not the kickoff.

There is no per-trader live position block. A card values its own facts.contracts at the subject’s current prices.

Subject fields

The subject identifies the market (kind: "MARKET") or group (kind: "GROUP") the entry is about, with its id, slug, title, status, and imageUrl card image.

tradable is true only while the subject can actually be traded: the market must be funded, unresolved, and before its deadline. A group is tradable only when at least one visible child market meets those conditions.
A market inside a group carries groupTitle, groupSlug, and groupImageUrl, so a card can lead with the group question and its artwork while the market’s own title names the outcome. All three are null for a standalone market.

Market subjects also carry lifecycle and price data:

createdAt, startAt, and deadline: when the market was created, when trading opened, and when trading closes.
resolvedAt: when the market resolved. null until the market resolves. This is the resolution time, not the deadline; a market resolved early carries its actual resolution time.
winningOutcomeIndex and payoutNumerators: the resolution result. null until the market resolves.
prices: current [yes, no] prices as fractions between 0 and 1, on the same scale as facts.price. A resolved market carries its resolution outcome; an unresolved orderbook market carries its latest stored midpoint. null when no honest price exists, such as an AMM market or a market with no price observations. The API never invents a price.

Group subjects return all lifecycle and price keys as null. A group settles many markets at once and has no single lifecycle or price; use a child market’s own data instead.

Pagination

limit accepts 1-30 and defaults to 30.
Pass nextCursor from the previous page as cursor to fetch the next page. nextCursor is null on the last page.
The cursor is opaque and pinned to the audience that issued it. A malformed or tampered cursor returns 400 with code TRADING_FEED_CURSOR_INVALID; a cursor sent with a different audience returns 400 with code TRADING_FEED_CURSOR_AUDIENCE_MISMATCH.

Availability

The feed fails closed rather than serving incomplete data:

503 with code TRADING_FEED_INITIALIZING while the API is still building the first 24-hour window after a deployment.
503 with code TRADING_FEED_STALE when the feed is temporarily behind.

Both are transient; retry later.

Caching

Responses for all and featured carry Cache-Control: public, s-maxage=60, stale-while-revalidate=30, so CDN edges may serve a shared cached copy for up to a minute. following responses are per-viewer and carry private, no-store.

Example

curl "https://api.limitless.exchange/feed/trading?audience=all&limit=10"

{
  "requestedAudience": "all",
  "effectiveAudience": "all",
  "events": [
    {
      "id": "clob:123456:42",
      "entryType": "BOUGHT",
      "occurredAt": "2026-09-02T14:03:11.482910Z",
      "facts": {
        "side": "BUY",
        "outcome": "YES",
        "contracts": "120",
        "price": "0.540000",
        "notional": "64.800000",
        "symbol": "USDC"
      },
      "profile": {
        "id": 42,
        "account": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "displayName": "Alice",
        "username": "alice",
        "pfpUrl": "https://...",
        "rankName": "Expert",
        "xHandle": "alice_trades"
      },
      "subject": {
        "kind": "MARKET",
        "id": 9876,
        "slug": "will-x-happen-123",
        "title": "Will X happen?",
        "status": "FUNDED",
        "imageUrl": "https://...",
        "groupTitle": null,
        "groupSlug": null,
        "groupImageUrl": null,
        "createdAt": "2026-09-01T09:00:00.000000Z",
        "startAt": "2026-09-01T10:00:00.000000Z",
        "deadline": "2026-09-05T00:00:00.000000Z",
        "resolvedAt": null,
        "winningOutcomeIndex": null,
        "payoutNumerators": null,
        "prices": [0.57, 0.43],
        "tradable": true
      },
      "parlay": null
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJhIjoi...",
  "emptyReason": null
}

Query Parameters

audience

enum<string>

default:all

Which set of profiles to read. following requires authentication. Defaults to all.

Available options:

all,

following,

featured

limit

number

default:30

Entries per page (1-30).

Required range: 1 <= x <= 30

cursor

string

Opaque cursor from nextCursor on the previous page. A cursor is pinned to the audience that issued it; sending it with a different audience returns 400.

Response

One page of trading activity, newest first

requestedAudience

enum<string>

required

The audience the request asked for

Available options:

all,

following,

featured

effectiveAudience

enum<string>

required

The audience actually served. Differs from requestedAudience only when a first featured page was empty and fell back to all; the cursor carries this value so continuation requests keep paging the same stream.

Available options:

all,

following,

featured

events

object[]

required

Show child attributes

hasMore

boolean

required

nextCursor

string | null

required

Pass as cursor with the same audience to fetch the next page; null on the last page

emptyReason

enum<string> | null

required

Only meaningful on the following audience: distinguishes a viewer who follows nobody from followed profiles that have been quiet

Available options:

NO_FOLLOWS,

NO_RECENT_ACTIVITY,

null

Overview

System

Authentication

Markets

Packs

Trading

Portfolio

Market Pages & Navigation

API Tokens

Partner Accounts

Public Portfolio

Feed

Referral

Leaderboard

When to use

Audiences

Entry types

Display fields

Subject fields

Availability

Caching

Example

Query Parameters

Response

​When to use

​Audiences

​Entry types

​Display fields

​Subject fields

​Pagination

​Availability

​Caching

​Example

Query Parameters

Response

When to use

Audiences

Entry types

Display fields

Subject fields

Pagination

Availability

Caching

Example