Skip to main content

​
New feature

​
Soccer sports markets — H2H + Goal Spread + Total Goals

Three individual but interconnected event types for soccer matches, linked through a common sportGameSlug:

​
1. Head-to-Head (H2H) 3-Way — TEAM_H2H_3WAY

The primary match winner event with three mutually exclusive markets:
  • Home team win
  • Away team win
  • Draw

​
2. Goal Spread — GOAL_SPREAD

Grouped event with independent markets for each team winning by a specific goal margin (e.g., 1.5, 2.5, 3.5 goals). New fields:
  • propLine (number) — The goal threshold
  • propDirection (string) — "OVER" (indicates the team must win by more than the threshold)
  • propTeam (object) — Team details (id, name, slug, league, sport)

​
3. Total Goals — TOTAL_GOALS

Grouped event for total goals scored in the match (e.g., Over/Under 2.5, 3.5 goals). New fields:
  • propLine (number) — The goal threshold
  • propDirection (string) — "OVER" (indicates total goals must be over the threshold)
  • propTeam — null (applies to entire match)

​
New Endpoints

​
List sports teams — GET /v1/pm/sports/teams

Fetch soccer teams. Supports filtering by league and pagination. 
GET /v1/pm/sports/teams?league=epl&page=1&size=20

​
List sports games — GET /v1/pm/sports/games

Fetch upcoming and live matches with details like teams, league, and scheduled start time. Supports filtering by team, league, and pagination. 
GET /v1/pm/sports/games?league=epl&page=1&size=20

​
List sports leagues — GET /v1/pm/sports/leagues

Fetch soccer leagues to use for filtering teams and games. 
GET /v1/pm/sports/leagues

​
New query parameter

​
Get Events endpoint — GET /v1/pm/events

Filter sports events by:
  • sportGameSlug (string) — Fetch all three event types for a match 
    GET /v1/pm/events?sportGameSlug=bm-game-20260524-mci-avl
# Returns H2H, Goal Spread, and Total Goals events

​
Get Trades endpoint — GET /v1/pm/trades

New optional filters for trade history:
  • orderId (string) — Trades where the order is on either the taker or maker side
  • outcomeId (string) — Trades on either the taker or maker side
  • userId (string) — Trades where the user was either the taker or the maker
  • fromDate (string) — Trades created at or after this RFC3339 timestamp
  • toDate (string) — Trades created at or before this RFC3339 timestamp 
    GET /v1/pm/trades?userId=9f8c1b2a-3d4e-5f60-7180-90abcdef1234&fromDate=2026-05-01T00:00:00Z&toDate=2026-05-29T23:59:59Z
# Returns a user's trades within the date range
Breaking change. GET /v1/pm/trades is now paginated. The limit and cursor parameters are replaced by page (default 1) and size (default 50, max 100), and the response is wrapped in { data, pagination } instead of a bare array.
GET /v1/pm/trades?marketId=b2c3d4e5-f6a7-8901-bcde-f12345678901&page=1&size=20

​
Response schema changes

​
Market response

New fields for prop markets:
FieldTypePresent on
propLinenumber | nullGoal Spread markets, Total Goals markets
propDirectionstring | nullGoal Spread markets ("OVER"), Total Goals markets ("OVER")
propTeamobject | nullGoal Spread markets (team details), Total Goals markets (null)

​
Event response

New fields:
FieldTypePresent onNotes
sportGameSlugstringAll sports eventsUse for fetching related events
sportMarketTypestringAll sports eventsTEAM_H2H_3WAY | GOAL_SPREAD | TOTAL_GOALS

​
Documentation

See Sports markets for:
  • Complete market structure examples
  • Discovery flow for linked events
  • Terminology and data reference

​
Technical notes

  • H2H events also include propTeam for home/away markets (enables team-specific UI differentiation)
  • Database: new propLine, propDirection, and propTeamId columns on markets table; new sportGameSlug and sportMarketType column on events table