마켓 목록 조회

GET/v1/marketsPublic

예측 시장의 페이지네이션된 목록을 조회합니다. 필터링과 정렬을 선택적으로 사용할 수 있습니다.

#쿼리 파라미터

파라미터	타입	필수	기본값	설명
`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"

이 페이지가 도움이 되었나요?