Docs | Kash

Fetches a paginated list of markets belonging to a specific organization. This is a convenience sub-resource — it returns exactly the same results as GET /api/markets?organizationId=:id, scoped to a single organization so you only ever get back that organization’s markets.

Endpoint

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

Path Parameters

string

required

The unique organization identifier (UUID format)

Query Parameters

string

default:"active"

Filter by market status: active, resolved, cancelled, paused, refunded, all

string

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

number

default:"50"

Maximum number of results per page (max: 100)

number

default:"0"

Pagination offset for fetching subsequent pages

string

default:"created_at"

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

string

default:"desc"

Sort direction: asc, desc

Response

array

Array of market objects (same shape as GET /api/markets)

Show Market Object

string

Unique market identifier

string

Market question

number

Current YES probability (0-1)

number

Total trading volume in cents

string

Market status

number

Market end time (Unix timestamp in milliseconds)

string

Market category

string

ISO 8601 timestamp of market creation

object

Pagination metadata

Show Pagination Object

number

Current offset

number

Results per page

number

Total number of matching markets

boolean

Whether more results are available

object

Request metadata

Show Metadata Properties

string

The organization ID that was queried

string

ISO 8601 timestamp of request processing

Rate Limit

100 requests per minute per IP address

Example Request

curl "https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000/markets?status=active&sortBy=total_volume&sortOrder=desc&limit=10"

const response = await fetch(
  'https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000/markets?' +
  new URLSearchParams({
    status: 'active',
    sortBy: 'total_volume',
    sortOrder: 'desc',
    limit: 10
  })
);
const data = await response.json();
console.log(`Found ${data.markets.length} markets`);

import requests

response = requests.get(
    'https://app.kash.bot/api/organizations/550e8400-e29b-41d4-a716-446655440000/markets',
    params={
        'status': 'active',
        'sortBy': 'total_volume',
        'sortOrder': 'desc',
        'limit': 10
    }
)
data = response.json()
print(f"Found {len(data['markets'])} markets")

Example Response

200 - Success

{
  "markets": [
    {
      "id": "market-abc123",
      "question": "Will BTC hit $100k by end of 2025?",
      "probability": 0.72,
      "totalVolume": 1250000,
      "status": "OPEN",
      "endTime": 1735689600000,
      "category": "crypto",
      "createdAt": "2025-01-01T00:00:00Z"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 24,
    "hasMore": true
  },
  "_meta": {
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "requestedAt": "2026-03-04T12:00:00Z"
  }
}

404 - Organization Not Found

{
  "error": "Organization not found",
  "message": "No organization exists with ID: 550e8400-e29b-41d4-a716-446655440000",
  "code": "NOT_FOUND"
}

Showing only your organization’s markets

Because the organization is fixed by the path, every market returned belongs to that organization — there is no way for another organization’s markets to appear in the response. This is the recommended endpoint for powering an “our markets” feed on your own website. If you prefer the flat endpoint, the equivalent call is:

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

Embedding Organization Iframes

Drop your markets onto your site with a single iframe

GET /api/organizations/:id

Get organization metadata (name, logo, branding)

GET /api/markets

List all markets with the equivalent organizationId filter

GET /api/markets/:id/twitter-link

Generate a Twitter deep link to post & trade a market

GET /api/organizations/:id

GET /api/organizations/:id/partners

Overview

REST API

Webhooks

TypeScript SDK

CLI

Protocol SDK (TypeScript)

Protocol SDK (Python)

API Error Catalogue

Public Embed API

Embed — Organization Endpoints

Embed — Partner Endpoints

Embed — Thread Endpoints

Embed — Market Endpoints

Embed — Twitter Deep Links

Embed — Guides

Embed — Code Examples

GET /api/organizations/:id/markets

Endpoint

Path Parameters

Query Parameters

Response

Rate Limit

Example Request

Example Response

Showing only your organization’s markets

Embedding Organization Iframes

GET /api/organizations/:id

GET /api/markets

GET /api/markets/:id/twitter-link

​Endpoint

​Path Parameters

​Query Parameters

​Response

​Rate Limit

​Example Request

​Example Response

​Showing only your organization’s markets

​Related Endpoints

Embedding Organization Iframes

GET /api/organizations/:id

GET /api/markets

GET /api/markets/:id/twitter-link

Endpoint

Path Parameters

Query Parameters

Response

Rate Limit

Example Request

Example Response

Showing only your organization’s markets

Related Endpoints