Skip to main content
GET
/
v1
/
markets
List Markets
curl --request GET \
  --url https://api.predictamarkets.com/v1/markets
[
  {
    "id": 12,
    "qid": "MKT-12",
    "slug": "will-bitcoin-hit-100k-before-july-2025",
    "title": "Will Bitcoin hit $100k before July 2025?",
    "description": "Resolves YES if BTC closes above $100,000 on Binance before 1 July 2025.",
    "logo_path": "https://cdn.predictamarkets.com/logos/btc.png",
    "currency": "KES",
    "expires_at": "2025-07-01T00:00:00Z",
    "status": "OPEN",
    "is_active": true,
    "allows_trading": true,
    "locked_at": null,
    "display_group": "ALL",
    "total_buy_in": "125000.00",
    "market_total_share": "125000.00",
    "created_at": "2024-12-01T10:00:00Z",
    "updated_at": "2025-05-01T08:00:00Z",
    "market_type": "DEFAULT",
    "ticker_symbol": "BTC",
    "tracking_identifier": null,
    "market_domain": "crypto",
    "market_category": {
      "id": 3,
      "name": "Crypto",
      "slug": "crypto",
      "description": "Cryptocurrency markets",
      "icon": "bitcoin"
    },
    "market_assets": [
      {
        "id": 34,
        "qid": "MAS-34",
        "prediction_key": "mkt-12-yes",
        "label": "YES",
        "side": "YES",
        "probability": 0.65
      },
      {
        "id": 35,
        "qid": "MAS-35",
        "prediction_key": "mkt-12-no",
        "label": "NO",
        "side": "NO",
        "probability": 0.35
      }
    ],
    "regeneration_interval_type": null,
    "regeneration_interval_value": null,
    "regeneration_timezone": null,
    "regeneration_schedule": null,
    "regeneration_template_format": null,
    "last_regenerated_at": null,
    "next_regeneration_at": null,
    "regenerated_title": null,
    "regeneration_count": null
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.predictamarkets.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
skip
integer
default:0

Records to skip for pagination (default: 0) Number of records to skip

​
limit
integer
default:25

Max records to return (default: 10) Maximum number of records to return

​
status
string | null

Filter by market status: PENDING_APPROVAL, OPEN, CLOSED, LOCKED, CANCELLED, COMPLETED, SETTLED, REJECTED Filter by market status (e.g., 'active')

​
currency
enum<string> | null

Filter by currency (e.g., 'USD')

Available options:
NGN,
USD,
KES,
GHS,
ZAR,
XOF,
TZS,
EUR,
GBP,
CAD,
AUD,
CHF,
CNY,
INR,
MXN,
NZD,
RUB,
SEK,
SGD,
THB,
TRY,
UAH,
VND,
JPY,
UGX,
RWF,
USDC,
USDT,
PT
​
is_active
boolean | null

Filter by active status

​
market_category_slug
string | null

Filter by market category slug

​
display_group
enum<string> | null

Filter by display group

Available options:
TRENDING,
POPULAR,
DISCOVER,
NEW,
FEATURED,
RECENT,
TOP,
ALL
​
account_id
integer | null

Filter by creator account ID

​
market_domain
enum<string> | null

Filter by market domain (e.g., 'FINANCE', 'SPORTS', 'CRYPTO')

Available options:
SPORTS,
FINANCE,
CRYPTO,
GENERAL
​
tracking_identifier
string | null

Filter by tracking identifier (e.g. ticker symbol)

​
search
string | null

Full-text search against market title Full-text search on market title

​
sort_by
string[] | null

Sort fields, prefix with - for descending (e.g. -created_at) Fields to sort by, prefix with - for descending order (e.g., ['-created_at'])

Response

List of markets

​
id
integer
required

Unique identifier for the market

​
qid
string
required

Query identifier for the market

​
title
string
required

Market title

​
currency
string
required

Currency used for transactions in this market

​
created_at
string<date-time>
required

Timestamp when the market was created

​
updated_at
string<date-time>
required

Timestamp when the market was last updated

​
market_type
enum<string>
required

Market type

Available options:
DEFAULT,
SERIES
​
slug
string | null

Slug of the market

​
description
string | null

Market description

​
logo_path
string | null

URL of the market logo

​
expires_at
string<date-time> | null

Expiration date of the market

​
status
string | null

Current status of the market

​
is_active
boolean
default:true

Whether the market is currently active

​
allows_trading
boolean
default:true

Whether the market allows trading (based on status, active state, and expiration)

​
locked_at
string<date-time> | null

Time when the market gets locked

​
display_group
enum<string>
default:ALL

Display group of the market

Available options:
TRENDING,
POPULAR,
DISCOVER,
NEW,
FEATURED,
RECENT,
TOP,
ALL
​
total_buy_in
string
default:0

Total amount of buy-in in the market

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
market_total_share
string | null

Total share of the market

Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
​
ticker_symbol
string | null

Ticker symbol for the market

​
tracking_identifier
string | null

Tracking identifier for querying and analytics

​
market_domain
string | null

Market domain

​
regeneration_interval_type
enum<string> | null

Regeneration interval type

Available options:
HOUR,
DAY,
WEEK,
MONTH,
YEAR,
CUSTOM
​
regeneration_interval_value
integer | null

Regeneration interval value

​
regeneration_timezone
string | null

IANA timezone name for custom schedules

​
regeneration_schedule
SimpleRegenerationSchedule · object

Custom regeneration schedule

​
regeneration_template_format
enum<string> | null

Regeneration template format

Available options:
DEFAULT,
ABOVE_AT_OR_BELOW_PERCENTAGE
​
last_regenerated_at
string<date-time> | null

Timestamp when the market was last regenerated

​
next_regeneration_at
string<date-time> | null

Timestamp when the market will be regenerated next

​
regenerated_title
string | null

Regenerated title for series markets

​
regeneration_count
integer | null

Total number of regeneration cycles

​
market_category
MarketCategoryListSchema · object

Category of the market

​
market_assets
MarketAssetListSchema · object[] | null

List of market assets under this market