Feed

get/api/feed/v1/leagues/{league}/games

Request

  • Base URL: https://api.findticker.com
  • URL: https://api.findticker.com/api/feed/v1/leagues/{league}/games
  • Auth: HTTP bearer

Path parameters

leaguestring required
Example:mlb

Query parameters

teamstring

Only this team's games, by the team key from teams.

Example:nyy
side'home' | 'away' | 'any'

With team: only its home games, only its away games, or both (the default).

schedule_section'postseason' | 'season'

The section to page through: postseason (the games inside the postseason's dates, while the league has a bracket) or season (every other upcoming game). Default: the postseason while it has games, else the season.

monthstring

With schedule_section=season: the venue-local month, YYYY-MM. Default: the first month with games.

Example:2027-04
if_necessary'true' | 'false'

With schedule_section=postseason: the if-necessary games no series is sure to reach yet are listed by default (each carries folded); false folds them away.

qstring

Words that must all be in one of the game's teams (name, short name or code) or in the game's name. Case and accent blind.

Example:yankees
sort_by'date' | 'primary' | 'primary_left' | 'secondary' | 'vs' | 'qty' | 'resale_to_primary' | 'interest' | 'sales'

The order of the section before paging: date (the default) or a market column. sh and sg do not sort; primary sorts by the primary price each game shows (tm, mlb or sgp); secondary sorts by the cheapest resale each game shows (vs, tmr, sh, sg); resale_to_primary sorts by the ratio each game shows. A column the key's plan does not include is refused with 402.

sort_order'asc' | 'desc'

Default asc for date, desc for a market column. Games with no value come last.

pageinteger

1 based.

Example:1
page_sizeinteger

Games per page, 50 by default, 100 at most. Each game costs a unit.

Example:50

Response

The league's upcoming games, soonest first, one section and one page at a time, each with its market: the League page's read. The postseason comes first while the league has a bracket, then the next season by month. Market columns follow the key's plan the way the screener's do. Costs one unit per game returned, and one unit for a page with no games.

section'postseason' | 'season' required
monthstring nullable required
if_necessaryboolean required
sort_bystring required

The order the page is in: date or a market column key.

sort_order'asc' | 'desc' required
pageinteger required
page_sizeinteger required
totalinteger required
truncatedboolean required

Example response

{
  "league": {
    "key": "mlb",
    "name": "MLB",
    "sport": "baseball",
    "season": "2026"
  },
  "teams": [
    {
      "key": "nyy"
    }
  ],
  "columns": [
    {
      "key": "vs",
      "source": "vs",
      "columns": [
        "ea.lowest_aip_price_current"
      ]
    }
  ],
  "games": [
    {
      "event_id": "ev7k3m9qp2xd",
      "local_date": "2026-10-07",
      "local_time": "20:08",
      "market": {
        "primary": {
          "price": 142.5,
          "price_before_fees": 118,
          "change_1d": -4.2,
          "change_7d": 18.6,
          "bases": [
            "price",
            "all_in"
          ],
          "source": "tm"
        },
        "secondary": {
          "price": 142.5,
          "price_before_fees": 118,
          "change_1d": -4.2,
          "change_7d": 18.6,
          "bases": [
            "price",
            "all_in"
          ],
          "source": "vs"
        },
        "vs": {
          "price": 142.5,
          "price_before_fees": 118,
          "change_1d": -4.2,
          "change_7d": 18.6,
          "bases": [
            "price",
            "all_in"
          ]
        },
        "sh": {
          "price": 142.5,
          "price_before_fees": 118,
          "change_1d": -4.2,
          "change_7d": 18.6,
          "bases": [
            "price",
            "all_in"
          ]
        },
        "sg": {
          "price": 142.5,
          "price_before_fees": 118,
          "change_1d": -4.2,
          "change_7d": 18.6,
          "bases": [
            "price",
            "all_in"
          ]
        }
      }
    }
  ],
  "screen": {
    "name": "MLB New York Yankees"
  },
  "withheld": [
    {
      "fields": [
        "market.primary_floor"
      ],
      "required_tier": "max"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.