GETList Markets

Retrieve a paginated list of prediction markets with optional filtering and sorting.

Request

GET /v1/markets

Query Parameters

Parameter	Type	Required	Default	Description
`status`	string	No	`ACTIVE`	Filter by status: `ACTIVE`, `RESOLVED`, `CANCELLED`
`category`	string	No	—	Filter by category: `CRYPTO`, `SPORTS`, `POLITICS`, `FINANCE`, `ENTERTAINMENT`, `SCIENCE`, `OTHER`
`q`	string	No	—	Search query for market question
`sortBy`	string	No	`CREATED`	Sort field: `VOLUME`, `LIQUIDITY`, `CREATED`, `TRENDING`, `ENDING`
`sortOrder`	string	No	`DESC`	Sort order: `ASC`, `DESC`
`limit`	number	No	`20`	Results per page (1-100)
`offset`	number	No	`0`	Number of results to skip

Response

{
  "markets": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "will-btc-hit-100k",
      "question": "Will BTC hit $100k by June 2026?",
      "description": "Resolves YES if Bitcoin price reaches...",
      "imageUrl": "https://...",
      "category": "CRYPTO",
      "type": "BINARY",
      "status": "ACTIVE",
      "spread": "1",
      "totalVolume": "125000.00",
      "platformFee": "0.02",
      "views": 0,
      "featured": true,
      "verified": true,
      "tags": ["bitcoin", "crypto"],
      "tradingStartsAt": "2026-01-15T00:00:00Z",
      "tradingEndsAt": "2026-06-01T00:00:00Z",
      "resolutionDate": "2026-06-01T00:00:00Z",
      "resolvedAt": null,
      "winningOutcomeId": null,
      "createdAt": "2026-01-15T00:00:00Z",
      "updatedAt": "2026-03-10T12:00:00Z",
      "outcomes": [
        {
          "id": "outcome-uuid-1",
          "marketId": "550e8400-e29b-41d4-a716-446655440000",
          "name": "Yes",
          "index": 0,
          "side": "YES",
          "description": null,
          "probability": "0.67",
          "questionId": "question-uuid-1",
          "conditionId": "condition-uuid-1",
          "positionId": "position-uuid-1",
          "createdAt": "2026-01-15T00:00:00Z",
          "updatedAt": "2026-03-10T12:00:00Z"
        },
        {
          "id": "outcome-uuid-2",
          "marketId": "550e8400-e29b-41d4-a716-446655440000",
          "name": "No",
          "index": 1,
          "side": "NO",
          "description": null,
          "probability": "0.33",
          "questionId": "question-uuid-1",
          "conditionId": "condition-uuid-1",
          "positionId": "position-uuid-2",
          "createdAt": "2026-01-15T00:00:00Z",
          "updatedAt": "2026-03-10T12:00:00Z"
        }
      ],
      "winningOutcome": null
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

Examples

Get all active markets

curl https://api.conviction.bet/v1/markets

Search for crypto markets

curl "https://api.conviction.bet/v1/markets?category=CRYPTO&sortBy=VOLUME&sortOrder=DESC"

Paginate results

curl "https://api.conviction.bet/v1/markets?limit=10&offset=10"