GET通过 Slug 获取市场
检索特定预测市场的详细信息,包括所有结果及其概率、热门交易者和评论。
请求
GET /v1/markets/slug/:slug
路径参数
| 参数 | 类型 | 必填 | 描述 |
|---|
slug | string | 是 | 市场 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
}
响应字段
| 字段 | 类型 | 描述 |
|---|
id | string | 唯一市场标识符 |
slug | string | URL 友好的市场标识符 |
question | string | 市场问题 |
description | string | 详细市场描述和解决标准 |
imageUrl | string | 市场图片 URL |
category | string | 市场分类 |
type | string | BINARY 或 MULTI |
status | string | 当前市场状态 |
spread | string | 市场价差 |
totalVolume | string | USDC 总交易量 |
totalLiquidity | string | USDC 总流动性 |
platformFee | string | 平台手续费率 |
views | number | 总浏览次数 |
featured | boolean | 是否为精选市场 |
verified | boolean | 是否已验证 |
tags | array | 标签列表 |
tradingStartsAt | string | 交易开始时间(ISO 8601) |
tradingEndsAt | string | 交易结束时间(ISO 8601) |
resolutionDate | string | 预计解决日期(ISO 8601) |
resolvedAt | string|null | 实际解决时间戳 |
resolvedBy | string|null | 解决者标识 |
resolutionSource | string|null | 解决来源 URL 或描述 |
resolutionNote | string|null | 解决备注 |
winningOutcomeId | string|null | 获胜结果 ID |
createdAt | string | 创建时间戳(ISO 8601) |
updatedAt | string | 最后更新时间戳(ISO 8601) |
outcomes | array | 可能结果列表 |
outcomes[].id | string | 结果标识符 |
outcomes[].marketId | string | 所属市场 ID |
outcomes[].name | string | 结果名称 |
outcomes[].index | number | 结果显示顺序 |
outcomes[].side | string | 结果方向(如 YES、NO) |
outcomes[].description | string | 结果描述 |
outcomes[].probability | string | 当前概率(0-1) |
outcomes[].questionId | string | 关联问题 ID |
outcomes[].conditionId | string | 关联条件 ID |
outcomes[].positionId | string | 关联仓位 ID |
outcomes[].createdAt | string | 创建时间戳(ISO 8601) |
outcomes[].updatedAt | string | 最后更新时间戳(ISO 8601) |
topTraders | array | 按交易量排名的热门交易者 |
topTraders[].username | string | 交易者用户名 |
topTraders[].profileImageUrl | string | 交易者头像 URL |
topTraders[].volume | string | 交易者 USDC 交易量 |
comments | array | 市场评论 |
comments[].id | string | 评论标识符 |
comments[].userId | string | 评论作者用户 ID |
comments[].content | string | 评论内容 |
comments[].parentId | string|null | 父评论 ID(用于回复) |
comments[].likesCount | number | 点赞数 |
comments[].replyCount | number | 回复数 |
comments[].createdAt | string | 评论时间戳(ISO 8601) |
comments[].user | object | 评论作者信息 |
comments[].user.id | string | 作者用户 ID |
comments[].user.username | string | 作者用户名 |
comments[].user.profileImageUrl | string | 作者头像 URL |
winningOutcome | object|null | 完整的获胜结果对象,未解决时为 null |
错误
示例
curl https://api.conviction.bet/v1/markets/slug/will-btc-hit-100k