GET通过 Slug 获取市场

检索特定预测市场的详细信息,包括所有结果及其概率、热门交易者和评论。

请求

GET /v1/markets/slug/:slug

路径参数

参数类型必填描述
slugstring市场 URL slug(例如 will-btc-hit-100k

响应

{
  "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...",
  "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
}

响应字段

字段类型描述
idstring唯一市场标识符
slugstringURL 友好的市场标识符
questionstring市场问题
descriptionstring详细市场描述和解决标准
imageUrlstring市场图片 URL
categorystring市场分类
typestringBINARYMULTI
statusstring当前市场状态
spreadstring市场价差
totalVolumestringUSDC 总交易量
totalLiquiditystringUSDC 总流动性
platformFeestring平台手续费率
viewsnumber总浏览次数
featuredboolean是否为精选市场
verifiedboolean是否已验证
tagsarray标签列表
tradingStartsAtstring交易开始时间(ISO 8601)
tradingEndsAtstring交易结束时间(ISO 8601)
resolutionDatestring预计解决日期(ISO 8601)
resolvedAtstring|null实际解决时间戳
resolvedBystring|null解决者标识
resolutionSourcestring|null解决来源 URL 或描述
resolutionNotestring|null解决备注
winningOutcomeIdstring|null获胜结果 ID
createdAtstring创建时间戳(ISO 8601)
updatedAtstring最后更新时间戳(ISO 8601)
outcomesarray可能结果列表
outcomes[].idstring结果标识符
outcomes[].marketIdstring所属市场 ID
outcomes[].namestring结果名称
outcomes[].indexnumber结果显示顺序
outcomes[].sidestring结果方向(如 YESNO
outcomes[].descriptionstring结果描述
outcomes[].probabilitystring当前概率(0-1)
outcomes[].questionIdstring关联问题 ID
outcomes[].conditionIdstring关联条件 ID
outcomes[].positionIdstring关联仓位 ID
outcomes[].createdAtstring创建时间戳(ISO 8601)
outcomes[].updatedAtstring最后更新时间戳(ISO 8601)
topTradersarray按交易量排名的热门交易者
topTraders[].usernamestring交易者用户名
topTraders[].profileImageUrlstring交易者头像 URL
topTraders[].volumestring交易者 USDC 交易量
commentsarray市场评论
comments[].idstring评论标识符
comments[].userIdstring评论作者用户 ID
comments[].contentstring评论内容
comments[].parentIdstring|null父评论 ID(用于回复)
comments[].likesCountnumber点赞数
comments[].replyCountnumber回复数
comments[].createdAtstring评论时间戳(ISO 8601)
comments[].userobject评论作者信息
comments[].user.idstring作者用户 ID
comments[].user.usernamestring作者用户名
comments[].user.profileImageUrlstring作者头像 URL
winningOutcomeobject|null完整的获胜结果对象,未解决时为 null

错误

状态码描述
404未找到市场

示例

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