GET市场列表

检索预测市场的分页列表，支持可选的筛选和排序。

请求

GET /v1/markets

查询参数

参数	类型	必填	默认值	描述
`status`	string	否	`ACTIVE`	按状态筛选：`ACTIVE`、`RESOLVED`、`CANCELLED`
`category`	string	否	—	按类别筛选：`CRYPTO`、`SPORTS`、`POLITICS`、`FINANCE`、`ENTERTAINMENT`、`SCIENCE`、`OTHER`
`q`	string	否	—	市场问题搜索关键词
`sortBy`	string	否	`CREATED`	排序字段：`VOLUME`、`LIQUIDITY`、`CREATED`、`TRENDING`、`ENDING`
`sortOrder`	string	否	`DESC`	排序方式：`ASC`、`DESC`
`limit`	number	否	`20`	每页结果数（1-100）
`offset`	number	否	`0`	跳过的结果数

响应

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

示例

获取所有活跃市场

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

搜索加密货币市场

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

分页获取结果

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