> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitless.exchange/llms.txt
> Use this file to discover all available pages before exploring further.
# Browse Active Markets
> Retrieves markets and groups that are active and not yet resolved, with optional category filtering
For category- and property-based filtering (the structured filters Limitless uses to organize markets), use the **Market Pages** endpoints: resolve a page with [Get Market Page by Path](/api-reference/navigation/get-page-by-path) to read its `baseFilter` and `filterGroups`, then [List Markets for a Page](/api-reference/navigation/list-page-markets). `GET /markets/active` returns a flat list with basic filtering.
**`limit` is capped at 25.** Values above `25` are rejected with `400` (`limit must not be greater than 25`) — the endpoint never silently truncates. To read more than 25 markets, page with the `page` parameter; the response's `totalMarketsCount` tells you how many are available in total.
**`tradeType` filter values.** Selects the market's trading model:
* `amm` — Automated market maker. Prices are set algorithmically against a liquidity pool, and you trade directly against the curve.
* `clob` — Central limit order book. Independent YES/NO bids and asks match at prices set by makers and takers. Supports market and limit orders. See [CLOB Overview](/user-guide/clob-overview).
* `group` — Multi-outcome group (also called Negrisk / category markets). Multiple outcomes are bundled and only one can win; the NO shares across outcomes are linked, which makes collateral more efficient. See [Negrisk Markets](/user-guide/negrisk-overview).
**`automationType` filter values.** Selects how a market is created and resolved:
* `lumy` — Price-oracle-driven markets created by the recurring launch jobs (for example crypto or stock price ladders). Individual markets carry a `price_oracle_id`; group markets qualify when any child does. These resolve automatically at the deadline via the oracle (typically Pyth). The `Lumy` category tag is a branding label and is not the same signal — always filter by `automationType`, not by tag.
* `manual` — Markets that are not oracle-driven and not sports/esports fixtures. Resolved by the Limitless team against the criteria on the market page, typically within 24–72 hours of the deadline. See [Market Resolution](/user-guide/market-resolution).
* `sports` — Sports fixture markets (identified by a `fixtureId` or the sports event provider). Resolved from the fixture result feed.
**`includeNextMarket` (optional).** Opt in to receive the next round of upfront-scheduled markets, such as crypto price ladders that run in back-to-back windows. When `true`, each affected market includes a `navigation.nextMarket` object with the successor's `slug`, `startAt`, `deadline`, and `tradable` flag. The current market also stays listed briefly during the activation gap, so the series is always represented by exactly one row.
Use this when you want to prefetch the next round or open a websocket subscription before the current market expires. Leave it unset for the default listing behavior. Cursor tokens are scoped to this option, so do not switch it mid-pagination.
```bash theme={null}
GET /markets/active?includeNextMarket=true
```
The `tradable` flag is conservative in listings — a successor that has not yet activated reports `false`. Fetch the successor directly with [Get Market](/api-reference/markets/get-market) before submitting an order.
## OpenAPI
````yaml GET /markets/active
openapi: 3.0.0
info:
title: Limitless Exchange API
description: >-
Production-ready REST API for prediction market trading, portfolio
management, and market data on Limitless Exchange (Base L2).
version: '1.0'
contact:
name: API Support
url: https://limitless.exchange
email: help@limitless.network
servers:
- url: https://api.limitless.exchange
description: Production API
security: []
tags:
- name: Authentication
description: User authentication and session management
- name: Markets
description: Browse, search, and analyze prediction markets
- name: Market Navigation
description: Navigation tree, market pages, and property filters
- name: Trading
description: Create, manage, and cancel orders
- name: Portfolio
description: Position tracking, trade history, and performance
- name: API Tokens
description: Scoped API token management for partner integrations
- name: Partner Accounts
description: Sub-account creation and allowance recovery for partner integrations
- name: System
description: Public API state and availability information
- name: Referral
description: Referral program earnings, referred users, and leaderboards
- name: Leaderboard
description: >-
Live Unrealized PnL leaderboards for open markets and biggest open
positions
paths:
/markets/active:
get:
tags:
- Markets
summary: Browse Active Markets
description: >-
Retrieves markets and groups that are active and not yet resolved, with
optional category filtering
operationId: MarketController_getActiveMarkets[1]
parameters:
- name: page
required: false
in: query
description: Page number for pagination
schema:
example: 1
type: number
- name: limit
required: false
in: query
description: Number of items per page
schema:
example: 10
type: number
- name: sortBy
required: false
in: query
description: Sort by query parameter
schema:
example: newest
type: string
- name: tradeType
required: false
in: query
description: Filter by trade type (amm, clob, or group)
schema:
enum:
- amm
- clob
- group
type: string
- name: automationType
required: false
in: query
description: Filter by automation type (manual, lumy, or sports)
schema:
enum:
- manual
- lumy
- sports
type: string
- name: categoryId
required: false
in: path
description: Filter markets by category ID
schema:
type: number
responses:
'200':
description: Active markets and groups with volume and liquidity data
content:
application/json:
schema:
$ref: '#/components/schemas/BrowseActiveMarketsResponseDto'
'500':
description: Server error when retrieving markets data
components:
schemas:
BrowseActiveMarketsResponseDto:
type: object
properties:
data:
type: array
description: >-
Array of active markets with complete trading data including volume,
liquidity, and recent feed events
example:
- id: 7495
address: '0x76d3e2098Be66Aa7E15138F467390f0Eb7349B9b'
conditionId: >-
0x812f578437dc536def1412e4e593ef310884262c22868b30c1e58582e5f3e9bf
title: $DOGE above $0.21652 on Sep 1, 12:00 UTC?
description: >-
This market will resolve to "YES" if the price of $DOGE is above
$0.21652...
collateralToken:
address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
decimals: 6
symbol: USDC
creator:
name: Limitless
imageURI: https://limitless.exchange/assets/images/logo.svg
link: https://x.com/trylimitless
prices:
- 42.8
- 57.2
categories:
- Hourly
tags:
- Lumy
- Recurring
- Hourly
- Simple Mode
status: FUNDED
expired: false
expirationDate: Sep 1, 2025
expirationTimestamp: 1756728000000
volume: '164109293'
volumeFormatted: '164.109293'
openInterest: '48310707'
openInterestFormatted: '48.310707'
liquidity: '50000000'
liquidityFormatted: '50.000000'
tradeType: amm
marketType: single
slug: dollardoge-above-dollar021652-on-sep-1-1200-utc-1756724413009
feedEvents:
- eventType: NEW_TRADE
timestamp: '2025-09-01T11:30:31.000Z'
user:
id: 7080
account: '0xea27f6788F083e6070961d3E52A2e596367E04CC'
name: GG
rankName: Bronze
points: '0.00000000'
data:
title: $DOGE above $0.21652 on Sep 1, 12:00 UTC?
address: '0x76d3e2098Be66Aa7E15138F467390f0Eb7349B9b'
strategy: Buy
outcome: 'NO'
contracts: '9.071313'
tradeAmount: '5'
tradeAmountUSD: '4.999525'
marketId: 7495
items:
type: object
description: Market object with complete trading data (FEMarket type)
additionalProperties: true
totalMarketsCount:
type: number
description: Total number of active markets available for pagination
example: 150
required:
- data
- totalMarketsCount
````