> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Firehose odds (SSE)

> Flux Server-Sent Events : snapshot initial des cotes principales (avec true odds), puis deltas au format BIC à chaque changement. Plan Sharp requis. Clé via ?key= (EventSource ne permet pas de header).



## OpenAPI

````yaml /api-reference/openapi.json get /api/stream/odds
openapi: 3.1.0
info:
  title: apinn — API Pinnacle temps réel
  version: 1.0.0
  description: >-
    Cotes Pinnacle en temps réel : prématch et live, ouverture et clôture
    TrueLine multi-modèles, specials et outrights.
servers:
  - url: https://api.apinn.io
security:
  - ApiKeyAuth: []
paths:
  /api/stream/odds:
    get:
      tags: []
      summary: Firehose odds (SSE)
      description: >-
        Flux Server-Sent Events : snapshot initial des cotes principales (avec
        true odds), puis deltas au format BIC à chaque changement. Plan Sharp
        requis. Clé via ?key= (EventSource ne permet pas de header).
      parameters:
        - name: key
          in: query
          schema:
            type: string
          description: Clé API (alternative au header X-API-Key pour EventSource).
      responses:
        '200':
          description: 'Flux text/event-stream (events: snapshot, update).'
        '403':
          description: >-
            Plan insuffisant — endpoint réservé à un plan supérieur (Specials &
            streams : Sharp).
          content:
            application/json:
              example:
                detail: Endpoint réservé au plan Sharp (enterprise)
                your_plan: starter
                required_plan: enterprise
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````