Skip to main content
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

​
id
string
required
The unique organization identifier (UUID format)

​
Query Parameters

​
status
string
default:"active"
Filter by market status: active, resolved, cancelled, paused, refunded, all
​
category
string
Filter by category (e.g., politics, crypto, sports)
​
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 (same shape as GET /api/markets)
​
pagination
object
Pagination metadata
​
_meta
object
Request metadata

​
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"

​
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