> ## Documentation Index > Fetch the complete documentation index at: https://docs.testnet.dev.adipredictstreet.com/llms.txt > Use this file to discover all available pages before exploring further. # List markets > Returns all non-draft markets (OPEN / PAUSED / PROPOSED / PRE_MARKET). Capped 500 rows. ## OpenAPI ````yaml /api-reference/openapi.json get /api/markets openapi: 3.1.0 info: title: PredictStreet core-api description: >- Client-facing HTTP gateway for the PredictStreet prediction-market platform. This spec is hand-written against the NestJS controllers and DTOs in core-api/src/modules/. For the source-of-truth live spec, run `./scripts/pull-openapi.sh` against a running core-api (NestJS exposes it at /api/docs-json). **Partner kinds.** Every authenticated endpoint resolves a request's *effective wallet* from the partner row. `single_wallet` partners bind to one `associatedWallet` set at creation. `multi_wallet` partners declare the actor on every request via an `X-User-Wallet: 0x<40-hex>` header. See the [Partner kinds](/auth/api-keys#partner-kinds) doc for the full contract. version: '2026-06-16' contact: name: PredictStreet partners email: partners@predictstreet.com servers: - url: https://core.api.dev.predictstreet.sde.adifoundation.ai description: Testnet (partner integrator API — final domain TBD) security: [] tags: - name: Deposits description: >- Gasless USDC deposit relay - submit a signed EIP-2612 permit and the platform broadcasts the on-chain deposit for you (no gas). - name: Events description: >- Polymarket-style event grouping with football metadata (group, stage, teams, tags). - name: Tags description: Curated tag taxonomy used to filter events. - name: Markets description: 'Public market data: list, detail, orderbook, trades, OHLC.' - name: Orders description: >- Signed-order place / cancel / read. Requires `X-Api-Key` with `orders:read` / `orders:write` scope; every write additionally requires an EIP-712 signature over the order. - name: Portfolio description: >- Balances, positions, trades, fees, vault info for the key's `associatedWallet`. Requires `X-Api-Key` with `portfolio:read` scope. - name: Matches description: >- admin.matches aggregate — groups several events into one fixture/card (1X2 + first-scorer + over-under under one matchup). - name: Vault description: >- Backend co-signatures for ERC-1155 split / merge, and recovery for off-chain locks when the corresponding chain tx never confirmed. Requires `X-Api-Key` with `vault:write` scope plus an EIP-712 signature over the operation. - name: Leaderboard description: Public ranked leaderboard across PnL / volume buckets. - name: Search description: Global search across users, events, and matches. - name: Withdrawal Security description: >- Self-service withdrawal 2FA (TOTP) and withdrawal-address whitelist. Same endpoints serve the frontend (Privy JWT) and API-key integrators. Mutations need `vault:write`, reads `portfolio:read`. Both are opt-in per wallet and only gate withdrawals once the platform enables withdrawal-security enforcement. paths: /api/markets: get: tags: - Markets summary: List markets description: >- Returns all non-draft markets (OPEN / PAUSED / PROPOSED / PRE_MARKET). Capped 500 rows. operationId: MarketsController_list parameters: - name: limit required: false in: query schema: type: integer minimum: 1 maximum: 500 - name: sort required: false in: query description: >- kickoff (default) — earliest first. activity — most-traded first. shares — biggest turnover first. schema: enum: - kickoff - activity - shares type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/MarketsListRespDto' type: object properties: markets: type: array items: $ref: '#/components/schemas/MarketSummary' security: - {} components: schemas: MarketsListRespDto: type: object properties: markets: type: array items: $ref: '#/components/schemas/MarketSummaryDto' required: - markets MarketSummaryDto: type: object properties: id: type: string description: Internal market UUID. eventId: type: string description: Parent event UUID. symbol: type: string description: Public market symbol. example: KOR-CZE-WINNER title: type: string description: Display title. groupItemTitle: type: object nullable: true description: Per-outcome accordion sub-title. conditionId: type: object nullable: true description: CTF conditionId, 0x-bytes32. questionId: type: object nullable: true description: CTF questionId, 0x-bytes32. yesTokenId: type: object nullable: true description: YES outcome ERC-1155 tokenId (uint256 dec-string). noTokenId: type: object nullable: true description: NO outcome ERC-1155 tokenId (uint256 dec-string). outcomeCount: type: number description: Number of outcomes (2 for binary, N for N-ary). outcomeLabels: description: Outcome labels in index order. example: - 'YES' - 'NO' type: array items: type: string initialOutcomePrices: description: >- Initial fair-value prices per outcome (decimal string), used as fallback. type: array items: type: string outcomePrices: type: array items: type: string nullable: true description: >- Live or fallback prices per outcome (decimal string). null when no price available. status: type: string description: >- Lifecycle status. Public list returns OPEN/PAUSED/PROPOSED only; `/markets/:symbol` additionally allows SUSPENDED/CLOSED/PENDING_RESOLUTION/DELAYED/DISPUTED/RESOLVED/VOIDED/CANCELLED for historical lookups. currentReviewRound: type: number description: Current resolution review round (≥1). initialFairValue: type: string description: Admin-set fair value at market creation (decimal string). feeTakerBps: type: object nullable: true description: >- Per-market taker fee in basis points; null falls back to platform default. opensAt: type: object nullable: true description: ISO-8601 — when trading opens. closesAt: type: object nullable: true description: ISO-8601 — when trading closes. kickoff: type: object nullable: true description: ISO-8601 — kickoff/event-start anchor. resolutionWindowHours: type: object nullable: true description: Resolution window in hours after kickoff. pausedAt: type: object nullable: true description: ISO-8601 — when admin paused trading. resolvedAt: type: object nullable: true description: ISO-8601 — when oracle resolved the market. payoutNumerators: type: object nullable: true description: Per-outcome payout numerators after resolution. officialDataSource: type: object nullable: true description: Source feed identifier (Sportradar, etc.). sourceMatchId: type: object nullable: true description: External fixture id from the source feed. resolutionCriteria: type: object nullable: true description: Free-text resolution criteria. negRiskEligible: type: boolean description: True for NegRisk-eligible N-ary markets. isNewMarketType: type: boolean description: Reserved flag for the v2 market schema. createdAt: type: string description: ISO-8601 creation time. updatedAt: type: string description: ISO-8601 last update. tradeCount: type: number description: >- Lifetime non-terminal trade count for this market (only on /markets list). totalShares: type: string description: >- Lifetime sum of trade quantities (decimal string, only on /markets list). required: - id - eventId - symbol - title - outcomeCount - outcomeLabels - initialOutcomePrices - outcomePrices - status - currentReviewRound - initialFairValue - negRiskEligible - isNewMarketType - createdAt - updatedAt ````