Fetches a paginated list of threads belonging to a specific organization. Supports status filtering and sorting.
Endpoint
GET https://app.kash.bot/api/organizations/:id/threads
Path Parameters
The unique organization identifier (UUID format)
Query Parameters
Filter by thread status: active, upcoming, closed, all
Maximum number of results per page (max: 100)
Pagination offset for fetching subsequent pages
sortBy
string
default:"created_at"
Field to sort by: created_at, start_time, total_volume
Sort direction: asc, desc
Response
Array of thread objects
Thread description (nullable)
Cover image URL (nullable)
ISO 8601 start time (nullable)
ISO 8601 end time (nullable)
Number of markets in this thread (nullable)
Total trading volume as a numeric string (nullable)
Number of unique participants (nullable)
ISO 8601 timestamp of thread creation
Pagination metadata
Total number of matching threads
Whether more results are available
Request metadata
The organization ID that was queried
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/threads?status=active&sortBy=total_volume&sortOrder=desc&limit=10"
Example Response
{
"threads": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"title": "2026 World Cup Predictions",
"description": "Predict match outcomes for the 2026 FIFA World Cup",
"image": "https://cdn.kash.bot/threads/world-cup-2026.jpg",
"status": "active",
"startTime": "2026-06-11T00:00:00Z",
"endTime": "2026-07-19T00:00:00Z",
"marketCount": 48,
"totalVolume": "5600000",
"participantCount": 1250,
"createdAt": "2026-01-15T00:00:00Z"
}
],
"pagination": {
"offset": 0,
"limit": 10,
"total": 5,
"hasMore": false
},
"_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"
}
Common Use Cases
Build an organization landing page
async function buildOrgPage(orgId) {
const [orgRes, threadsRes] = await Promise.all([
fetch(`https://app.kash.bot/api/organizations/${orgId}`),
fetch(`https://app.kash.bot/api/organizations/${orgId}/threads?status=active&sortBy=total_volume&sortOrder=desc`),
]);
const { organization } = await orgRes.json();
const { threads } = await threadsRes.json();
return { organization, threads };
}
