GeminiGemini
SandboxGet API key
  • Crypto Trading
  • Prediction Markets
Resources
  • Changelog

© 2026 Gemini Space Station, Inc.

Gemini Crypto Exchange LogoGemini Crypto Exchange Logo
Market Makers
    Maker Rebate Program
WebSocket
    AuthenticationMessage Format
    Streams
      Book TickerL2 Partial DepthL2 Differential DepthTrade StreamOrder EventsBalance Updates
    Playground
      Overviewconninfopingtimesubscribeunsubscribelist_subscriptionsdepthorder.placeorder.cancelorder.cancel_allorder.cancel_session
REST APIs
    Order Management
    Positions
    Events
Agentic
Tickers
    OverviewCryptoSportsCommoditiesWeather
Schemas
Tickers

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.

Overview

Sports prediction market tickers follow a hierarchical structure designed to be:

  • Hierarchical - Event tickers group related contracts
  • Sortable - Alphabetical sorting clusters all markets for a game
  • Parseable - Deterministic structure enables programmatic parsing
  • Human-readable - Encodes game, market type, and position in a compact format

Sports are organized into two categories based on ticker format:

CategorySportsStructure
Team SportsNBA, NFL, NHL, MLB, EPL, NCAAMHome vs Away matchup format
Individual SportsGolf, Formula 1Tournament/race with N competitors

Ticker Hierarchy

LevelDescriptionTeam Sports ExampleIndividual Sports Example
Event TickerIdentifies a specific marketGEMI-NBA-2602121800-HOU-DAL-SGEMI-GOLF-MAS-WIN-20260412
Contract TickerIdentifies a position within that marketDAL6SCHEFFLER
Full TickerEvent + Contract combinedGEMI-NBA-2602121800-HOU-DAL-S-DAL6GEMI-GOLF-MAS-WIN-20260412-SCHEFFLER

Team Sports

Event Ticker Format

Structure

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

Components

ComponentLengthFormatDescription
GEMI4literalGemini prediction market prefix
LEAGUE2-6[A-Z]+League identifier
YYMMDD6[0-9]{6}Game date (UTC)
HHMM4[0-9]{4}Game time in 24hr (UTC)
AWAY2-4[A-Z]+Away team abbreviation
HOME2-4[A-Z]+Home team abbreviation
TYPE1-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:

  1. League
  2. Date (YYMMDD)
  3. Time (HHMM)
  4. Away team
  5. Home team
  6. Market type

Supported Team Sports Leagues

LeagueCodeTeamsAbbreviation Length
NBANBA303
NFLNFL322-3
NCAA Men's BasketballNCAAM350+2-4
NCAA Women's BasketballNCAAW350+2-4
NCAA FootballNCAAF130+2-4
NHLNHL322-3
MLBMLB302-3
English Premier LeagueEPL203-4

Market Types

Standard Markets

TypeCodeDescriptionContract Format
MoneylineMWinner of the game{TEAM}
SpreadSPoint spread{TEAM}{LINE}
TotalTCombined score over/underO{LINE} or U{LINE}
Team TotalTTSingle team score over/under{TEAM}O{LINE} or {TEAM}U{LINE}

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
TypeCodeDescription
PointsPPPTSPlayer points over/under
ReboundsPPREBPlayer rebounds over/under
AssistsPPASTPlayer assists over/under
3-Pointers MadePP3PMPlayer 3-pointers made over/under
StealsPPSTLPlayer steals over/under
BlocksPPBLKPlayer blocks over/under
Pts + Reb + AstPPPRAPlayer points + rebounds + assists over/under
Football
TypeCodeDescription
TouchdownsPPTDPlayer touchdowns over/under
Passing YardsPPYDSPlayer passing yards over/under
Rushing YardsPPRYDSPlayer rushing yards over/under
Receiving YardsPPRECYPlayer receiving yards over/under
ReceptionsPPRECPlayer receptions over/under
CompletionsPPCOMPPlayer completions over/under
Baseball
TypeCodeDescription
StrikeoutsPPSOPitcher strikeouts over/under
HitsPPHITSPlayer hits over/under
Home RunsPPHRPlayer home runs over/under
RBIsPPRBIPlayer RBIs over/under
Total BasesPPTBPlayer total bases over/under
RunsPPRUNSPlayer runs scored over/under
Ice Hockey
TypeCodeDescription
GoalsPPGOALSPlayer goals over/under
AssistsPPASTPlayer assists over/under
PointsPPPTSPlayer points (goals + assists) over/under
Shots on GoalPPSOGPlayer shots on goal over/under
SavesPPSAVESGoalie saves over/under
Soccer
TypeCodeDescription
GoalsPPGOALSPlayer goals over/under
AssistsPPASTPlayer assists over/under
Shots on TargetPPSOTPlayer shots on target over/under

Soccer-Specific (EPL)

TypeCodeDescriptionContract Format
MoneylineM3-way result{TEAM} or D (draw)

Contract Ticker Formats

Moneyline (-M)

Contract Ticker: {TEAM}

ContractMeaning
DALDallas
HOUHouston
DDraw (soccer only)

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

Spread (-S)

Contract Ticker: {TEAM}{LINE}

ContractMeaning
DAL6Dallas -6.5
HOU6Houston +6.5

Line Convention

All lines (spreads and totals) use whole numbers only. The .5 is always implied. For example, DAL6 means Dallas -6.5 and O222 means Over 222.5.

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

Total (-T)

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

ContractMeaning
O222Over 222.5
U222Under 222.5

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

Team Total (-TT)

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

ContractMeaning
HOUO110Houston Over 110.5
HOUU110Houston Under 110.5
DALO112Dallas Over 112.5
DALU112Dallas Under 112.5

Full Ticker Example: GEMI-NBA-2602121800-HOU-DAL-TT-HOUO110


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

ComponentFormatDescription
GEMIliteralGemini 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:

  1. Sport
  2. Event abbreviation
  3. Market type
  4. End date (YYYYMMDD)

Supported Individual Sports

SportCodeEvent AbbreviationCompetitors
GolfGOLF3-char tournament name~60-80 per tournament
Formula 1F13-char GP name + GP~20 per race

Contract Ticker Format

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

SportFormatCollision HandlingExamples
GolfUppercase last namePrepend first nameSCHEFFLER, JOHNSMITH
Formula 1Driver symbolPre-assigned in DBVER, HAM, NOR

Golf

Event Ticker

Code
GEMI-GOLF-{ABBREV}-WIN-{YYYYMMDD}
ComponentDescriptionExample
GEMIGemini prediction market prefixGEMI
GOLFSport identifierGOLF
ABBREVFirst 3 uppercase alpha chars of tournament name (after stripping "The " prefix)MAS (Masters), PGA (PGA Championship)
WINTournament winner marketWIN
YYYYMMDDFinal round date20260412

Tournament Abbreviation Rules

  1. Strip leading "The " / "the " (case-insensitive)
  2. Strip trailing year suffix (e.g., " 2025")
  3. Remove all non-alphanumeric characters
  4. Uppercase
  5. Take first 3 characters
TournamentAbbreviation
Masters TournamentMAS
THE PLAYERS ChampionshipPLA
PGA ChampionshipPGA
U.S. OpenUSO
The Open ChampionshipOPE
Arnold Palmer InvitationalARN
Valero Texas OpenVAL

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

MarketEvent TickerContractFull Ticker
Scheffler winsGEMI-GOLF-MAS-WIN-20260412SCHEFFLERGOLF-MAS-WIN-20260412-SCHEFFLER
McIlroy winsGEMI-GOLF-MAS-WIN-20260412MCILROYGOLF-MAS-WIN-20260412-MCILROY
Rahm winsGEMI-GOLF-MAS-WIN-20260412RAHMGOLF-MAS-WIN-20260412-RAHM

PGA Championship, May 17 2026

MarketEvent TickerContractFull Ticker
Woods winsGEMI-GOLF-PGA-WIN-20260517WOODSGOLF-PGA-WIN-20260517-WOODS
Schauffele winsGEMI-GOLF-PGA-WIN-20260517SCHAUFFELEGOLF-PGA-WIN-20260517-SCHAUFFELE

Formula 1

Event Ticker

Code
GEMI-F1-{ABBREV}GP-WIN-{YYYYMMDD}
ComponentDescriptionExample
GEMIGemini prediction market prefixGEMI
F1Sport identifierF1
ABBREVFirst 3 uppercase chars of GP location + GPMIAGP (Miami), AUSGP (Australian)
WINRace winner marketWIN
YYYYMMDDRace date20260504

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

MarketEvent TickerContractFull Ticker
Verstappen winsGEMI-F1-MIAGP-WIN-20260504VERF1-MIAGP-WIN-20260504-VER
Hamilton winsGEMI-F1-MIAGP-WIN-20260504HAMF1-MIAGP-WIN-20260504-HAM
Norris winsGEMI-F1-MIAGP-WIN-20260504NORF1-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

ComponentFormatDescription
LEAGUE[A-Z]+League code
FliteralFutures indicator
SEASON[0-9]{4}Season span (e.g., 2526 for 2025-26)
TYPEvariesFuture type code
SUBJECTvariesTeam or entity

Future Types

TypeCodeExample
ChampionshipCHAMPGEMI-NBAF-2526CHAMP-LAL
ConferenceCONFGEMI-NBAF-2526CONF-WEST-LAL
DivisionDIVGEMI-NFLF-2526DIV-AFCN-CLE
MVPMVPGEMI-NBAF-2526MVP-LUKA

Regex Pattern

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

Capture Groups:

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

Complete Examples

NBA Game

Houston @ Dallas, Feb 12 2026 18:00 UTC

MarketEvent TickerContractFull Ticker
Dallas winGEMI-NBA-2602121800-HOU-DAL-MDALGEMI-NBA-2602121800-HOU-DAL-M-DAL
Houston winGEMI-NBA-2602121800-HOU-DAL-MHOUGEMI-NBA-2602121800-HOU-DAL-M-HOU
Dallas -6.5GEMI-NBA-2602121800-HOU-DAL-SDAL6GEMI-NBA-2602121800-HOU-DAL-S-DAL6
Houston +6.5GEMI-NBA-2602121800-HOU-DAL-SHOU6GEMI-NBA-2602121800-HOU-DAL-S-HOU6
Over 222.5GEMI-NBA-2602121800-HOU-DAL-TO222GEMI-NBA-2602121800-HOU-DAL-T-O222
Under 222.5GEMI-NBA-2602121800-HOU-DAL-TU222GEMI-NBA-2602121800-HOU-DAL-T-U222
Houston Over 110.5GEMI-NBA-2602121800-HOU-DAL-TTHOUO110GEMI-NBA-2602121800-HOU-DAL-TT-HOUO110
Dallas Under 112.5GEMI-NBA-2602121800-HOU-DAL-TTDALU112GEMI-NBA-2602121800-HOU-DAL-TT-DALU112
Luka Over 30.5 ptsGEMI-NBA-2602121800-HOU-DAL-PPPTSLUKAO30GEMI-NBA-2602121800-HOU-DAL-PPPTS-LUKAO30
Luka Under 10.5 rebGEMI-NBA-2602121800-HOU-DAL-PPREBLUKAU10GEMI-NBA-2602121800-HOU-DAL-PPREB-LUKAU10

NFL Game

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

MarketFull Ticker
Kansas City winGEMI-NFL-2601121830-BUF-KC-M-KC
Kansas City -3.5GEMI-NFL-2601121830-BUF-KC-S-KC3
Over 47.5GEMI-NFL-2601121830-BUF-KC-T-O47
Mahomes Over 2.5 TDsGEMI-NFL-2601121830-BUF-KC-PPTD-MAHOMESO2
Mahomes Over 299.5 ydsGEMI-NFL-2601121830-BUF-KC-PPYDS-MAHOMESO299

NCAAM Game

Duke @ UNC, Mar 15 2026 19:00 UTC

MarketFull Ticker
UNC winGEMI-NCAAM-2603151900-DUKE-UNC-M-UNC
Duke +3.5GEMI-NCAAM-2603151900-DUKE-UNC-S-DUKE3
Over 145.5GEMI-NCAAM-2603151900-DUKE-UNC-T-O145

EPL Match

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

MarketFull Ticker
Arsenal winGEMI-EPL-2602151500-ARS-MCI-M-ARS
Man City winGEMI-EPL-2602151500-ARS-MCI-M-MCI
DrawGEMI-EPL-2602151500-ARS-MCI-M-D
Over 2.5 goalsGEMI-EPL-2602151500-ARS-MCI-T-O2

Golf Tournament

Masters Tournament, Apr 12 2026

MarketEvent TickerContractFull Ticker
Scheffler winsGEMI-GOLF-MAS-WIN-20260412SCHEFFLERGOLF-MAS-WIN-20260412-SCHEFFLER
McIlroy winsGEMI-GOLF-MAS-WIN-20260412MCILROYGOLF-MAS-WIN-20260412-MCILROY
Matsuyama winsGEMI-GOLF-MAS-WIN-20260412MATSUYAMAGOLF-MAS-WIN-20260412-MATSUYAMA

Formula 1 Race

Miami Grand Prix, May 4 2026

MarketEvent TickerContractFull Ticker
Verstappen winsGEMI-F1-MIAGP-WIN-20260504VERF1-MIAGP-WIN-20260504-VER
Norris winsGEMI-F1-MIAGP-WIN-20260504NORF1-MIAGP-WIN-20260504-NOR
Leclerc winsGEMI-F1-MIAGP-WIN-20260504LECF1-MIAGP-WIN-20260504-LEC

Futures

MarketTicker
Los Angeles 2025-26 NBA ChampionshipGEMI-NBAF-2526CHAMP-LAL
Kansas City AFC West DivisionGEMI-NFLF-2526DIV-AFCW-KC
Duke NCAA TournamentGEMI-NCAAMF-2526CHAMP-DUKE

Validation Rules

Team Sports Event Ticker Validation

  1. Must start with GEMI-
  2. Must be ALL UPPERCASE
  3. League code must be from supported list
  4. DateTime must be valid UTC timestamp
  5. Team codes must be valid for the league
  6. Market type must be from supported list

Individual Sports Event Ticker Validation

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

Contract Ticker Validation

Team Sports

Market TypeValid PatternExamples
Moneyline^[A-Z]{2,4}$ or ^D$DAL, HOU, D
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

Individual Sports

Market TypeValid PatternExamples
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]+$

Individual Sports:

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

Changelog

VersionEffective DateChanges
1.22026-03-30Added Individual Sports section (Golf, Formula 1) with tournament/race-based ticker format
1.12026-03-04Corrected prefix from GEM- to GEMI- for consistency with crypto tickers
1.02026-02-13Initial specification
Last modified on April 17, 2026
CryptoCommodities
On this page
  • Overview
  • Ticker Hierarchy
  • Team Sports
    • Event Ticker Format
    • Supported Team Sports Leagues
    • Market Types
    • Contract Ticker Formats
  • Individual Sports
    • Event Ticker Format
    • Supported Individual Sports
    • Contract Ticker Format
    • Golf
    • Formula 1
  • Futures Format
    • Structure
    • Components
    • Future Types
    • Regex Pattern
  • Complete Examples
    • NBA Game
    • NFL Game
    • NCAAM Game
    • EPL Match
    • Golf Tournament
    • Formula 1 Race
    • Futures
  • Validation Rules
    • Team Sports Event Ticker Validation
    • Individual Sports Event Ticker Validation
    • Contract Ticker Validation
    • Full Ticker Validation
  • Changelog