Using the Squiggle API

library(fitzRoy)
library(dplyr)

Squiggle Data

You can access data from the Squiggle API directly with the fetch_squiggle_data. This allows direct access to the Squiggle API.

Note that we also provide some helper functions that map more closely to our fetch_ functions such as fetch_ladder_squiggle.

Queries

Full instructions for constructing queries can be found at Squiggle API. One of the following must be provided to the query argument.

  • teams - Info about teams (e.g. Richmond, Geelong, West Coast)
  • games - Info about games (e.g. Round 1, 2019 Richmond v Carlton)
  • sources - Info about models (e.g. Matter of Stats, GRAFT, Swinburne)
  • tips - Info about tips and predictions made by models
  • standings - Info about team standings (i.e. the ladder)
  • ladder - Info about predicted ladders generated by models
  • virtual - Info about Virtually Season 2020
  • pav - Info about Player Approximate Value from HPN Footy

Optional Arguments

Optional arguments can then be supplied based on the query.

For example, games takes the following optional arguments. * year - Year * round - Round * game - Game ID * complete - Percent of game complete

These can be supplied as named arguments after the query. For example, to return games from just 2020, we would use the following.

fetch_squiggle_data(query = "games", year = 2020)

Examples

Teams

Fetch info about one or more AFL teams.

fetch_squiggle_data("teams")

Games

Fetch info about one or more games.

fetch_squiggle_data(query = "games", year = 2020)

Sources

Fetch info about one or more computer models.

# You can get the sources
fetch_squiggle_data("sources")

Tips

Fetch info about one or more tips made by computer models.

# Get all tips
fetch_squiggle_data("tips")

We can just look at one particular round.

# Get` just tips from round 1, 2018
fetch_squiggle_data("tips", round = 1, year = 2018)

Standings

Fetch info about team standings at a point in time, i.e. the ladder.

fetch_squiggle_data("standings", year = 2020, round = 1)

Ladder

Fetch info about one or more projected ladders generated by computer models. For the actual ladder, see standings instead.

fetch_squiggle_data("ladder", year = 2019, round = 15, source = 1)

PAV

Fetch info about players using HPN Footy’s Player Approximate Value.

fetch_squiggle_data("pav",
  firstname = "Dustin",
  surname = "Martin",
  year = 2017
)