> ## Documentation Index > Fetch the complete documentation index at: https://docs.dotprediction.com/llms.txt > Use this file to discover all available pages before exploring further. # Get market by ID > Returns detailed information about a specific market by its ID. ## OpenAPI ````yaml GET /v1/api/markets/id/{id} openapi: 3.1.0 info: title: Dot Prediction API description: >- A unified API for accessing prediction market data across Kalshi, Polymarket, and Limitless. version: 1.0.0 servers: - url: https://api.dotprediction.io security: - apiKey: [] paths: /v1/api/markets/id/{id}: get: tags: - Markets summary: Get market by ID description: Returns detailed information about a specific market by its ID. operationId: getMarket parameters: - name: id in: path required: true description: The market ID (platform-specific identifier). schema: type: string - name: provider in: query required: true description: The prediction market platform to query. schema: type: string enum: - kalshi - polymarket - limitless - name: include_raw in: query required: false description: Include the raw provider response. schema: type: string enum: - 'true' - 'false' responses: '200': description: Market details. content: application/json: schema: $ref: '#/components/schemas/GetMarketResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' components: schemas: GetMarketResponse: type: object properties: pagination: $ref: '#/components/schemas/Pagination' markets: type: array items: $ref: '#/components/schemas/Market' meta: $ref: '#/components/schemas/Meta' Pagination: type: object properties: total: type: integer description: Total number of results. limit: type: integer description: Number of results per page. has_more: type: boolean description: Whether more results are available. next_cursor: type: string nullable: true description: Cursor to use for the next page. `null` if no more results. Market: type: object properties: id: type: string description: Unified market identifier. platform: type: string description: Source platform (kalshi, polymarket, limitless). platform_id: type: string description: Platform-specific market identifier. title: type: string description: Market title. status: type: string description: Market status (e.g., open, closed, settled). market_type: type: string description: Type of market (e.g., binary, multiple choice). outcomes: type: array items: $ref: '#/components/schemas/Outcome' description: Available outcomes for the market. current_prices: type: object additionalProperties: true description: Current prices for each outcome. last_synced_at: type: string description: When this market data was last synced. event_id: type: string description: Parent event ID. event_name: type: string description: Parent event name. series_id: type: string description: Parent series ID. slug: type: string description: URL-friendly slug. description: type: string description: Market description. category: type: string description: Market category. subcategory: type: string nullable: true description: Market subcategory. tags: type: array items: type: string description: Tags associated with the market. volume_24h: type: number nullable: true description: Trading volume in the last 24 hours. volume_7d: type: number nullable: true description: Trading volume in the last 7 days. volume_total: type: number nullable: true description: Total lifetime trading volume. liquidity: type: number description: Current liquidity. liquidity_score: type: number description: Computed liquidity score. open_interest: type: number nullable: true description: Total open interest. unique_traders: type: integer nullable: true description: Number of unique traders. source_url: type: string description: URL to the market on the source platform. image_url: type: string description: Market image URL. created_at: type: string description: When the market was created. trading_start_at: type: string description: When trading opens. trading_end_at: type: string description: When trading closes. resolution_date: type: string description: Expected resolution date. resolved_at: type: string nullable: true description: When the market was resolved. resolution_criteria: type: string description: Criteria for market resolution. resolution_source: type: string description: Source used for resolution. price_24h_changes: type: object additionalProperties: true description: Price changes over the last 24 hours by outcome. price_7d_changes: type: object additionalProperties: true description: Price changes over the last 7 days by outcome. metadata: type: object additionalProperties: true description: Platform-specific metadata. Meta: type: object properties: platforms_queried: type: array items: type: string description: Platforms that were queried. request_time: type: integer description: Request processing time in milliseconds. cache_hit: type: boolean description: Whether the response was served from cache. data_freshness: type: string description: Timestamp indicating when the data was last refreshed. ErrorResponse: type: object properties: error: type: object properties: status: type: integer description: HTTP status code. message: type: string description: Human-readable error message. resolution: type: string description: Suggested action to resolve the error. error_text: type: string description: Detailed error information. Outcome: type: object properties: id: type: string description: Outcome identifier. name: type: string description: Outcome name (e.g., "Yes", "No"). responses: BadRequest: description: Invalid request parameters. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Missing or invalid API key. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimited: description: Rate limit exceeded. Check the `Retry-After` header. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: >- API key for authentication. Generate one via the dashboard or the `/v1/api/auth/api-keys` endpoint. ````