---
title: "List games"
method: GET
path: "/games"
tags: ["Markets"]
---

# List games

`GET /games`

## Request

- Base URL: `https://arena-predictions.com/api/v1`
- URL: `https://arena-predictions.com/api/v1/games`
- Auth: HTTP bearer

A page of games with at least one public instrument, earliest first. With no from or to, a page starts six hours ago.

## Query parameters

- `league` string
- `status` 'scheduled' | 'inprogress' | 'final' | 'postponed' | 'cancelled'
- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

A page of games.

- GamePage
  - `games` Game[], required
    - `id` string, required
    - `slug` string, nullable, required
    - `league` string, nullable, required
    - `startsAt` string, date-time, nullable, required
    - `status` 'scheduled' | 'inprogress' | 'final' | 'postponed' | 'cancelled' | 'null', nullable, required
    - `season` integer, nullable
    - `seasonType` string, nullable
    - `week` integer, nullable
    - `home` object, required
      - `code` string, nullable, required
      - `name` string, nullable, required
    - `away` object, required
      - `code` string, nullable, required
      - `name` string, nullable, required
    - `instrumentCount` integer, required: Public instruments on the game.
  - `count` integer, required
  - `nextCursor` string, nullable, required
  - `asOf` string, date-time, nullable, required

## Other responses

- `400`: invalid_request.
- `401`: Missing, malformed, unknown, revoked or expired key. Carries a WWW-Authenticate: Bearer challenge.
- `403`: insufficient_scope: the key does not carry markets:read.
- `429`: rate_limited (over the plan's minute limit) or quota_exceeded (over the month). Only while the limits are enforced; until then requests are counted and the headers set, and nothing is refused. error.retryAfterSeconds equals Retry-After.
- `503`: The key could not be verified, or the data could not be read, right now. Retry after the Retry-After seconds.

---

[API](https://skmtc.dev/arena-predictions/apis/arena-api.md) · [All operations](https://skmtc.dev/arena-predictions/apis/arena-api/llms.txt) · [OpenAPI document](https://skmtc.dev/arena-predictions/apis/arena-api/revisions/9d89d166dae6?raw)