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

# Look up a game from a platform id

> Maps an id that a platform uses (for Polymarket: the event slug, main or child event) to our game id. Useful for migrating an integration that is keyed by platform ids.



## OpenAPI

````yaml GET /api/v1/games/lookup
openapi: 3.1.0
info:
  title: Vatic API
  version: 1.0.0
  description: >-
    Polymarket price targets, Hyperliquid prediction market data, market
    timestamps, fee calculators, and order management for systematic prediction
    market trading.
servers:
  - url: https://api.vatic.trading
    description: Production
security: []
paths:
  /api/v1/games/lookup:
    get:
      tags:
        - Game Graph
      summary: Find a game from a platform's own id
      description: >-
        Maps an id that a platform uses (for Polymarket: the event slug, main or
        child event) to our game id. Useful for migrating an integration that is
        keyed by platform ids.
      operationId: lookupGame
      parameters:
        - name: source
          in: query
          required: true
          schema:
            type: string
            example: polymarket
        - name: external_id
          in: query
          required: true
          schema:
            type: string
            example: epl-ars-lee-2026-10-10
      responses:
        '200':
          description: The linked game
          headers:
            ETag:
              schema:
                type: string
              description: Weak ETag; send it back in `If-None-Match` for a 304.
            X-RateLimit-Limit:
              schema:
                type: integer
            X-RateLimit-Remaining:
              schema:
                type: integer
            X-RateLimit-Reset:
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      game_id:
                        type: string
                      confidence:
                        type: string
                        enum:
                          - exact
                          - high
                      rule:
                        type: string
                      role:
                        type: string
                      source:
                        type: string
                      external_id:
                        type: string
                  meta:
                    $ref: '#/components/schemas/GameGraphMeta'
        '400':
          description: Missing parameter
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameGraphError'
        '401':
          description: Missing or invalid API key (code `unauthorized`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameGraphError'
        '404':
          description: No game is linked to that id (code `not_found`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameGraphError'
        '429':
          description: Rate limit exceeded (code `rate_limited`); see `Retry-After`
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameGraphError'
        '503':
          description: Auth service unavailable (code `unavailable`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GameGraphError'
      security:
        - ApiKey: []
components:
  schemas:
    GameGraphMeta:
      type: object
      description: Always present.
      properties:
        as_of:
          type: string
          format: date-time
          description: >-
            When the read model behind this answer was last refreshed (about
            every 15 s).
        redistributable_filter:
          type: string
          enum:
            - yes_only
            - internal
        venues_checked:
          type: array
          items:
            type: string
          description: >-
            Platforms we integrate. A platform missing from a game's `platforms`
            is only "not offered" if its `coverage` says `not_listed`.
        total:
          type: integer
        withheld:
          type: object
          description: >-
            Games that exist but are not returned yet because their sources are
            not cleared for redistribution.
          properties:
            games:
              type: integer
            reason:
              type: string
    GameGraphError:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
          description: >-
            Stable machine-readable code: bad_request, unauthorized, forbidden,
            not_found, method_not_allowed, rate_limited, unavailable, internal.
        hint:
          type: string
      required:
        - error
        - code
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Required for order endpoints. Obtain your API key from the Vatic
        dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.