📖 Dataset Schema & API

Interactive documentation for the .json.gz data files.

The ETL pipeline produces a compressed JSON dataset (.json.gz) for each specific MTG Arena event. These files combine MTGA local client IDs, Scryfall metadata, Scryfall community tags (otags), and 17Lands telemetry into a single, unified JSON document optimized for local applications and data analysis.

GET https://unrealities.github.io/MTGA_Draft_17Lands/{set}_{format}_{user_group}_Data.json.gz

Path Parameters

{set}

string • required

The 3-letter MTG expansion code (e.g., BLB, OTJ).

{format}

string • required

Event type (e.g., PremierDraft, TradDraft).

{user_group}

string • required

Player skill bracket (e.g., All, Top).

Data Models (Schemas)

Dataset Root Object

Property	Type	Description
meta	Meta	Information about when the dataset was compiled.
color_ratings	Map<float>	Baseline win rates for each color archetype in the format. Keyed by normalized WUBRG strings (e.g., `"UB"`, `"WUBRG"`).
card_ratings	Map<Card>	Dictionary of all cards in the set, keyed by the MTG Arena GrpId (as a string).

Meta

Property	Type	Description
version	float	Schema version (e.g. `3.0`)
start_date	date	Start of 17Lands telemetry range.
end_date	date	End of 17Lands telemetry range.
game_count	integer	Total number of games analyzed to build this dataset.
collection_date	datetime	When the ETL pipeline actually compiled the file.

Card

Property	Type	Description
name	string	Sanitized English card name.
cmc	integer	Converted Mana Cost (Mana Value).
mana_cost	string	Formatted mana cost (e.g., `"{1}{W}{U}"`).
types	array[string]	Supertypes (e.g., `["Creature", "Artifact"]`).
subtypes	array[string]	Tribes/Types (e.g., `["Human", "Ninja"]`).
rarity	string	`common`, `uncommon`, `rare`, `mythic`.
colors	array[string]	Color identity (e.g., `["W", "B"]`).
tags	array[string]	Scryfall Oracle tags indicating the card's role (e.g., `["removal", "evasion", "fixing_ramp"]`).
image	array[string]	List of image URLs (arrays handle double-faced cards).
deck_colors	Map< ArchetypeMetrics>	Contains 17Lands telemetry data isolated by deck archetype (e.g. `"All Decks"`, `"UB"`).

ArchetypeMetrics

Property	Type	Description
gihwr	float	Games in Hand Win Rate (%). The win rate when the card was drawn or in the opening hand. The most standard metric of power.
alsa	float	Average Last Seen At. (1.0 - 15.0) Indicates how highly the community values picking this card.
ata	float	Average Taken At. Similar to ALSA, but restricted only to when users of 17Lands actively picked it.
iwd	float	Improvement When Drawn (%). `GIHWR - GNSWR`. Highly positive IWDs (> 4.0%) strongly indicate "Bomb" level cards.
ohwr	float	Opening Hand Win Rate (%). High values here usually indicate aggressive 1 or 2-drops.
gpwr	float	Games Played Win Rate (%). The win rate of decks that included this card, regardless of if it was ever drawn.
samples	integer	Total number of games this card was drawn in this specific archetype. Use this to determine if the win rate is statistically noisy.