GETGet Market by Slug

Retrieve detailed information about a specific prediction market including outcomes, probabilities, top traders, and comments.

Request

GET /v1/markets/slug/:slug

Path Parameters

Parameter	Type	Required	Description
`slug`	string	Yes	Market URL slug (e.g., `will-btc-hit-100k`)

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",
  "totalVolume": "125000.00",
  "totalLiquidity": "45000.00",
  "platformFee": "0.02",
  "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,
  "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"
    }
  ],
  "comments": [
    {
      "id": "comment-uuid-1",
      "userId": "user-uuid-1",
      "content": "Bullish on this one.",
      "parentId": null,
      "likesCount": 5,
      "replyCount": 2,
      "createdAt": "2026-02-20T10:30:00Z",
      "user": {
        "id": "user-uuid-1",
        "username": "alice",
        "profileImageUrl": "https://..."
      }
    }
  ],
  "winningOutcome": null
}

Response Fields

Field	Type	Description
`id`	string	Unique market identifier
`slug`	string	URL-friendly market identifier
`question`	string	Market question
`description`	string	Detailed market description and resolution criteria
`imageUrl`	string	Market image URL
`category`	string	Market category
`type`	string	`BINARY` or `MULTI`
`status`	string	Current market status
`spread`	string	Market spread
`totalVolume`	string	Total trading volume in USDC
`totalLiquidity`	string	Total liquidity in USDC
`platformFee`	string	Platform fee rate
`views`	number	Total view count
`featured`	boolean	Whether the market is featured
`verified`	boolean	Whether the market is verified
`tags`	array	List of tags
`tradingStartsAt`	string	Trading start time (ISO 8601)
`tradingEndsAt`	string	Trading end time (ISO 8601)
`resolutionDate`	string	Expected resolution date (ISO 8601)
`resolvedAt`	string\|null	Actual resolution timestamp
`resolvedBy`	string\|null	Resolver identifier
`resolutionSource`	string\|null	Resolution source URL or description
`resolutionNote`	string\|null	Resolution note
`winningOutcomeId`	string\|null	ID of the winning outcome
`createdAt`	string	Creation timestamp (ISO 8601)
`updatedAt`	string	Last update timestamp (ISO 8601)
`outcomes`	array	List of possible outcomes
`outcomes[].id`	string	Outcome identifier
`outcomes[].marketId`	string	Parent market ID
`outcomes[].name`	string	Outcome name
`outcomes[].index`	number	Outcome display index
`outcomes[].side`	string	Outcome side (e.g., `YES`, `NO`)
`outcomes[].description`	string	Outcome description
`outcomes[].probability`	string	Current probability (0-1)
`outcomes[].questionId`	string	Associated question ID
`outcomes[].conditionId`	string	Associated condition ID
`outcomes[].positionId`	string	Associated position ID
`outcomes[].createdAt`	string	Creation timestamp (ISO 8601)
`outcomes[].updatedAt`	string	Last update timestamp (ISO 8601)
`topTraders`	array	Top traders by volume
`topTraders[].username`	string	Trader username
`topTraders[].profileImageUrl`	string	Trader profile image URL
`topTraders[].volume`	string	Trader volume in USDC
`comments`	array	Market comments
`comments[].id`	string	Comment identifier
`comments[].userId`	string	Comment author user ID
`comments[].content`	string	Comment text
`comments[].parentId`	string\|null	Parent comment ID for replies
`comments[].likesCount`	number	Number of likes
`comments[].replyCount`	number	Number of replies
`comments[].createdAt`	string	Comment timestamp (ISO 8601)
`comments[].user`	object	Comment author details
`comments[].user.id`	string	Author user ID
`comments[].user.username`	string	Author username
`comments[].user.profileImageUrl`	string	Author profile image URL
`winningOutcome`	object\|null	Full winning outcome object, or null if unresolved

Errors

Status	Description
`404`	Market not found

Example

curl https://api.conviction.bet/v1/markets/slug/will-btc-hit-100k