Ticker formats

Sports Ticker Format

Market Maker Reference

This specification defines the ticker format for sports prediction markets. Use this as the authoritative reference for ticker generation and parsing.

For event discovery and canonical taxonomy mappings, see Sports Market Taxonomy. Do not parse ticker strings to reconstruct the sportsMarket object; use API responses directly.

Overview

Sports prediction market tickers follow a consistent hierarchical structure:

Hierarchical: Event tickers group related contracts together.
Sortable: Alphabetical sorting clusters all markets for a game.
Parseable: Deterministic structure supports programmatic parsing.
Human-readable: Encodes league, date, teams, and market types compactly.

Sports fall into two categories:

Category	Sports	Structure
Team Sports	NBA, NFL, NHL, MLB, EPL, World Cup, International Friendlies, NCAAM	Home vs Away matchup format
Individual Sports	Golf, Formula 1	Tournament/race with N competitors

Ticker Hierarchy

Level	Description	Team Sports Example	Individual Sports Example
Parent Event Ticker	Identifies a game-level market	`GEMI-NBA-2602121800-HOU-DAL-S`	`GEMI-GOLF-MAS-WIN-20260412`
Child Event Ticker	Identifies a period-specific market nested under a parent event	`GEMI-MLB-2608122010-BAL-BOS-M-3IM`	—
Contract Ticker	Identifies a position within that market	`DAL6`	`SCHEFFLER`
Full Ticker	Event + Contract combined	`GEMI-NBA-2602121800-HOU-DAL-S-DAL6`	`GEMI-GOLF-MAS-WIN-20260412-SCHEFFLER`

Team Sports

Parent Event Ticker Format

Structure

Code
GEMI-{LEAGUE}-{YYMMDD}{HHMM}-{AWAY}-{HOME}-{TYPE}

Components

Component	Length	Format	Description
`GEMI`	4	literal	Gemini prediction market prefix
`LEAGUE`	2-6	`[A-Z]+`	League identifier
`YYMMDD`	6	`[0-9]{6}`	Game date (UTC)
`HHMM`	4	`[0-9]{4}`	Game time in 24hr (UTC)
`AWAY`	2-4	`[A-Z]+`	Away team abbreviation
`HOME`	2-4	`[A-Z]+`	Home team abbreviation
`TYPE`	1-7	`[A-Z]{1,7}`	Market type code

Regex Pattern

Code
^GEMI-([A-Z]{2,6})-(\d{6})(\d{4})-([A-Z]{2,4})-([A-Z]{2,4})-([A-Z]{1,7})$

Capture Groups:

League
Date (YYMMDD)
Time (HHMM)
Away team
Home team
Market type

Child Event Ticker Format

MLB and NFL period-specific markets use a child event ticker nested under the parent game market.

Structure

Code
GEMI-{LEAGUE}-{YYMMDD}{HHMM}-{AWAY}-{HOME}-{PARENT_TYPE}-{CHILD_SUFFIX}

PARENT_TYPE is the parent market type, such as M for moneyline. For MLB, CHILD_SUFFIX must be one of 3IM, 5IM, 7IM, 5IS, 5IT, or 1IRFI. For NFL, CHILD_SUFFIX must be one of 1QM, 2QM, 3QM, 4QM, 1HM, 2HM, 1QS, 2QS, 3QS, 4QS, 1HS, 2HS, 1QT, 2QT, 3QT, 4QT, 1HT, or 2HT.

Regex Pattern

Code
^GEMI-([A-Z]{2,6})-(\d{6})(\d{4})-([A-Z]{2,4})-([A-Z]{2,4})-([A-Z]{1,7})-(?:3IM|5IM|7IM|5IS|5IT|1IRFI|[1-4]Q[MST]|[12]H[MST])$

Supported Team Sports Leagues

League	Code	Teams	Abbreviation Length
NBA	`NBA`	30	3
NFL	`NFL`	32	2-3
WNBA	`WNBA`	15	2-3
NCAA Men's Basketball	`NCAAM`	350+	2-4
NCAA Women's Basketball	`NCAAW`	350+	2-4
NCAA Football	`NCAAF`	130+	2-4
NHL	`NHL`	32	2-3
MLB	`MLB`	30	2-3
English Premier League	`EPL`	20	3-4
FIFA World Cup	`FIFAWC`	48	2-4
International Friendlies	`INTLFRIENDLY`	48	2-4

International Friendlies roster

INTLFRIENDLY reuses the same national-team pool as FIFAWC — it has no separate roster of its own.

Market Types

Standard Markets

Type	Code	Description	Contract Format
Moneyline	`M`	Winner of the game or period	`{TEAM}`
Spread	`S`	Point spread	`{TEAM}{LINE}`
Total	`T`	Combined score over/under	`O{LINE}` or `U{LINE}`
Team Total	`TT`	Single team score over/under	`{TEAM}O{LINE}` or `{TEAM}U{LINE}`

MLB Period-Specific Markets

MLB period-specific markets create child events from the parent game event. The child ticker appends a supported suffix to the parent ticker.

Market	Event Suffix	Scope	Contract Format
First 3 Innings Moneyline	`-3IM`	Innings 1–3	`{TEAM}` or `D`
First 5 Innings Moneyline	`-5IM`	Innings 1–5	`{TEAM}` or `D`
First 7 Innings Moneyline	`-7IM`	Innings 1–7	`{TEAM}` or `D`
First 5 Innings Point Spread	`-5IS`	Innings 1–5	`{TEAM}{LINE}`
First 5 Innings Point Total	`-5IT`	Innings 1–5	`O{LINE}` or `U{LINE}`
First Inning Run (YRFI/NRFI)	`-1IRFI`	Inning 1	`YES` or `NO`

For example, GEMI-MLB-2608122010-BAL-BOS-M-3IM is the first-3-innings moneyline child of a game event. GEMI-MLB-2608122010-BAL-BOS-M-5IS is the first-5-innings point-spread child.

An F5 spread contract can use BAL1.5, which means Baltimore must lead by more than 1.5 runs after five innings. An F5 total contract can use O3 or U3, which means more than or less than 3.5 combined runs after five innings.

The D contract means a tie after the stated innings. MLB full-game moneylines do not use a tie contract because they include extra innings.

The first-inning run market uses YES for YRFI, when either team scores in the first inning, and NO for NRFI, when neither team scores.

NFL Period-Specific Markets

NFL period-specific markets create child events from the parent game event, one per quarter and per half. The child ticker appends a supported suffix to the parent ticker.

Market	Event Suffix	Scope	Contract Format
1st Quarter Moneyline	`-1QM`	Quarter 1	`{TEAM}` or `D`
2nd Quarter Moneyline	`-2QM`	Quarter 2	`{TEAM}` or `D`
3rd Quarter Moneyline	`-3QM`	Quarter 3	`{TEAM}` or `D`
4th Quarter Moneyline	`-4QM`	Quarter 4	`{TEAM}` or `D`
1st Half Moneyline	`-1HM`	Half 1	`{TEAM}` or `D`
2nd Half Moneyline	`-2HM`	Half 2	`{TEAM}` or `D`
1st Quarter Spread	`-1QS`	Quarter 1	`{TEAM}{LINE}`
2nd Quarter Spread	`-2QS`	Quarter 2	`{TEAM}{LINE}`
3rd Quarter Spread	`-3QS`	Quarter 3	`{TEAM}{LINE}`
4th Quarter Spread	`-4QS`	Quarter 4	`{TEAM}{LINE}`
1st Half Spread	`-1HS`	Half 1	`{TEAM}{LINE}`
2nd Half Spread	`-2HS`	Half 2	`{TEAM}{LINE}`
1st Quarter Total	`-1QT`	Quarter 1	`O{LINE}` or `U{LINE}`
2nd Quarter Total	`-2QT`	Quarter 2	`O{LINE}` or `U{LINE}`
3rd Quarter Total	`-3QT`	Quarter 3	`O{LINE}` or `U{LINE}`
4th Quarter Total	`-4QT`	Quarter 4	`O{LINE}` or `U{LINE}`
1st Half Total	`-1HT`	Half 1	`O{LINE}` or `U{LINE}`
2nd Half Total	`-2HT`	Half 2	`O{LINE}` or `U{LINE}`

For example, GEMI-NFL-2601121830-BUF-KC-M-1QM is the first-quarter moneyline child of a game event. GEMI-NFL-2601121830-BUF-KC-S-1HS is the first-half spread child.

A period spread contract can use KC3, which means Kansas City must lead by more than 3.5 points at the end of that quarter or half. A period total contract can use O20 or U20, which means more than or less than 20.5 combined points in that quarter or half.

The D contract means a tie score at the end of the stated quarter or half.

Player Props

Player prop market types follow the PP{STAT} pattern. Player identifiers use uppercase short names (typically last name, e.g., LUKA, MAHOMES).

Contract Format: {PLAYER}O{LINE} or {PLAYER}U{LINE}

Basketball

Type	Code	Description
Points	`PPPTS`	Player points over/under
Rebounds	`PPREB`	Player rebounds over/under
Assists	`PPAST`	Player assists over/under
3-Pointers Made	`PP3PM`	Player 3-pointers made over/under
Steals	`PPSTL`	Player steals over/under
Blocks	`PPBLK`	Player blocks over/under
Pts + Reb + Ast	`PPPRA`	Player points + rebounds + assists over/under

Football

Type	Code	Description
Touchdowns	`PPTD`	Player touchdowns over/under
Passing Yards	`PPYDS`	Player passing yards over/under
Rushing Yards	`PPRYDS`	Player rushing yards over/under
Receiving Yards	`PPRECY`	Player receiving yards over/under
Receptions	`PPREC`	Player receptions over/under
Completions	`PPCOMP`	Player completions over/under

Baseball

Type	Code	Description
Strikeouts	`PPSO`	Pitcher strikeouts over/under
Hits	`PPHITS`	Player hits over/under
Home Runs	`PPHR`	Player home runs over/under
RBIs	`PPRBI`	Player RBIs over/under
Total Bases	`PPTB`	Player total bases over/under
Runs	`PPRUNS`	Player runs scored over/under

Ice Hockey

Type	Code	Description
Goals	`PPGOALS`	Player goals over/under
Assists	`PPAST`	Player assists over/under
Points	`PPPTS`	Player points (goals + assists) over/under
Shots on Goal	`PPSOG`	Player shots on goal over/under
Saves	`PPSAVES`	Goalie saves over/under

Soccer

Type	Code	Description
Goals	`PPGOALS`	Player goals over/under
Assists	`PPAST`	Player assists over/under
Shots on Target	`PPSOT`	Player shots on target over/under

Soccer-Specific (EPL, UCL, MLS, FIFAWC, INTLFRIENDLY)

Type	Code	Description	Contract Format
Moneyline	`M`	3-way result	`{TEAM}` or `D` (draw)
To Advance (Winner)	`A`	Which team wins the match and advances. Single-leg knockout matches only — two contracts, no draw.	`{TEAM}`
Correct Score	`CS`	Exact final scoreline in regulation time. World Cup only.	`{HOME}{H}{AWAY}{A}`
Team Total	`TT`	A single team's score over/under; sport-specific scope is described in the Team Total section below.	`{TEAM}O{LINE}` or `{TEAM}U{LINE}`

Soccer also uses the standard Spread (S) and Total (T) markets above, with half-goal lines (e.g. BRA2 = Brazil -2.5, O2 = Over 2.5 goals). The moneyline, spread, and total markets resolve on regulation time plus stoppage only — extra time and penalties are excluded. The To Advance (Winner) market (A) is the exception: it settles on which team ultimately wins a single-leg knockout match, including extra time and penalties. See the To Advance contract section below.

Contract Ticker Formats

Moneyline (`-M`)

Contract Ticker: {TEAM}

Contract	Meaning
`DAL`	Dallas
`HOU`	Houston
`D`	Draw in soccer, tie after a partial MLB game, or tie at the end of an NFL quarter or half

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-M-DAL

Spread (`-S`)

Contract Ticker: {TEAM}{LINE}

Contract	Meaning
`DAL6`	Dallas -6.5
`HOU6`	Houston +6.5

Line Convention

Standard spread and total contracts use whole-number lines. The .5 is implied. For example, DAL6 means Dallas -6.5 and O222 means Over 222.5. F5 spread tickers may include an explicit .5, such as BAL1.5.

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-S-DAL6

Total (`-T`)

Contract Ticker: O{LINE} or U{LINE}

Contract	Meaning
`O222`	Over 222.5
`U222`	Under 222.5

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-T-O222

Team Total (`-TT`)

The Team Total market is an over/under on a single team's score rather than the combined game total. Its event ticker is the game ticker with the -TT type suffix. Settlement scope and available sides are sport-specific:

FIFA World Cup soccer: over lines on each team's goals in regulation time (90 minutes plus stoppage); extra time and penalties are excluded, consistent with the moneyline, spread, total, and correct-score markets.
NFL: over lines on each team's points in the entire game, including any overtime period — this is not regulation-only. NFL Team Totals are offered on regular-season and postseason games; preseason games are excluded. Whole-number lines imply .5 (for example, NEO24 means New England Over 24.5 points), and only over contracts are listed.

NFL Team Total resolution data is sourced from NFL.com and the NFL's official Game Statistics and Information System (GSIS), then ESPN, then NBC, CBS, FOX, Amazon Prime Video, Peacock, Netflix, or the official broadcast partner.

Contract Ticker: {TEAM}O{LINE} or {TEAM}U{LINE}

Contract	Meaning
`ENGO1`	England Over 1.5 goals
`ARGO0`	Argentina Over 0.5 goals
`HOUO110`	Houston Over 110.5
`HOUU110`	Houston Under 110.5
`DALO112`	Dallas Over 112.5
`DALU112`	Dallas Under 112.5

Full Ticker Example: GEMI-FIFAWC-2607152100-ARG-ENG-TT-ENGO1 (England Over 1.5 goals).

NFL Team Total examples:

Contract	Event ticker	Contract ticker	Instrument symbol
New England Over 24.5 points	`GEMI-NFL-2609100020-NE-SEA-TT`	`NEO24`	`GEMI-NFL-2609100020-NE-SEA-TT-NEO24`
Seattle Over 20.5 points	`GEMI-NFL-2609100020-NE-SEA-TT`	`SEAO20`	`GEMI-NFL-2609100020-NE-SEA-TT-SEAO20`

To Advance (`-A`)

The To Advance market (also called the Winner market) is offered on single-leg knockout soccer matches — for example, World Cup knockout-round games. Because a knockout match must produce a winner (extra time and, if needed, penalties when level after 90 minutes), this market has exactly two contracts and no draw. Its event ticker is the moneyline ticker with the -M suffix replaced by -A.

Contract Ticker: {TEAM}

Contract	Meaning
`QAT`	Qatar advances
`CAN`	Canada advances

Full Ticker Example: GEMI-FIFAWC-2606182200-QAT-CAN-A-QAT

To Advance vs. Moneyline

A single-leg knockout match is listed as both markets:

Moneyline (-M) — 3-way, settles on the regulation (90-minute + stoppage) result, and includes a D draw contract.
To Advance / Winner (-A) — two contracts, no draw, settles on which team wins the match after extra time and penalties.

Group-stage matches are listed as a moneyline only.

Eligibility

Match type	To Advance offered?
Single-leg knockout (Round of 32/16, quarterfinal, semifinal, final, third-place)	Yes
Group / league stage	No — moneyline only
Two-legged tie (aggregate)	No
Best-of-N series	No

Correct Score (`-CS`)

The Correct Score market lists a grid of exact final scorelines for a match. It is currently offered on FIFA World Cup matches only. Each contract is one exact scoreline and resolves Yes only if the match ends with that precise score in regulation time (90 minutes plus stoppage) — extra time and penalties are excluded, consistent with the moneyline, spread, and total markets. Its event ticker is the game ticker with the -CS type suffix.

Contract Ticker: {HOME}{H}{AWAY}{A}

Component	Description
`HOME`	Home team abbreviation
`H`	Home team goals in regulation
`AWAY`	Away team abbreviation
`A`	Away team goals in regulation

Contract	Meaning
`ESP1BEL0`	Spain 1, Belgium 0
`ESP0BEL0`	0–0 draw
`ESP2BEL1`	Spain 2, Belgium 1

Full Ticker Example: GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP1BEL0

Scoreline set is not exhaustive

The scorelines listed for a match mirror the correct-score markets on the underlying data source, so unlikely blowout scores may not be offered. If a match's regulation score is not among the listed contracts, every contract in the market resolves to No.

Individual Sports

Individual sports use a tournament or race-based ticker format. Instead of a home/away matchup, the event represents a competition with N individual competitors, each getting their own contract.

Event Ticker Format

Structure

Code
GEMI-{SPORT}-{EVENT}-{MARKET}-{YYYYMMDD}

Components

Component	Format	Description
`GEMI`	literal	Gemini prediction market prefix
`SPORT`	`[A-Z0-9]+`	Sport identifier (`GOLF`, `F1`)
`EVENT`	`[A-Z]{2,5}`	Abbreviated event name
`MARKET`	`[A-Z]+`	Market type (`WIN` for tournament/race winner)
`YYYYMMDD`	`[0-9]{8}`	Event end date (when winner is determined)

Regex Pattern

Code
^GEMI-([A-Z0-9]+)-([A-Z]{2,5})-([A-Z]+)-(\d{8})$

Capture Groups:

Sport
Event abbreviation
Market type
End date (YYYYMMDD)

Supported Individual Sports

Sport	Code	Event Abbreviation	Competitors
Golf	`GOLF`	3-char tournament name	~60-80 per tournament
Formula 1	`F1`	3-char GP name + `GP`	~20 per race

Contract Ticker Format

Contract Ticker: {COMPETITOR} — uppercase alphabetic name of the competitor.

Sport	Format	Collision Handling	Examples
Golf	Uppercase last name	Prepend first name	`SCHEFFLER`, `JOHNSMITH`
Formula 1	Driver symbol	Pre-assigned in DB	`VER`, `HAM`, `NOR`

Golf

Event Ticker

Code
GEMI-GOLF-{ABBREV}-WIN-{YYYYMMDD}

Component	Description	Example
`GEMI`	Gemini prediction market prefix	`GEMI`
`GOLF`	Sport identifier	`GOLF`
`ABBREV`	First 3 uppercase alpha chars of tournament name (after stripping "The " prefix)	`MAS` (Masters), `PGA` (PGA Championship)
`WIN`	Tournament winner market	`WIN`
`YYYYMMDD`	Final round date	`20260412`

Tournament Abbreviation Rules

Strip leading "The " / "the " (case-insensitive)
Strip trailing year suffix (e.g., " 2025")
Remove all non-alphanumeric characters
Uppercase
Take first 3 characters

Tournament	Abbreviation
Masters Tournament	`MAS`
THE PLAYERS Championship	`PLA`
PGA Championship	`PGA`
U.S. Open	`USO`
The Open Championship	`OPE`
Arnold Palmer Invitational	`ARN`
Valero Texas Open	`VAL`

Contract Ticker (Player)

Default: Uppercase last name, alpha characters only (SCHEFFLER, MCILROY, WOODS)
On collision: Prepend first name (JOHNSMITH, JAMESSMITH)
Special characters stripped: J.J. Spaun → SPAUN, Si Woo Kim → KIM

Golf Examples

Masters Tournament, Apr 12 2026

Market	Event Ticker	Contract	Full Ticker
Scheffler wins	`GEMI-GOLF-MAS-WIN-20260412`	`SCHEFFLER`	`GOLF-MAS-WIN-20260412-SCHEFFLER`
McIlroy wins	`GEMI-GOLF-MAS-WIN-20260412`	`MCILROY`	`GOLF-MAS-WIN-20260412-MCILROY`
Rahm wins	`GEMI-GOLF-MAS-WIN-20260412`	`RAHM`	`GOLF-MAS-WIN-20260412-RAHM`

PGA Championship, May 17 2026

Market	Event Ticker	Contract	Full Ticker
Woods wins	`GEMI-GOLF-PGA-WIN-20260517`	`WOODS`	`GOLF-PGA-WIN-20260517-WOODS`
Schauffele wins	`GEMI-GOLF-PGA-WIN-20260517`	`SCHAUFFELE`	`GOLF-PGA-WIN-20260517-SCHAUFFELE`

Formula 1

Event Ticker

Code
GEMI-F1-{ABBREV}GP-WIN-{YYYYMMDD}

Component	Description	Example
`GEMI`	Gemini prediction market prefix	`GEMI`
`F1`	Sport identifier	`F1`
`ABBREV`	First 3 uppercase chars of GP location + `GP`	`MIAGP` (Miami), `AUSGP` (Australian)
`WIN`	Race winner market	`WIN`
`YYYYMMDD`	Race date	`20260504`

Contract Ticker (Driver)

Pre-assigned driver symbols from the database (e.g., VER, HAM, NOR, LEC).

Formula 1 Examples

Miami Grand Prix, May 4 2026

Market	Event Ticker	Contract	Full Ticker
Verstappen wins	`GEMI-F1-MIAGP-WIN-20260504`	`VER`	`F1-MIAGP-WIN-20260504-VER`
Hamilton wins	`GEMI-F1-MIAGP-WIN-20260504`	`HAM`	`F1-MIAGP-WIN-20260504-HAM`
Norris wins	`GEMI-F1-MIAGP-WIN-20260504`	`NOR`	`F1-MIAGP-WIN-20260504-NOR`

Futures Format

Futures use a modified structure with F appended to the league code.

Structure

Code
GEMI-{LEAGUE}F-{SEASON}{TYPE}-{SUBJECT}

Components

Component	Format	Description
`LEAGUE`	`[A-Z]+`	League code
`F`	literal	Futures indicator
`SEASON`	`[0-9]{4}`	Season span (e.g., `2526` for 2025-26)
`TYPE`	varies	Future type code
`SUBJECT`	varies	Team or entity

Future Types

Type	Code	Example
Championship	`CHAMP`	`GEMI-NBAF-2526CHAMP-LAL`
Conference	`CONF`	`GEMI-NBAF-2526CONF-WEST-LAL`
Division	`DIV`	`GEMI-NFLF-2526DIV-AFCN-CLE`
MVP	`MVP`	`GEMI-NBAF-2526MVP-LUKA`

Regex Pattern

Code
^GEMI-([A-Z]{2,6})F-(\d{4})([A-Z]+)(?:-([A-Z]+))?-([A-Z]+)$

Capture Groups:

League
Season (YYYY format, e.g., 2526)
Future type (CHAMP, CONF, DIV, MVP)
Sub-category (optional, e.g., WEST, AFCN)
Subject (team or player)

Complete Examples

NBA Game

Houston @ Dallas, Feb 12 2026 18:00 UTC

Market	Event Ticker	Contract	Full Ticker
Dallas win	`GEMI-NBA-2602121800-HOU-DAL-M`	`DAL`	`GEMI-NBA-2602121800-HOU-DAL-M-DAL`
Houston win	`GEMI-NBA-2602121800-HOU-DAL-M`	`HOU`	`GEMI-NBA-2602121800-HOU-DAL-M-HOU`
Dallas -6.5	`GEMI-NBA-2602121800-HOU-DAL-S`	`DAL6`	`GEMI-NBA-2602121800-HOU-DAL-S-DAL6`
Houston +6.5	`GEMI-NBA-2602121800-HOU-DAL-S`	`HOU6`	`GEMI-NBA-2602121800-HOU-DAL-S-HOU6`
Over 222.5	`GEMI-NBA-2602121800-HOU-DAL-T`	`O222`	`GEMI-NBA-2602121800-HOU-DAL-T-O222`
Under 222.5	`GEMI-NBA-2602121800-HOU-DAL-T`	`U222`	`GEMI-NBA-2602121800-HOU-DAL-T-U222`
Houston Over 110.5	`GEMI-NBA-2602121800-HOU-DAL-TT`	`HOUO110`	`GEMI-NBA-2602121800-HOU-DAL-TT-HOUO110`
Dallas Under 112.5	`GEMI-NBA-2602121800-HOU-DAL-TT`	`DALU112`	`GEMI-NBA-2602121800-HOU-DAL-TT-DALU112`
Luka Over 30.5 pts	`GEMI-NBA-2602121800-HOU-DAL-PPPTS`	`LUKAO30`	`GEMI-NBA-2602121800-HOU-DAL-PPPTS-LUKAO30`
Luka Under 10.5 reb	`GEMI-NBA-2602121800-HOU-DAL-PPREB`	`LUKAU10`	`GEMI-NBA-2602121800-HOU-DAL-PPREB-LUKAU10`

NFL Game

Buffalo @ Kansas City, Jan 12 2026 18:30 UTC

Market	Full Ticker
Kansas City win	`GEMI-NFL-2601121830-BUF-KC-M-KC`
Kansas City -3.5	`GEMI-NFL-2601121830-BUF-KC-S-KC3`
Over 47.5	`GEMI-NFL-2601121830-BUF-KC-T-O47`
Mahomes Over 2.5 TDs	`GEMI-NFL-2601121830-BUF-KC-PPTD-MAHOMESO2`
Mahomes Over 299.5 yds	`GEMI-NFL-2601121830-BUF-KC-PPYDS-MAHOMESO299`

NCAAM Game

Duke @ UNC, Mar 15 2026 19:00 UTC

Market	Full Ticker
UNC win	`GEMI-NCAAM-2603151900-DUKE-UNC-M-UNC`
Duke +3.5	`GEMI-NCAAM-2603151900-DUKE-UNC-S-DUKE3`
Over 145.5	`GEMI-NCAAM-2603151900-DUKE-UNC-T-O145`

EPL Match

Arsenal vs Man City, Feb 15 2026 15:00 UTC

Market	Full Ticker
Arsenal win	`GEMI-EPL-2602151500-ARS-MCI-M-ARS`
Man City win	`GEMI-EPL-2602151500-ARS-MCI-M-MCI`
Draw	`GEMI-EPL-2602151500-ARS-MCI-M-D`
Over 2.5 goals	`GEMI-EPL-2602151500-ARS-MCI-T-O2`

World Cup Match

Bosnia & Herzegovina vs Canada, Jun 12 2026 19:00 UTC

Market	Full Ticker
Canada win	`GEMI-FIFAWC-2606121900-BOS-CAN-M-CAN`
Bosnia & Herzegovina win	`GEMI-FIFAWC-2606121900-BOS-CAN-M-BOS`
Draw	`GEMI-FIFAWC-2606121900-BOS-CAN-M-D`
Canada -1.5	`GEMI-FIFAWC-2606121900-BOS-CAN-S-CAN1`
Over 2.5 goals	`GEMI-FIFAWC-2606121900-BOS-CAN-T-O2`

World Cup Knockout Match

Qatar vs Canada, knockout round, Jun 18 2026 22:00 UTC

A single-leg knockout match is listed as both a To Advance (Winner) market and a 3-way moneyline:

Market	Event Ticker	Contract	Full Ticker
Qatar to advance	`GEMI-FIFAWC-2606182200-QAT-CAN-A`	`QAT`	`GEMI-FIFAWC-2606182200-QAT-CAN-A-QAT`
Canada to advance	`GEMI-FIFAWC-2606182200-QAT-CAN-A`	`CAN`	`GEMI-FIFAWC-2606182200-QAT-CAN-A-CAN`
Qatar win (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`QAT`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-QAT`
Canada win (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`CAN`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-CAN`
Draw (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`D`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-D`

World Cup Correct Score

Belgium vs Spain, Jul 10 2026 19:00 UTC — a grid of exact regulation-time scorelines (World Cup only):

Market	Event Ticker	Contract	Full Ticker
Spain 1, Belgium 0	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP1BEL0`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP1BEL0`
0–0 draw	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP0BEL0`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP0BEL0`
Spain 2, Belgium 1	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP2BEL1`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP2BEL1`

International Friendly

Egypt vs Brazil, Jun 6 2026 22:00 UTC

Market	Full Ticker
Brazil win	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-BRA`
Egypt win	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-EGY`
Draw	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-D`
Brazil -2.5	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-S-BRA2`
Over 2.5 goals	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-T-O2`

Golf Tournament

Masters Tournament, Apr 12 2026

Market	Event Ticker	Contract	Full Ticker
Scheffler wins	`GEMI-GOLF-MAS-WIN-20260412`	`SCHEFFLER`	`GOLF-MAS-WIN-20260412-SCHEFFLER`
McIlroy wins	`GEMI-GOLF-MAS-WIN-20260412`	`MCILROY`	`GOLF-MAS-WIN-20260412-MCILROY`
Matsuyama wins	`GEMI-GOLF-MAS-WIN-20260412`	`MATSUYAMA`	`GOLF-MAS-WIN-20260412-MATSUYAMA`

Formula 1 Race

Miami Grand Prix, May 4 2026

Market	Event Ticker	Contract	Full Ticker
Verstappen wins	`GEMI-F1-MIAGP-WIN-20260504`	`VER`	`F1-MIAGP-WIN-20260504-VER`
Norris wins	`GEMI-F1-MIAGP-WIN-20260504`	`NOR`	`F1-MIAGP-WIN-20260504-NOR`
Leclerc wins	`GEMI-F1-MIAGP-WIN-20260504`	`LEC`	`F1-MIAGP-WIN-20260504-LEC`

Futures

Market	Ticker
Los Angeles 2025-26 NBA Championship	`GEMI-NBAF-2526CHAMP-LAL`
Kansas City AFC West Division	`GEMI-NFLF-2526DIV-AFCW-KC`
Duke NCAA Tournament	`GEMI-NCAAMF-2526CHAMP-DUKE`

Validation Rules

Team Sports Event Ticker Validation

Must start with GEMI-
Must be ALL UPPERCASE
League code must be from supported list
DateTime must be valid UTC timestamp
Team codes must be valid for the league
Market type must be from supported list
A child event ticker must append a supported child suffix to its parent market type.

Individual Sports Event Ticker Validation

Must start with GEMI-
Must be ALL UPPERCASE
Sport code must be from supported list (GOLF, F1)
Event abbreviation must be 2-5 alpha characters
Market type must be valid (WIN)
Date must be valid YYYYMMDD format

Contract Ticker Validation

Team Sports

Market Type	Valid Pattern	Examples
Moneyline	`^[A-Z]{2,4}$` or `^D$`	`DAL`, `HOU`, `D`
To Advance (Winner)	`^[A-Z]{2,4}$`	`QAT`, `CAN`
Correct Score	`^[A-Z]{2,4}[0-9]+[A-Z]{2,4}[0-9]+$`	`ESP1BEL0`, `ARG2SUI1`
Spread	`^[A-Z]{2,4}[0-9]+$`	`DAL6`, `HOU6`
Total	`^[OU][0-9]+$`	`O222`, `U47`
Team Total	`^[A-Z]{2,4}[OU][0-9]+$`	`HOUO110`, `DALU112`
MLB period moneyline	`^[A-Z]{2,4}$` or `^D$`	`BAL`, `BOS`, `D`
MLB F5 spread	`^[A-Z]{2,4}[0-9]+(?:\.5)?$`	`BAL1.5`
MLB F5 total	`^[OU][0-9]+$`	`O3`
MLB first-inning run	`^(YES	NO)$`
NFL period moneyline	`^[A-Z]{2,4}$` or `^D$`	`KC`, `BUF`, `D`
NFL period spread	`^[A-Z]{2,4}[0-9]+(?:\.5)?$`	`KC3`
NFL period total	`^[OU][0-9]+$`	`O20`

Individual Sports

Market Type	Valid Pattern	Examples
Winner (Golf)	`^[A-Z]+$`	`SCHEFFLER`, `MCILROY`, `JOHNSMITH`
Winner (F1)	`^[A-Z]{2,4}$`	`VER`, `HAM`, `NOR`

Full Ticker Validation

Team Sports:

Code
^GEMI-[A-Z]{2,6}-\d{10}-[A-Z]{2,4}-[A-Z]{2,4}-[A-Z]{1,7}-[A-Z0-9.]+$

Team Sports Child Event:

Code
^GEMI-[A-Z]{2,6}-\d{10}-[A-Z]{2,4}-[A-Z]{2,4}-[A-Z]{1,7}-(?:3IM|5IM|7IM|5IS|5IT|1IRFI|[1-4]Q[MST]|[12]H[MST])-[A-Z0-9.]+$

Individual Sports:

Code
^GEMI-[A-Z0-9]+-[A-Z]{2,5}-[A-Z]+-\d{8}-[A-Z]+$

Changelog

Version	Effective Date	Changes
1.6	2026-09-28	Added NFL period-specific markets: quarter and half moneylines (`-1QM`–`-4QM`, `-1HM`, `-2HM`), spreads (`-1QS`–`-4QS`, `-1HS`, `-2HS`), and totals (`-1QT`–`-4QT`, `-1HT`, `-2HT`)
1.5	2026-07-10	Added the soccer Correct Score market (`-CS`) for FIFA World Cup matches — a grid of exact regulation-time scorelines
1.4	2026-06-25	Added the soccer To Advance (Winner) market (`-A`) for single-leg knockout matches (e.g. World Cup knockout rounds)
1.3	2026-06-08	Added World Cup (`FIFAWC`) and International Friendlies (`INTLFRIENDLY`) to supported soccer leagues, with worked examples
1.2	2026-03-30	Added Individual Sports section (Golf, Formula 1) with tournament/race-based ticker format
1.1	2026-03-04	Corrected prefix from `GEM-` to `GEMI-` for consistency with crypto tickers
1.0	2026-02-13	Initial specification

Crypto Sports Market Taxonomy

Ticker formats

Sports Ticker Format

Market Maker Reference

This specification defines the ticker format for sports prediction markets. Use this as the authoritative reference for ticker generation and parsing.

For event discovery and canonical taxonomy mappings, see Sports Market Taxonomy. Do not parse ticker strings to reconstruct the sportsMarket object; use API responses directly.

Overview

Sports prediction market tickers follow a consistent hierarchical structure:

Hierarchical: Event tickers group related contracts together.
Sortable: Alphabetical sorting clusters all markets for a game.
Parseable: Deterministic structure supports programmatic parsing.
Human-readable: Encodes league, date, teams, and market types compactly.

Sports fall into two categories:

Category	Sports	Structure
Team Sports	NBA, NFL, NHL, MLB, EPL, World Cup, International Friendlies, NCAAM	Home vs Away matchup format
Individual Sports	Golf, Formula 1	Tournament/race with N competitors

Ticker Hierarchy

Level	Description	Team Sports Example	Individual Sports Example
Parent Event Ticker	Identifies a game-level market	`GEMI-NBA-2602121800-HOU-DAL-S`	`GEMI-GOLF-MAS-WIN-20260412`
Child Event Ticker	Identifies a period-specific market nested under a parent event	`GEMI-MLB-2608122010-BAL-BOS-M-3IM`	—
Contract Ticker	Identifies a position within that market	`DAL6`	`SCHEFFLER`
Full Ticker	Event + Contract combined	`GEMI-NBA-2602121800-HOU-DAL-S-DAL6`	`GEMI-GOLF-MAS-WIN-20260412-SCHEFFLER`

Team Sports

Parent Event Ticker Format

Structure

Code
GEMI-{LEAGUE}-{YYMMDD}{HHMM}-{AWAY}-{HOME}-{TYPE}

Components

Component	Length	Format	Description
`GEMI`	4	literal	Gemini prediction market prefix
`LEAGUE`	2-6	`[A-Z]+`	League identifier
`YYMMDD`	6	`[0-9]{6}`	Game date (UTC)
`HHMM`	4	`[0-9]{4}`	Game time in 24hr (UTC)
`AWAY`	2-4	`[A-Z]+`	Away team abbreviation
`HOME`	2-4	`[A-Z]+`	Home team abbreviation
`TYPE`	1-7	`[A-Z]{1,7}`	Market type code

Regex Pattern

Code
^GEMI-([A-Z]{2,6})-(\d{6})(\d{4})-([A-Z]{2,4})-([A-Z]{2,4})-([A-Z]{1,7})$

Capture Groups:

League
Date (YYMMDD)
Time (HHMM)
Away team
Home team
Market type

Child Event Ticker Format

MLB and NFL period-specific markets use a child event ticker nested under the parent game market.

Structure

Code
GEMI-{LEAGUE}-{YYMMDD}{HHMM}-{AWAY}-{HOME}-{PARENT_TYPE}-{CHILD_SUFFIX}

Regex Pattern

Code
^GEMI-([A-Z]{2,6})-(\d{6})(\d{4})-([A-Z]{2,4})-([A-Z]{2,4})-([A-Z]{1,7})-(?:3IM|5IM|7IM|5IS|5IT|1IRFI|[1-4]Q[MST]|[12]H[MST])$

Supported Team Sports Leagues

League	Code	Teams	Abbreviation Length
NBA	`NBA`	30	3
NFL	`NFL`	32	2-3
WNBA	`WNBA`	15	2-3
NCAA Men's Basketball	`NCAAM`	350+	2-4
NCAA Women's Basketball	`NCAAW`	350+	2-4
NCAA Football	`NCAAF`	130+	2-4
NHL	`NHL`	32	2-3
MLB	`MLB`	30	2-3
English Premier League	`EPL`	20	3-4
FIFA World Cup	`FIFAWC`	48	2-4
International Friendlies	`INTLFRIENDLY`	48	2-4

International Friendlies roster

INTLFRIENDLY reuses the same national-team pool as FIFAWC — it has no separate roster of its own.

Market Types

Standard Markets

Type	Code	Description	Contract Format
Moneyline	`M`	Winner of the game or period	`{TEAM}`
Spread	`S`	Point spread	`{TEAM}{LINE}`
Total	`T`	Combined score over/under	`O{LINE}` or `U{LINE}`
Team Total	`TT`	Single team score over/under	`{TEAM}O{LINE}` or `{TEAM}U{LINE}`

MLB Period-Specific Markets

MLB period-specific markets create child events from the parent game event. The child ticker appends a supported suffix to the parent ticker.

Market	Event Suffix	Scope	Contract Format
First 3 Innings Moneyline	`-3IM`	Innings 1–3	`{TEAM}` or `D`
First 5 Innings Moneyline	`-5IM`	Innings 1–5	`{TEAM}` or `D`
First 7 Innings Moneyline	`-7IM`	Innings 1–7	`{TEAM}` or `D`
First 5 Innings Point Spread	`-5IS`	Innings 1–5	`{TEAM}{LINE}`
First 5 Innings Point Total	`-5IT`	Innings 1–5	`O{LINE}` or `U{LINE}`
First Inning Run (YRFI/NRFI)	`-1IRFI`	Inning 1	`YES` or `NO`

For example, GEMI-MLB-2608122010-BAL-BOS-M-3IM is the first-3-innings moneyline child of a game event. GEMI-MLB-2608122010-BAL-BOS-M-5IS is the first-5-innings point-spread child.

The D contract means a tie after the stated innings. MLB full-game moneylines do not use a tie contract because they include extra innings.

The first-inning run market uses YES for YRFI, when either team scores in the first inning, and NO for NRFI, when neither team scores.

NFL Period-Specific Markets

NFL period-specific markets create child events from the parent game event, one per quarter and per half. The child ticker appends a supported suffix to the parent ticker.

Market	Event Suffix	Scope	Contract Format
1st Quarter Moneyline	`-1QM`	Quarter 1	`{TEAM}` or `D`
2nd Quarter Moneyline	`-2QM`	Quarter 2	`{TEAM}` or `D`
3rd Quarter Moneyline	`-3QM`	Quarter 3	`{TEAM}` or `D`
4th Quarter Moneyline	`-4QM`	Quarter 4	`{TEAM}` or `D`
1st Half Moneyline	`-1HM`	Half 1	`{TEAM}` or `D`
2nd Half Moneyline	`-2HM`	Half 2	`{TEAM}` or `D`
1st Quarter Spread	`-1QS`	Quarter 1	`{TEAM}{LINE}`
2nd Quarter Spread	`-2QS`	Quarter 2	`{TEAM}{LINE}`
3rd Quarter Spread	`-3QS`	Quarter 3	`{TEAM}{LINE}`
4th Quarter Spread	`-4QS`	Quarter 4	`{TEAM}{LINE}`
1st Half Spread	`-1HS`	Half 1	`{TEAM}{LINE}`
2nd Half Spread	`-2HS`	Half 2	`{TEAM}{LINE}`
1st Quarter Total	`-1QT`	Quarter 1	`O{LINE}` or `U{LINE}`
2nd Quarter Total	`-2QT`	Quarter 2	`O{LINE}` or `U{LINE}`
3rd Quarter Total	`-3QT`	Quarter 3	`O{LINE}` or `U{LINE}`
4th Quarter Total	`-4QT`	Quarter 4	`O{LINE}` or `U{LINE}`
1st Half Total	`-1HT`	Half 1	`O{LINE}` or `U{LINE}`
2nd Half Total	`-2HT`	Half 2	`O{LINE}` or `U{LINE}`

For example, GEMI-NFL-2601121830-BUF-KC-M-1QM is the first-quarter moneyline child of a game event. GEMI-NFL-2601121830-BUF-KC-S-1HS is the first-half spread child.

The D contract means a tie score at the end of the stated quarter or half.

Player Props

Player prop market types follow the PP{STAT} pattern. Player identifiers use uppercase short names (typically last name, e.g., LUKA, MAHOMES).

Contract Format: {PLAYER}O{LINE} or {PLAYER}U{LINE}

Basketball

Type	Code	Description
Points	`PPPTS`	Player points over/under
Rebounds	`PPREB`	Player rebounds over/under
Assists	`PPAST`	Player assists over/under
3-Pointers Made	`PP3PM`	Player 3-pointers made over/under
Steals	`PPSTL`	Player steals over/under
Blocks	`PPBLK`	Player blocks over/under
Pts + Reb + Ast	`PPPRA`	Player points + rebounds + assists over/under

Football

Type	Code	Description
Touchdowns	`PPTD`	Player touchdowns over/under
Passing Yards	`PPYDS`	Player passing yards over/under
Rushing Yards	`PPRYDS`	Player rushing yards over/under
Receiving Yards	`PPRECY`	Player receiving yards over/under
Receptions	`PPREC`	Player receptions over/under
Completions	`PPCOMP`	Player completions over/under

Baseball

Type	Code	Description
Strikeouts	`PPSO`	Pitcher strikeouts over/under
Hits	`PPHITS`	Player hits over/under
Home Runs	`PPHR`	Player home runs over/under
RBIs	`PPRBI`	Player RBIs over/under
Total Bases	`PPTB`	Player total bases over/under
Runs	`PPRUNS`	Player runs scored over/under

Ice Hockey

Type	Code	Description
Goals	`PPGOALS`	Player goals over/under
Assists	`PPAST`	Player assists over/under
Points	`PPPTS`	Player points (goals + assists) over/under
Shots on Goal	`PPSOG`	Player shots on goal over/under
Saves	`PPSAVES`	Goalie saves over/under

Soccer

Type	Code	Description
Goals	`PPGOALS`	Player goals over/under
Assists	`PPAST`	Player assists over/under
Shots on Target	`PPSOT`	Player shots on target over/under

Soccer-Specific (EPL, UCL, MLS, FIFAWC, INTLFRIENDLY)

Type	Code	Description	Contract Format
Moneyline	`M`	3-way result	`{TEAM}` or `D` (draw)
To Advance (Winner)	`A`	Which team wins the match and advances. Single-leg knockout matches only — two contracts, no draw.	`{TEAM}`
Correct Score	`CS`	Exact final scoreline in regulation time. World Cup only.	`{HOME}{H}{AWAY}{A}`
Team Total	`TT`	A single team's score over/under; sport-specific scope is described in the Team Total section below.	`{TEAM}O{LINE}` or `{TEAM}U{LINE}`

Contract Ticker Formats

Moneyline (`-M`)

Contract Ticker: {TEAM}

Contract	Meaning
`DAL`	Dallas
`HOU`	Houston
`D`	Draw in soccer, tie after a partial MLB game, or tie at the end of an NFL quarter or half

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-M-DAL

Spread (`-S`)

Contract Ticker: {TEAM}{LINE}

Contract	Meaning
`DAL6`	Dallas -6.5
`HOU6`	Houston +6.5

Line Convention

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-S-DAL6

Total (`-T`)

Contract Ticker: O{LINE} or U{LINE}

Contract	Meaning
`O222`	Over 222.5
`U222`	Under 222.5

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-T-O222

Team Total (`-TT`)

FIFA World Cup soccer: over lines on each team's goals in regulation time (90 minutes plus stoppage); extra time and penalties are excluded, consistent with the moneyline, spread, total, and correct-score markets.
NFL: over lines on each team's points in the entire game, including any overtime period — this is not regulation-only. NFL Team Totals are offered on regular-season and postseason games; preseason games are excluded. Whole-number lines imply .5 (for example, NEO24 means New England Over 24.5 points), and only over contracts are listed.

Contract Ticker: {TEAM}O{LINE} or {TEAM}U{LINE}

Contract	Meaning
`ENGO1`	England Over 1.5 goals
`ARGO0`	Argentina Over 0.5 goals
`HOUO110`	Houston Over 110.5
`HOUU110`	Houston Under 110.5
`DALO112`	Dallas Over 112.5
`DALU112`	Dallas Under 112.5

Full Ticker Example: GEMI-FIFAWC-2607152100-ARG-ENG-TT-ENGO1 (England Over 1.5 goals).

NFL Team Total examples:

Contract	Event ticker	Contract ticker	Instrument symbol
New England Over 24.5 points	`GEMI-NFL-2609100020-NE-SEA-TT`	`NEO24`	`GEMI-NFL-2609100020-NE-SEA-TT-NEO24`
Seattle Over 20.5 points	`GEMI-NFL-2609100020-NE-SEA-TT`	`SEAO20`	`GEMI-NFL-2609100020-NE-SEA-TT-SEAO20`

To Advance (`-A`)

Contract Ticker: {TEAM}

Contract	Meaning
`QAT`	Qatar advances
`CAN`	Canada advances

Full Ticker Example: GEMI-FIFAWC-2606182200-QAT-CAN-A-QAT

To Advance vs. Moneyline

A single-leg knockout match is listed as both markets:

Moneyline (-M) — 3-way, settles on the regulation (90-minute + stoppage) result, and includes a D draw contract.
To Advance / Winner (-A) — two contracts, no draw, settles on which team wins the match after extra time and penalties.

Group-stage matches are listed as a moneyline only.

Eligibility

Match type	To Advance offered?
Single-leg knockout (Round of 32/16, quarterfinal, semifinal, final, third-place)	Yes
Group / league stage	No — moneyline only
Two-legged tie (aggregate)	No
Best-of-N series	No

Correct Score (`-CS`)

Contract Ticker: {HOME}{H}{AWAY}{A}

Component	Description
`HOME`	Home team abbreviation
`H`	Home team goals in regulation
`AWAY`	Away team abbreviation
`A`	Away team goals in regulation

Contract	Meaning
`ESP1BEL0`	Spain 1, Belgium 0
`ESP0BEL0`	0–0 draw
`ESP2BEL1`	Spain 2, Belgium 1

Full Ticker Example: GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP1BEL0

Scoreline set is not exhaustive

Individual Sports

Individual sports use a tournament or race-based ticker format. Instead of a home/away matchup, the event represents a competition with N individual competitors, each getting their own contract.

Event Ticker Format

Structure

Code
GEMI-{SPORT}-{EVENT}-{MARKET}-{YYYYMMDD}

Components

Component	Format	Description
`GEMI`	literal	Gemini prediction market prefix
`SPORT`	`[A-Z0-9]+`	Sport identifier (`GOLF`, `F1`)
`EVENT`	`[A-Z]{2,5}`	Abbreviated event name
`MARKET`	`[A-Z]+`	Market type (`WIN` for tournament/race winner)
`YYYYMMDD`	`[0-9]{8}`	Event end date (when winner is determined)

Regex Pattern

Code
^GEMI-([A-Z0-9]+)-([A-Z]{2,5})-([A-Z]+)-(\d{8})$

Capture Groups:

Sport
Event abbreviation
Market type
End date (YYYYMMDD)

Supported Individual Sports

Sport	Code	Event Abbreviation	Competitors
Golf	`GOLF`	3-char tournament name	~60-80 per tournament
Formula 1	`F1`	3-char GP name + `GP`	~20 per race

Contract Ticker Format

Contract Ticker: {COMPETITOR} — uppercase alphabetic name of the competitor.

Sport	Format	Collision Handling	Examples
Golf	Uppercase last name	Prepend first name	`SCHEFFLER`, `JOHNSMITH`
Formula 1	Driver symbol	Pre-assigned in DB	`VER`, `HAM`, `NOR`

Golf

Event Ticker

Code
GEMI-GOLF-{ABBREV}-WIN-{YYYYMMDD}

Component	Description	Example
`GEMI`	Gemini prediction market prefix	`GEMI`
`GOLF`	Sport identifier	`GOLF`
`ABBREV`	First 3 uppercase alpha chars of tournament name (after stripping "The " prefix)	`MAS` (Masters), `PGA` (PGA Championship)
`WIN`	Tournament winner market	`WIN`
`YYYYMMDD`	Final round date	`20260412`

Tournament Abbreviation Rules

Strip leading "The " / "the " (case-insensitive)
Strip trailing year suffix (e.g., " 2025")
Remove all non-alphanumeric characters
Uppercase
Take first 3 characters

Tournament	Abbreviation
Masters Tournament	`MAS`
THE PLAYERS Championship	`PLA`
PGA Championship	`PGA`
U.S. Open	`USO`
The Open Championship	`OPE`
Arnold Palmer Invitational	`ARN`
Valero Texas Open	`VAL`

Contract Ticker (Player)

Default: Uppercase last name, alpha characters only (SCHEFFLER, MCILROY, WOODS)
On collision: Prepend first name (JOHNSMITH, JAMESSMITH)
Special characters stripped: J.J. Spaun → SPAUN, Si Woo Kim → KIM

Golf Examples

Masters Tournament, Apr 12 2026

Market	Event Ticker	Contract	Full Ticker
Scheffler wins	`GEMI-GOLF-MAS-WIN-20260412`	`SCHEFFLER`	`GOLF-MAS-WIN-20260412-SCHEFFLER`
McIlroy wins	`GEMI-GOLF-MAS-WIN-20260412`	`MCILROY`	`GOLF-MAS-WIN-20260412-MCILROY`
Rahm wins	`GEMI-GOLF-MAS-WIN-20260412`	`RAHM`	`GOLF-MAS-WIN-20260412-RAHM`

PGA Championship, May 17 2026

Market	Event Ticker	Contract	Full Ticker
Woods wins	`GEMI-GOLF-PGA-WIN-20260517`	`WOODS`	`GOLF-PGA-WIN-20260517-WOODS`
Schauffele wins	`GEMI-GOLF-PGA-WIN-20260517`	`SCHAUFFELE`	`GOLF-PGA-WIN-20260517-SCHAUFFELE`

Formula 1

Event Ticker

Code
GEMI-F1-{ABBREV}GP-WIN-{YYYYMMDD}

Component	Description	Example
`GEMI`	Gemini prediction market prefix	`GEMI`
`F1`	Sport identifier	`F1`
`ABBREV`	First 3 uppercase chars of GP location + `GP`	`MIAGP` (Miami), `AUSGP` (Australian)
`WIN`	Race winner market	`WIN`
`YYYYMMDD`	Race date	`20260504`

Contract Ticker (Driver)

Pre-assigned driver symbols from the database (e.g., VER, HAM, NOR, LEC).

Formula 1 Examples

Miami Grand Prix, May 4 2026

Market	Event Ticker	Contract	Full Ticker
Verstappen wins	`GEMI-F1-MIAGP-WIN-20260504`	`VER`	`F1-MIAGP-WIN-20260504-VER`
Hamilton wins	`GEMI-F1-MIAGP-WIN-20260504`	`HAM`	`F1-MIAGP-WIN-20260504-HAM`
Norris wins	`GEMI-F1-MIAGP-WIN-20260504`	`NOR`	`F1-MIAGP-WIN-20260504-NOR`

Futures Format

Futures use a modified structure with F appended to the league code.

Structure

Code
GEMI-{LEAGUE}F-{SEASON}{TYPE}-{SUBJECT}

Components

Component	Format	Description
`LEAGUE`	`[A-Z]+`	League code
`F`	literal	Futures indicator
`SEASON`	`[0-9]{4}`	Season span (e.g., `2526` for 2025-26)
`TYPE`	varies	Future type code
`SUBJECT`	varies	Team or entity

Future Types

Type	Code	Example
Championship	`CHAMP`	`GEMI-NBAF-2526CHAMP-LAL`
Conference	`CONF`	`GEMI-NBAF-2526CONF-WEST-LAL`
Division	`DIV`	`GEMI-NFLF-2526DIV-AFCN-CLE`
MVP	`MVP`	`GEMI-NBAF-2526MVP-LUKA`

Regex Pattern

Code
^GEMI-([A-Z]{2,6})F-(\d{4})([A-Z]+)(?:-([A-Z]+))?-([A-Z]+)$

Capture Groups:

League
Season (YYYY format, e.g., 2526)
Future type (CHAMP, CONF, DIV, MVP)
Sub-category (optional, e.g., WEST, AFCN)
Subject (team or player)

Complete Examples

NBA Game

Houston @ Dallas, Feb 12 2026 18:00 UTC

Market	Event Ticker	Contract	Full Ticker
Dallas win	`GEMI-NBA-2602121800-HOU-DAL-M`	`DAL`	`GEMI-NBA-2602121800-HOU-DAL-M-DAL`
Houston win	`GEMI-NBA-2602121800-HOU-DAL-M`	`HOU`	`GEMI-NBA-2602121800-HOU-DAL-M-HOU`
Dallas -6.5	`GEMI-NBA-2602121800-HOU-DAL-S`	`DAL6`	`GEMI-NBA-2602121800-HOU-DAL-S-DAL6`
Houston +6.5	`GEMI-NBA-2602121800-HOU-DAL-S`	`HOU6`	`GEMI-NBA-2602121800-HOU-DAL-S-HOU6`
Over 222.5	`GEMI-NBA-2602121800-HOU-DAL-T`	`O222`	`GEMI-NBA-2602121800-HOU-DAL-T-O222`
Under 222.5	`GEMI-NBA-2602121800-HOU-DAL-T`	`U222`	`GEMI-NBA-2602121800-HOU-DAL-T-U222`
Houston Over 110.5	`GEMI-NBA-2602121800-HOU-DAL-TT`	`HOUO110`	`GEMI-NBA-2602121800-HOU-DAL-TT-HOUO110`
Dallas Under 112.5	`GEMI-NBA-2602121800-HOU-DAL-TT`	`DALU112`	`GEMI-NBA-2602121800-HOU-DAL-TT-DALU112`
Luka Over 30.5 pts	`GEMI-NBA-2602121800-HOU-DAL-PPPTS`	`LUKAO30`	`GEMI-NBA-2602121800-HOU-DAL-PPPTS-LUKAO30`
Luka Under 10.5 reb	`GEMI-NBA-2602121800-HOU-DAL-PPREB`	`LUKAU10`	`GEMI-NBA-2602121800-HOU-DAL-PPREB-LUKAU10`

NFL Game

Buffalo @ Kansas City, Jan 12 2026 18:30 UTC

Market	Full Ticker
Kansas City win	`GEMI-NFL-2601121830-BUF-KC-M-KC`
Kansas City -3.5	`GEMI-NFL-2601121830-BUF-KC-S-KC3`
Over 47.5	`GEMI-NFL-2601121830-BUF-KC-T-O47`
Mahomes Over 2.5 TDs	`GEMI-NFL-2601121830-BUF-KC-PPTD-MAHOMESO2`
Mahomes Over 299.5 yds	`GEMI-NFL-2601121830-BUF-KC-PPYDS-MAHOMESO299`

NCAAM Game

Duke @ UNC, Mar 15 2026 19:00 UTC

Market	Full Ticker
UNC win	`GEMI-NCAAM-2603151900-DUKE-UNC-M-UNC`
Duke +3.5	`GEMI-NCAAM-2603151900-DUKE-UNC-S-DUKE3`
Over 145.5	`GEMI-NCAAM-2603151900-DUKE-UNC-T-O145`

EPL Match

Arsenal vs Man City, Feb 15 2026 15:00 UTC

Market	Full Ticker
Arsenal win	`GEMI-EPL-2602151500-ARS-MCI-M-ARS`
Man City win	`GEMI-EPL-2602151500-ARS-MCI-M-MCI`
Draw	`GEMI-EPL-2602151500-ARS-MCI-M-D`
Over 2.5 goals	`GEMI-EPL-2602151500-ARS-MCI-T-O2`

World Cup Match

Bosnia & Herzegovina vs Canada, Jun 12 2026 19:00 UTC

Market	Full Ticker
Canada win	`GEMI-FIFAWC-2606121900-BOS-CAN-M-CAN`
Bosnia & Herzegovina win	`GEMI-FIFAWC-2606121900-BOS-CAN-M-BOS`
Draw	`GEMI-FIFAWC-2606121900-BOS-CAN-M-D`
Canada -1.5	`GEMI-FIFAWC-2606121900-BOS-CAN-S-CAN1`
Over 2.5 goals	`GEMI-FIFAWC-2606121900-BOS-CAN-T-O2`

World Cup Knockout Match

Qatar vs Canada, knockout round, Jun 18 2026 22:00 UTC

A single-leg knockout match is listed as both a To Advance (Winner) market and a 3-way moneyline:

Market	Event Ticker	Contract	Full Ticker
Qatar to advance	`GEMI-FIFAWC-2606182200-QAT-CAN-A`	`QAT`	`GEMI-FIFAWC-2606182200-QAT-CAN-A-QAT`
Canada to advance	`GEMI-FIFAWC-2606182200-QAT-CAN-A`	`CAN`	`GEMI-FIFAWC-2606182200-QAT-CAN-A-CAN`
Qatar win (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`QAT`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-QAT`
Canada win (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`CAN`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-CAN`
Draw (regulation)	`GEMI-FIFAWC-2606182200-QAT-CAN-M`	`D`	`GEMI-FIFAWC-2606182200-QAT-CAN-M-D`

World Cup Correct Score

Belgium vs Spain, Jul 10 2026 19:00 UTC — a grid of exact regulation-time scorelines (World Cup only):

Market	Event Ticker	Contract	Full Ticker
Spain 1, Belgium 0	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP1BEL0`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP1BEL0`
0–0 draw	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP0BEL0`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP0BEL0`
Spain 2, Belgium 1	`GEMI-FIFAWC-2607101900-BEL-ESP-CS`	`ESP2BEL1`	`GEMI-FIFAWC-2607101900-BEL-ESP-CS-ESP2BEL1`

International Friendly

Egypt vs Brazil, Jun 6 2026 22:00 UTC

Market	Full Ticker
Brazil win	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-BRA`
Egypt win	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-EGY`
Draw	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-M-D`
Brazil -2.5	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-S-BRA2`
Over 2.5 goals	`GEMI-INTLFRIENDLY-2606062200-EGY-BRA-T-O2`

Golf Tournament

Masters Tournament, Apr 12 2026

Market	Event Ticker	Contract	Full Ticker
Scheffler wins	`GEMI-GOLF-MAS-WIN-20260412`	`SCHEFFLER`	`GOLF-MAS-WIN-20260412-SCHEFFLER`
McIlroy wins	`GEMI-GOLF-MAS-WIN-20260412`	`MCILROY`	`GOLF-MAS-WIN-20260412-MCILROY`
Matsuyama wins	`GEMI-GOLF-MAS-WIN-20260412`	`MATSUYAMA`	`GOLF-MAS-WIN-20260412-MATSUYAMA`

Formula 1 Race

Miami Grand Prix, May 4 2026

Market	Event Ticker	Contract	Full Ticker
Verstappen wins	`GEMI-F1-MIAGP-WIN-20260504`	`VER`	`F1-MIAGP-WIN-20260504-VER`
Norris wins	`GEMI-F1-MIAGP-WIN-20260504`	`NOR`	`F1-MIAGP-WIN-20260504-NOR`
Leclerc wins	`GEMI-F1-MIAGP-WIN-20260504`	`LEC`	`F1-MIAGP-WIN-20260504-LEC`

Futures

Market	Ticker
Los Angeles 2025-26 NBA Championship	`GEMI-NBAF-2526CHAMP-LAL`
Kansas City AFC West Division	`GEMI-NFLF-2526DIV-AFCW-KC`
Duke NCAA Tournament	`GEMI-NCAAMF-2526CHAMP-DUKE`

Validation Rules

Team Sports Event Ticker Validation

Must start with GEMI-
Must be ALL UPPERCASE
League code must be from supported list
DateTime must be valid UTC timestamp
Team codes must be valid for the league
Market type must be from supported list
A child event ticker must append a supported child suffix to its parent market type.

Individual Sports Event Ticker Validation

Must start with GEMI-
Must be ALL UPPERCASE
Sport code must be from supported list (GOLF, F1)
Event abbreviation must be 2-5 alpha characters
Market type must be valid (WIN)
Date must be valid YYYYMMDD format

Contract Ticker Validation

Team Sports

Market Type	Valid Pattern	Examples
Moneyline	`^[A-Z]{2,4}$` or `^D$`	`DAL`, `HOU`, `D`
To Advance (Winner)	`^[A-Z]{2,4}$`	`QAT`, `CAN`
Correct Score	`^[A-Z]{2,4}[0-9]+[A-Z]{2,4}[0-9]+$`	`ESP1BEL0`, `ARG2SUI1`
Spread	`^[A-Z]{2,4}[0-9]+$`	`DAL6`, `HOU6`
Total	`^[OU][0-9]+$`	`O222`, `U47`
Team Total	`^[A-Z]{2,4}[OU][0-9]+$`	`HOUO110`, `DALU112`
MLB period moneyline	`^[A-Z]{2,4}$` or `^D$`	`BAL`, `BOS`, `D`
MLB F5 spread	`^[A-Z]{2,4}[0-9]+(?:\.5)?$`	`BAL1.5`
MLB F5 total	`^[OU][0-9]+$`	`O3`
MLB first-inning run	`^(YES	NO)$`
NFL period moneyline	`^[A-Z]{2,4}$` or `^D$`	`KC`, `BUF`, `D`
NFL period spread	`^[A-Z]{2,4}[0-9]+(?:\.5)?$`	`KC3`
NFL period total	`^[OU][0-9]+$`	`O20`

Individual Sports

Market Type	Valid Pattern	Examples
Winner (Golf)	`^[A-Z]+$`	`SCHEFFLER`, `MCILROY`, `JOHNSMITH`
Winner (F1)	`^[A-Z]{2,4}$`	`VER`, `HAM`, `NOR`

Full Ticker Validation

Team Sports:

Code
^GEMI-[A-Z]{2,6}-\d{10}-[A-Z]{2,4}-[A-Z]{2,4}-[A-Z]{1,7}-[A-Z0-9.]+$

Team Sports Child Event:

Code
^GEMI-[A-Z]{2,6}-\d{10}-[A-Z]{2,4}-[A-Z]{2,4}-[A-Z]{1,7}-(?:3IM|5IM|7IM|5IS|5IT|1IRFI|[1-4]Q[MST]|[12]H[MST])-[A-Z0-9.]+$

Individual Sports:

Code
^GEMI-[A-Z0-9]+-[A-Z]{2,5}-[A-Z]+-\d{8}-[A-Z]+$

Changelog

Version	Effective Date	Changes
1.6	2026-09-28	Added NFL period-specific markets: quarter and half moneylines (`-1QM`–`-4QM`, `-1HM`, `-2HM`), spreads (`-1QS`–`-4QS`, `-1HS`, `-2HS`), and totals (`-1QT`–`-4QT`, `-1HT`, `-2HT`)
1.5	2026-07-10	Added the soccer Correct Score market (`-CS`) for FIFA World Cup matches — a grid of exact regulation-time scorelines
1.4	2026-06-25	Added the soccer To Advance (Winner) market (`-A`) for single-leg knockout matches (e.g. World Cup knockout rounds)
1.3	2026-06-08	Added World Cup (`FIFAWC`) and International Friendlies (`INTLFRIENDLY`) to supported soccer leagues, with worked examples
1.2	2026-03-30	Added Individual Sports section (Golf, Formula 1) with tournament/race-based ticker format
1.1	2026-03-04	Corrected prefix from `GEM-` to `GEMI-` for consistency with crypto tickers
1.0	2026-02-13	Initial specification

Crypto Sports Market Taxonomy

Overview

Ticker Hierarchy

Team Sports

Parent Event Ticker Format

Child Event Ticker Format

Supported Team Sports Leagues

Market Types

Standard Markets

MLB Period-Specific Markets

NFL Period-Specific Markets

Player Props

Basketball

Football

Baseball

Ice Hockey

Soccer

Soccer-Specific (EPL, UCL, MLS, FIFAWC, INTLFRIENDLY)

Contract Ticker Formats

Moneyline (-M)

Spread (-S)

Total (-T)

Team Total (-TT)

To Advance (-A)

Correct Score (-CS)

Individual Sports

Event Ticker Format

Supported Individual Sports

Contract Ticker Format

Golf

Event Ticker

Tournament Abbreviation Rules

Contract Ticker (Player)

Golf Examples

Formula 1

Event Ticker

Contract Ticker (Driver)

Formula 1 Examples

Futures Format

Structure

Components

Future Types

Regex Pattern

Complete Examples

NBA Game

NFL Game

NCAAM Game

EPL Match

World Cup Match

World Cup Knockout Match

World Cup Correct Score

International Friendly

Golf Tournament

Formula 1 Race

Futures

Validation Rules

Team Sports Event Ticker Validation

Individual Sports Event Ticker Validation

Contract Ticker Validation

Team Sports

Individual Sports

Full Ticker Validation

Changelog

Overview

Ticker Hierarchy

Team Sports

Parent Event Ticker Format

Child Event Ticker Format

Supported Team Sports Leagues

Market Types

Standard Markets

MLB Period-Specific Markets

NFL Period-Specific Markets

Player Props

Basketball

Football

Baseball

Ice Hockey

Soccer

Soccer-Specific (EPL, UCL, MLS, FIFAWC, INTLFRIENDLY)

Contract Ticker Formats

Moneyline (`-M`)

Spread (`-S`)

Total (`-T`)

Team Total (`-TT`)

To Advance (`-A`)

Correct Score (`-CS`)

Moneyline (`-M`)

Spread (`-S`)

Total (`-T`)

Team Total (`-TT`)

To Advance (`-A`)

Correct Score (`-CS`)