GETGet Market by ID

Retrieve detailed information about a specific prediction market by its UUID. Returns the same data as Get Market by Slug but accepts a UUID instead of a slug. Includes outcomes, top traders, comments, and resolution details.

Request

GET /v1/markets/:id

Path Parameters

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "will-btc-hit-100k",
  "question": "Will BTC hit $100k by June 2026?",
  "description": "Resolves YES if Bitcoin (BTC) price reaches $100,000 USD on any major exchange before June 1, 2026.",
  "imageUrl": "https://...",
  "category": "CRYPTO",
  "type": "BINARY",
  "status": "ACTIVE",
  "spread": "0.02",
  "platformFee": "0.02",
  "totalVolume": "125000.00",
  "totalLiquidity": "45000.00",
  "views": 3200,
  "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,
  "resolvedBy": null,
  "resolutionSource": null,
  "resolutionNote": null,
  "winningOutcomeId": null,
  "winningOutcome": 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": "Bitcoin reaches $100k",
      "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": "Bitcoin does not reach $100k",
      "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"
    }
  ],
  "topTraders": [
    {
      "username": "alice",
      "profileImageUrl": "https://...",
      "volume": "50000.00"
    },
    {
      "username": "bob",
      "profileImageUrl": "https://...",
      "volume": "30000.00"
    }
  ],
  "comments": []
}

Note: The comments array is omitted above for brevity. Each comment contains id, userId, content, parentId, likesCount, isLiked, replyCount, createdAt, and a nested user object with id, username, and profileImageUrl.

Response Fields

Errors

Example

curl https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000