GET /api/threads/:id/markets

Get all prediction markets within a specific thread

Fetches all prediction markets that belong to a specific thread, with filtering, sorting, and pagination.

Endpoint

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

Path Parameters

id · string · required

The unique thread identifier (UUID format)

Query Parameters

status · string

Filter by market status. Options: active, resolved, cancelled, paused

limit · number · default: "20"

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. Options: created_at, total_volume, current_probability, title

sortOrder · string · default: "desc"

Sort direction. Options: asc, desc

Response

markets · array

Array of market objects in this thread

Show Market Object

id · string

Unique market identifier

question · string

The prediction market question

description · string

Market description with resolution criteria

currentProbability · number

Current market probability (0-1, e.g., 0.72 = 72%)

yesPrice · number

Current price for YES shares (0-1)

noPrice · number

Current price for NO shares (0-1)

totalVolume · number

Total trading volume for this market (in cents)

tradeCount · number

Number of trades executed

status · string

Market status: active, resolved, cancelled, paused

endTime · number

Market end time (Unix timestamp in milliseconds)

category · string

Market category

tags · array

Array of tag strings

createdAt · string

ISO 8601 timestamp of market creation

pagination · object

Pagination metadata

Show Pagination Properties

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/threads/abc123/markets?status=active&limit=10&sortBy=current_probability&sortOrder=desc"

Example Response

200 - Success

{
  "markets": [
    {
      "id": "market-1",
      "question": "Will Biden win the Democratic nomination?",
      "description": "This market resolves YES if Joe Biden is officially nominated as the Democratic Party candidate for the 2024 Presidential Election.",
      "currentProbability": 0.72,
      "yesPrice": 0.72,
      "noPrice": 0.28,
      "totalVolume": 125000,
      "tradeCount": 450,
      "status": "active",
      "endTime": 1735689600000,
      "category": "politics",
      "tags": ["biden", "nomination", "2024"],
      "createdAt": "2024-01-01T00:00:00Z"
    },
    {
      "id": "market-2",
      "question": "Will Trump run as independent candidate?",
      "description": "Resolves YES if Donald Trump announces an independent presidential campaign for 2024.",
      "currentProbability": 0.15,
      "yesPrice": 0.15,
      "noPrice": 0.85,
      "totalVolume": 89000,
      "tradeCount": 320,
      "status": "active",
      "endTime": 1735689600000,
      "category": "politics",
      "tags": ["trump", "independent", "2024"],
      "createdAt": "2024-01-02T00:00:00Z"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 12,
    "hasMore": true
  },
  "_meta": {
    "authenticated": false,
    "requestedAt": "2024-01-16T12:00:00Z"
  }
}

404 - Thread Not Found

{
  "error": "Thread not found",
  "message": "No thread exists with ID: abc123",
  "code": "THREAD_NOT_FOUND"
}

429 - Rate Limit Exceeded

{
  "error": "Too many requests",
  "message": "Rate limit of 100 requests per minute exceeded",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 45
}

Common Use Cases

Build a custom thread page

Fetch all markets to build a custom thread display:

async function buildThreadPage(threadId) {
  // Fetch thread details
  const threadResponse = await fetch(
    `https://app.kash.bot/api/threads/${threadId}`
  );
  const { thread } = await threadResponse.json();

  // Fetch all markets in thread
  const marketsResponse = await fetch(
    `https://app.kash.bot/api/threads/${threadId}/markets?limit=100`
  );
  const { markets } = await marketsResponse.json();

  return { thread, markets };
}

Show top markets by volume

Display the most actively traded markets in a thread:

const response = await fetch(
  `https://app.kash.bot/api/threads/${threadId}/markets?` +
  new URLSearchParams({
    status: 'active',
    sortBy: 'total_volume',
    sortOrder: 'desc',
    limit: 5
  })
);

const { markets } = await response.json();
console.log('Top 5 markets by volume:', markets);

Paginate through all markets

Fetch all markets in batches:

async function* fetchAllMarkets(threadId) {
  let offset = 0;
  let hasMore = true;

  while (hasMore) {
    const response = await fetch(
      `https://app.kash.bot/api/threads/${threadId}/markets?` +
      new URLSearchParams({ limit: 100, offset })
    );
    const data = await response.json();

    for (const market of data.markets) {
      yield market;
    }

    hasMore = data.pagination.hasMore;
    offset += 100;
  }
}

// Usage
for await (const market of fetchAllMarkets('abc123')) {
  console.log(market.question);
}

Filter active markets only

Show only currently active markets for trading:

const response = await fetch(
  `https://app.kash.bot/api/threads/${threadId}/markets?status=active`
);
const { markets } = await response.json();

// All markets are active and ready for trading
const activeMarkets = markets.filter(m => m.status === 'active');

Build a probability leaderboard

Show markets ranked by probability:

React Component

function MarketLeaderboard({ threadId }) {
  const [markets, setMarkets] = useState([]);

  useEffect(() => {
    fetch(
      `https://app.kash.bot/api/threads/${threadId}/markets?` +
      new URLSearchParams({
        status: 'active',
        sortBy: 'current_probability',
        sortOrder: 'desc',
        limit: 10
      })
    )
      .then(r => r.json())
      .then(data => setMarkets(data.markets));
  }, [threadId]);

  return (
    <div className="leaderboard">
      <h3>Most Likely Outcomes</h3>
      {markets.map(market => (
        <div key={market.id} className="market-row">
          <span className="question">{market.question}</span>
          <span className="probability">
            {(market.currentProbability * 100).toFixed(0)}%
          </span>
        </div>
      ))}
    </div>
  );
}

Related Endpoints

GET /api/threads

List all available threads

GET /api/threads/:id

Get thread details