> ## Documentation Index > Fetch the complete documentation index at: https://docs.therundown.io/llms.txt > Use this file to discover all available pages before exploring further. # Get available markets by date > Returns available market definitions for each sport on the given date. ## OpenAPI ````yaml get /api/v2/sports/markets/{date} openapi: 3.1.0 info: title: TheRundown Sports API version: 2.0.0 description: > Real-time and historical sports betting data, odds, lines, and statistics across major North American and international sports leagues. ## Authentication All endpoints (except `/sports` and `/affiliates`) require authentication. Pass your API key using one of: - **Query parameter**: `?key=YOUR_API_KEY` - **Header**: `X-Therundown-Key: YOUR_API_KEY` ## Off-the-Board Sentinel Value The value **0.0001** indicates a line is "off the board" — the sportsbook has temporarily removed pricing (e.g., pending injury news). This is NOT an error. Display as "Off Board" or "N/A" in your UI. ## Rate Limiting Requests are rate-limited per API key tier. Check response headers for current limits. ## Data Updates - Live odds update in real-time during games - Use delta endpoints for efficient polling of changes - WebSocket connections available for streaming updates ## V1 vs V2 V2 endpoints use market-based data structures (market_id, participants, line prices). V1 endpoints use legacy line-based structures (moneyline, spread, total objects). V2 is recommended for new integrations. contact: name: TheRundown API Support url: https://therundown.io email: support@therundown.io termsOfService: https://therundown.io/terms servers: - url: https://therundown.io description: Production security: - ApiKeyQuery: [] - ApiKeyHeader: [] tags: - name: V2 Sports description: Sport listings, dates, and teams (V2) - name: V2 Events description: Events with market-based odds (V2) - name: V2 Markets description: Market definitions, odds, deltas, and history (V2) - name: V2 Teams description: Team data, players, and stats (V2) - name: V2 Players description: Player data (V2) - name: V2 Stats description: Team and player statistics (V2) - name: V2 WebSocket description: Real-time streaming via WebSocket (V2) - name: V2 Reference description: Reference data — affiliates, sportsbooks, season types (V2) - name: V1 Events description: Events with line-based odds (V1 legacy) - name: V1 Lines description: Moneyline, spread, total, best-line endpoints (V1 legacy) - name: V1 Sports description: Sport listings, dates, events, schedules (V1 legacy) - name: V1 Delta description: Delta/change feeds (V1 legacy) - name: V1 Reference description: Reference data (V1 legacy) - name: V1 WebSocket description: Real-time streaming via WebSocket (V1 legacy) paths: /api/v2/sports/markets/{date}: get: tags: - V2 Sports summary: Get available markets by date description: Returns available market definitions for each sport on the given date. operationId: v2GetMarketsByDate parameters: - name: date in: path required: true schema: type: string format: date - name: hide_closed_markets in: query schema: type: string enum: - '1' description: Set to `1` to hide closed markets - $ref: '#/components/parameters/OffsetQuery' responses: '200': description: Markets keyed by sport ID content: application/json: schema: type: object additionalProperties: type: array items: $ref: '#/components/schemas/Market' example: '4': - id: 1 name: moneyline line_value_is_participant: true proposition: true description: 'Moneyline: To win outright' short_description: Moneyline period_id: 0 live_variant_id: 41 updated_at: '2026-01-23T20:38:12Z' - id: 2 name: handicap line_value_is_participant: false proposition: true description: 'Spread: Win or lose by margin of points' short_description: Spread period_id: 0 live_variant_id: 42 updated_at: '2026-01-23T20:42:13Z' - id: 3 name: totals line_value_is_participant: false proposition: true description: 'Totals: Total points' short_description: Totals period_id: 0 live_variant_id: 43 updated_at: '2026-01-23T20:38:12Z' components: parameters: OffsetQuery: name: offset in: query schema: type: integer default: 0 example: 300 description: >- UTC offset in **minutes** for the date boundary. Use `300` for US Central, `240` for Eastern, `360` for Mountain, `420` for Pacific. Without this, the API day boundary is midnight UTC. schemas: Market: type: object description: > Market definition. The `line_value_is_participant` flag indicates whether the market is participant-shaped (`true`) or whether the line value should be surfaced as the meaningful handicap, total, method, round, or threshold (`false`). properties: id: type: integer example: 1 name: type: string example: Money Line description: type: string short_description: type: string line_value_is_participant: type: boolean description: >- If true, the selection is carried by the participant and line values may be placeholders or labels. If false, the line value is meaningful and should be displayed when present. proposition: type: boolean description: Whether this is a proposition/prop market period_id: type: integer nullable: true description: > Associated period. 0=Full Game, 1=1st Half, 2=2nd Half, 3-6=Quarters/periods, 7=Live Full Game, 13-18=Live periods. For tennis, 3/4 represent prematch Set 1/Set 2 and 15/16 represent live Set 1/Set 2. live_variant_id: type: integer nullable: true description: ID of the live/in-play variant of this market updated_at: type: string format: date-time securitySchemes: ApiKeyQuery: type: apiKey in: query name: key description: API key as query parameter ApiKeyHeader: type: apiKey in: header name: X-Therundown-Key description: API key as request header ````