GET /api/markets

List all available prediction markets with filtering and pagination

Fetches a paginated list of all available prediction markets with optional filtering.

Endpoint

GET https://app.kash.bot/api/markets

Query Parameters

status · string · default: "active"

Filter by market status: active, resolved, cancelled, paused, refunded, all. Defaults to active, so resolved markets are excluded unless you request them. Use all to fetch the full active + resolved set in one pass.

active · boolean

Convenience filter that overrides status when present: active=true returns active markets, active=false returns resolved markets. Omit to keep the status default.

resolvedAfter · number

Epoch-second lower bound on resolution time. Applies when the result set includes resolved markets (active=false, status=resolved, or status=all) — use it to slice a large resolved archive by date.

resolvedBefore · number

Epoch-second upper bound on resolution time. Applies when the result set includes resolved markets (active=false, status=resolved, or status=all).

category · string

Filter by category (e.g., politics, crypto, sports)

threadId · string

Filter to only markets in a specific thread (UUID). Also accepts thread_id for backward compatibility.

organizationId · string

Filter to markets belonging to a specific organization (UUID)

partnerId · string

Filter to markets belonging to a specific partner (UUID)

chapterId · string

Filter to markets in a specific chapter

limit · number · default: "50"

Maximum number of results per page (max: 100)

offset · number · default: "0"

Pagination offset for fetching subsequent pages

sortBy · string · default: "created_at"

Field to sort by: created_at, total_volume, current_probability, title, end_time

sortOrder · string · default: "desc"

Sort direction: asc, desc

Response

markets · array

Array of market objects

Show Market Object

id · string

Unique market identifier

question · string

Market question

description · string

Market description (optional)

probability · number

Current YES probability (0-1)

yesPrice · number

Current YES share price

noPrice · number

Current NO share price

totalVolume · number

Total trading volume in cents

tradeCount · number

Number of trades

status · string

Market status: OPEN, FROZEN, RESOLVED, CANCELLED

endTime · number

Market end time (Unix timestamp in milliseconds)

category · string

Market category

createdAt · string

ISO 8601 timestamp of market creation

sourceTweetUrl · string

URL of the original market tweet (for quote tweets)

pagination · object

Pagination metadata

Show Pagination Object

offset · number

Current offset

limit · number

Results per page

total · number

Total number of matching markets

hasMore · boolean

Whether more results are available

Rate Limit

100 requests per minute per IP address

Example Request

cURL

curl "https://app.kash.bot/api/markets?status=active&limit=10&sortBy=total_volume&sortOrder=desc"

Example Response

200 - Success

{
  "markets": [
    {
      "id": "market-abc123",
      "question": "Will BTC hit $100k by end of 2025?",
      "description": "Resolves YES if Bitcoin reaches $100,000 USD on any major exchange",
      "probability": 0.72,
      "yesPrice": 0.72,
      "noPrice": 0.28,
      "totalVolume": 1250000,
      "tradeCount": 450,
      "status": "OPEN",
      "endTime": 1735689600000,
      "category": "crypto",
      "createdAt": "2024-01-01T00:00:00Z",
      "sourceTweetUrl": "https://twitter.com/kash_bot/status/123..."
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 156,
    "hasMore": true
  }
}

---

GET /api/markets/trending

Get trending markets based on recent activity and momentum.

Endpoint

GET https://app.kash.bot/api/markets/trending

Query Parameters

timeframe · string · default: "24h"

Trending timeframe: 1h, 24h, 7d

limit · number · default: "50"

Maximum results (max: 200)

category · string

Filter by category

Rate Limit

100 requests per minute per IP address

Example Request

cURL

curl "https://app.kash.bot/api/markets/trending?timeframe=24h&limit=5"

Example Response

200 - Success

{
  "markets": [
    {
      "id": "market-xyz789",
      "question": "Will ETH flip BTC this year?",
      "probability": 0.15,
      "totalVolume": 890000,
      "tradeCount": 234,
      "trendingScore": 95.4,
      "trendingRank": 1,
      "recentMetrics": {
        "tradeCount": 45,
        "volume": 125000,
        "uniqueTraders": 28
      }
    }
  ],
  "timeframe": {
    "trending": "24h"
  }
}

---

GET /api/markets/featured

Get featured high-volume markets curated by Kash.

Endpoint

GET https://app.kash.bot/api/markets/featured

Rate Limit

100 requests per minute per IP address

Example Request

cURL

curl "https://app.kash.bot/api/markets/featured"

Example Response

200 - Success

{
  "markets": [
    {
      "id": "market-featured-1",
      "question": "Who will win the 2024 Presidential Election?",
      "probability": 0.52,
      "totalVolume": 5600000,
      "tradeCount": 1250,
      "featured": true
    }
  ],
  "_meta": {
    "count": 6
  }
}

---

Common Use Cases

Fetch high-volume markets

curl "https://app.kash.bot/api/markets?sortBy=total_volume&sortOrder=desc&limit=10"

Filter by category

curl "https://app.kash.bot/api/markets?category=crypto&status=active"

Fetch the full set (active + resolved) in one pass

The endpoint returns only active markets by default. Pass status=all to include resolved markets, then page through with offset/limit (pagination.total and pagination.hasMore tell you when to stop).

curl "https://app.kash.bot/api/markets?status=all&limit=500"

Fetch only resolved markets

# active=false is equivalent to status=resolved
curl "https://app.kash.bot/api/markets?active=false&limit=100"

Slice the resolved archive by date

resolvedAfter/resolvedBefore are epoch seconds, applied to each market’s resolution time — handy for analysing a large resolved set without pulling it all at once.

curl "https://app.kash.bot/api/markets?active=false&resolvedAfter=1782345600&resolvedBefore=1782432000"

Get markets from a specific thread

curl "https://app.kash.bot/api/markets?threadId=abc123-def456"

Get markets for an organization

curl "https://app.kash.bot/api/markets?organizationId=550e8400-e29b-41d4-a716-446655440000"

To show only your organization’s markets on your own site, you can also use the dedicated GET /api/organizations/:id/markets endpoint, or drop in the organization iframe for a ready-made branded grid.

Get markets for a partner

curl "https://app.kash.bot/api/markets?partnerId=6ba7b810-9dad-11d1-80b4-00c04fd430c8"

Get markets in a specific chapter

curl "https://app.kash.bot/api/markets?chapterId=ch-group-stage"

Build a dynamic market feed

async function fetchMarketFeed() {
  // Get trending markets
  const trendingRes = await fetch('https://app.kash.bot/api/markets/trending?limit=5');
  const trending = await trendingRes.json();
  
  // Get featured markets
  const featuredRes = await fetch('https://app.kash.bot/api/markets/featured');
  const featured = await featuredRes.json();
  
  // Combine and dedupe
  const allMarkets = [...featured.markets, ...trending.markets];
  const uniqueMarkets = allMarkets.filter((m, i, arr) => 
    arr.findIndex(x => x.id === m.id) === i
  );
  
  return uniqueMarkets;
}

---

Related Endpoints

GET /api/organizations/:id/markets

List a single organization’s markets (scoped sub-resource)

Embedding Organization Iframes

Drop your markets onto your site with one iframe

GET /api/organizations/:id

Get organization metadata for filtering

GET /api/partners/:id

Get partner metadata for filtering

GET /api/threads/:id/chapters

List chapters to filter markets by

GET /api/threads

List all threads