> ## 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.

# Cotes d'un événement

> Cotes courantes, ou timeline complète avec `full_history=1`. Inclut les true odds (`todds*`), les scores live et les cartons.



## OpenAPI

````yaml /api-reference/openapi.json get /api/odds
openapi: 3.1.0
info:
  title: apinn — Pinnacle Data API
  version: 1.0.0
  description: Cotes Pinnacle en temps réel, format iso Pinnacle Data API.
servers:
  - url: https://api.apinn.io
security:
  - ApiKeyAuth: []
paths:
  /api/odds:
    get:
      summary: Cotes d'un événement
      description: >-
        Cotes courantes, ou timeline complète avec `full_history=1`. Inclut les
        true odds (`todds*`), les scores live et les cartons.
      parameters:
        - name: event_id
          in: query
          required: true
          schema:
            type: integer
          example: 1632003656
        - name: period
          in: query
          schema:
            type: integer
        - name: market
          in: query
          schema:
            type: string
            enum:
              - moneyline
              - spread
              - totals
              - home_totals
              - away_totals
        - name: line
          in: query
          schema:
            type: number
        - name: main_lines_only
          in: query
          description: 1 = uniquement la ligne principale de chaque marché.
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: full_history
          in: query
          description: 1 = timeline complète (tous les mouvements).
          schema:
            type: integer
            enum:
              - 0
              - 1
        - name: since
          in: query
          description: Timeline depuis cet horodatage ISO.
          schema:
            type: string
      responses:
        '200':
          description: Lignes de cotes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OddsRow'
              example:
                - event_id: 1632003656
                  period: 0
                  market: moneyline
                  line: null
                  odds1: 4.74
                  odds0: 3.16
                  odds2: 1.862
                  todds1: 5.245
                  todds0: 3.406
                  todds2: 1.939
                  line_id: 3654454547
                  alt_line_id: null
                  cutoff: '2026-08-22T18:45:00'
                  max_win: 500
                  score_home: null
                  score_away: null
                  red_cards_home: null
                  red_cards_away: null
                  status: 1
                  timestamp: '2026-07-16T02:15:57'
        '422':
          description: event_id requis
components:
  schemas:
    OddsRow:
      type: object
      properties:
        event_id:
          type: integer
        period:
          type: integer
        market:
          type: string
          enum:
            - moneyline
            - spread
            - totals
            - home_totals
            - away_totals
        line:
          type:
            - number
            - 'null'
        odds1:
          type:
            - number
            - 'null'
          description: Home / Over.
        odds0:
          type:
            - number
            - 'null'
          description: Draw (null sur les marchés 2‑way).
        odds2:
          type:
            - number
            - 'null'
          description: Away / Under.
        todds1:
          type:
            - number
            - 'null'
          description: True odds (devig) home/over.
        todds0:
          type:
            - number
            - 'null'
        todds2:
          type:
            - number
            - 'null'
        line_id:
          type: integer
          description: Identifiant entier stable de la ligne.
        alt_line_id:
          type:
            - integer
            - 'null'
          description: Non‑null si ligne alternative.
        cutoff:
          type:
            - string
            - 'null'
        max_win:
          type:
            - number
            - 'null'
          description: Mise max acceptée (liquidité).
        score_home:
          type:
            - integer
            - 'null'
          description: Score live domicile.
        score_away:
          type:
            - integer
            - 'null'
        red_cards_home:
          type:
            - integer
            - 'null'
        red_cards_away:
          type:
            - integer
            - 'null'
        status:
          type: integer
          description: 1 = ouvert, 2 = fermé/suspendu.
        timestamp:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````