For the complete documentation index, see llms.txt. This page is also available as Markdown.

ComboBuilder Market Coverage

How to build ComboBuilder selections, plus every supported market and its outcome tokens

ComboBuilder is available for Football, Basketball, and Baseball across all leagues.

Each leg of a combo is one selection: it names the market you are betting, the outcome you are backing, and, where the market needs them, a line or a player. The tables further down list every supported market with its Market ID, accepted outcome tokens, and whether a line is required. Read this section first to turn a market from those tables into a valid selection.

Working with Outcomes

The selection object

Each entry in the request's selections array describes one leg:

Field
Required
What to send

marketId

Always

The Market ID from the tables below

outcome

Always

The side or result you are backing; accepted tokens per market are listed below

line

When the market's Line column says Yes

The handicap or total the outcome refers to, e.g. 2.5 for Over/Under

playerId

For player markets

The player the leg refers to; must match a player in the fixture's participants

period

Optional

A period override. Usually omit it: full-game markets and period markets (e.g. 1st Period Winner) already resolve their own period

Outcome tokens are case-insensitive: Y, y, and yes are all accepted. metricType is an optional refinement for certain player props; you can leave it out.

How to read the outcome tokens

Most markets use a small set of conventions:

Token
Meaning

1 / X / 2

Home / Draw / Away

O / U

Over / Under (always sent with a line)

ODD / EVEN

Odd or even total

Y / N

Yes or no

<home>-<away>

A correct-score line, e.g. 2-1

a/b

A combined token, e.g. 1/Y (home win and both teams to score)

Some markets accept a descriptive value in place of a symbol. For example, No Goal is accepted alongside X on First Team To Score. The exact set for each market is in the tables, so check the row you are sending.

Combo markets (e.g. 1X2 And Under/Over) use a single composite token with the line built into the string, such as 1/O2.5. For these the separate line field is ignored: the Outcomes column shows the format and Notes shows an example.

Building a valid slip

A few rules govern every request:

  • A slip needs at least two selections.

  • Send an outcome token that is valid for that market. An unrecognised market or token is rejected, and the API reference lists every error response.

  • On the standard /v1/combobuilder endpoint you also supply the source odds each leg depends on. Use /v1/markets to find those dependencies, or /v1/combobuilder/auto to have them resolved for you. See the ComboBuilder overview for the full flow.

Examples

A straight two-leg combo, Home win plus Over 2.5 goals:

A player leg. Anytime Goalscorer needs a playerId, and that player must also appear under the fixture's participants:

Football

Market ID
Market Name
Outcomes
Line
Notes

1

1X2

1 X 2

No

2

Under/Over

O U

Yes

3

Asian Handicap

1 2

Yes

4

HT/FT

1/1 1/X 1/2 X/1 X/X X/2 2/1 2/X 2/2

No

5

Odd/Even

ODD EVEN

No

6

Correct Score

<home>-<away>

No

e.g. 2-1

7

Double Chance

1X 12 X2

No

9

Correct Score 1st Period

<home>-<away>

No

e.g. 2-1

11

Total Corners

O U

Yes

13

European Handicap

1 X 2

Yes

16

First Team To Score

1 2 X

No

X = No Goal

17

Both Teams To Score

Y N

No

21

Under/Over 1st Period

O U

Yes

22

Away Team to Score

Y N

No

23

Home Team to Score

Y N

No

25

Double Chance Halftime

1X 12 X2

No

30

Under/Over Corners - Home Team

O U

Yes

31

Under/Over Corners - Away Team

O U

Yes

34

Home Team To Score In Both Halves

Y

No

Proposition fixed by market ID

35

Away Team To Score In Both Halves

Y

No

Proposition fixed by market ID

41

1st Period Winner

1 X 2

No

42

2nd Period Winner

1 X 2

No

45

Under/Over 2nd Period

O U

Yes

52

12

1 2

No

55

First Team To Score 1st Period

1 2 X

No

X = No Goal

56

Last Team To Score

1 2 X

No

X = No Goal

59

Next Goal

1 2 X

Yes

line = goal number; X = none

61

European Handicap Halftime

1 X 2

Yes

64

Asian Handicap 1st Period

1 2

Yes

69

Will The Game Go To Overtime?

Y N

No

71

Highest Scoring Half

1 2 X

No

X = equal halves

72

1st Period Odd/Even

ODD EVEN

No

73

2nd Period Odd/Even

ODD EVEN

No

79

Will A Penalty Be Awarded?

Y N

No

80

First Corner

1 2 X

No

X = none

81

Last Corner

1 2 X

No

X = none

82

Will A Red Card Be Shown?

Y N

No

84

To Win Both Halves

1 2

No

85

To Win From Behind

1 2

No

86

To Win To Nil

1 2

No

92

First Team To Score 2nd Half

1 2 X

No

X = No Goal

97

Home Team Win To Nil

Y N

No

98

Home Team To Keep A Clean Sheet

Y N

No

100

Correct Score 2nd Period

<home>-<away>

No

e.g. 2-1

101

Under/Over - Home Team

O U

Yes

102

Under/Over - Away Team

O U

Yes

104

Away Team To Win Both Halves

Y

No

Proposition fixed by market ID

105

Home Team To Win Both Halves

Y

No

Proposition fixed by market ID

106

Home Team To Win From Behind

Y

No

Proposition fixed by market ID

110

Away Team To Win At Least One Half

Y

No

Proposition fixed by market ID

111

Home Team To Win At Least One Half

Y

No

Proposition fixed by market ID

113

Both Teams To Score 1st Half

Y N

No

114

Any Player To Score At Least 2 Goals

Y

No

128

Number of Goals

0 1 2 3 4 5 Or More No Goal

No

0 also accepted as No Goal

129

Under/Over Corners - 1st Half

O U

Yes

134

Number of Goals 1st Half

0 1 2 3 4 5 Or More No Goal

No

0 also accepted as No Goal

137

Home Win No Bet

1 2

No

147

Away Team Number Of Goals In 2nd Half

O U

Yes

148

Home Team Number Of Goals In 2nd Half

O U

Yes

151

Double Chance 2nd Half

1X 12 X2

No

153

Under/Over 1st Period - Home Team

O U

Yes

154

Under/Over 2nd Period - Home Team

O U

Yes

155

Under/Over 1st Period - Away Team

O U

Yes

156

Under/Over 2nd Period - Away Team

O U

Yes

163

Number of Goals 2nd Half

0 1 2 3 4 5 Or More No Goal

No

0 also accepted as No Goal

169

To Score In Both Halves

Y N

No

171

To Win Either Half

1 2

No

191

Will Any Player Score a Hat-Trick?

Y N

No

192

Will A Goal Be Scored In Both Halves?

Y N

No

198

Odd/Even - Home Team

ODD EVEN

No

199

Odd/Even - Away Team

ODD EVEN

No

202

1st Period Winner Home/Away

1 2

No

203

2nd Period Winner Home/Away

1 2

No

210

Total Corners - 2nd Half

O U

Yes

211

Both Teams To Score 2nd Half

Y N

No

212

Both Teams To Score In Both Halves

Y N

No

214

Under/Over Cards

O U

Yes

215

Away Team to Score 1st Half

Y

No

Proposition fixed by market ID

216

Away Team to Score 2nd Half

Y

No

Proposition fixed by market ID

218

Home Team to Score 1st Half

Y

No

Proposition fixed by market ID

219

Home Team to Score 2nd Half

Y

No

Proposition fixed by market ID

259

Team With Most Corners

1 X 2

No

305

Corners - Under/Exactly/Over

O U Exactly

Yes

338

Next Goal 1st Period

1 2 X

Yes

line = goal number; X = none

391

Next Goal - Extra Time

1 2 X

Yes

line = goal number; X = none

401

Under/Over Corners 1st Half - Home Team

O U

Yes

402

Under/Over Corners 1st Half - Away Team

O U

Yes

409

1X2 Corners

1 X 2

No

410

1X2 Corners 1st Half

1 X 2

No

415

1X2 And Both Teams To Score

<1|X|2>/<Y|N>

No

e.g. 1/Y

416

Under/Over - Extra Time

O U

Yes

417

Under/Over - Extra Time 1st Half

O U

Yes

419

1X2 - Extra Time

1 X 2

No

427

1X2 And Under/Over

<1|X|2>/<O|U><line>

No

e.g. 1/O2.5

433

European Handicap Corners

1 X 2

Yes

472

Will Game Go to Shootout?

Y N

No

523

Under/Over And Both Teams To Score

<O|U><line>/<Y|N>

No

e.g. U2.5/N

579

Next Corner

1 2 X

No

X = none

711

Player To Score In Anytime

Y

No

Player ID required

714

Player To Score 2 Or More Goals

Y

No

Player ID required

715

Player To Score 3 Or More Goals

Y

No

Player ID required

756

Under/Over - Extra Time Corners

O U

Yes

820

Race To Corners

1 2 X

Yes

X = none

941

Next Player To Score

Y

No

Player ID required

1063

Highest Scoring Half - Away Team

1 2 X

No

X = equal halves

1071

Under/Over Player Assists

O U

Yes

Player ID required

1249

Double Chance & Under/Over

<1X|X2|12>/<O|U><line>

No

e.g. 1X/O2.5

1250

Double Chance & Both Teams To Score

<1X|X2|12>/<Y|N>

No

e.g. 1X/Y

1397

Under/Over Player Shots

O U

Yes

Player ID required

2351

Under/Over Player Shots On Target

O U

Yes

Player ID required

2352

Under/Over Player Tackles

O U

Yes

Player ID required

2578

1st Period 1X2 And Both Teams To Score

<1|X|2>/<Y|N>

No

e.g. 1/Y

2734

Under/Over Player Passes

O U

Yes

Player ID required

3201

Player Over Shots

O

Yes

Player ID required; over only

Basketball

Market ID
Market Name
Outcomes
Line
Notes

1

1X2

1 2

No

2

Under/Over

O U

Yes

3

Asian Handicap

1 2

Yes

4

HT/FT

1/1 1/X 1/2 X/1 X/X X/2 2/1 2/X 2/2

No

5

Odd/Even

ODD EVEN

No

7

Double Chance

1X 12 X2

No

41

1st Period Winner

1 2

No

42

2nd Period Winner

1 2

No

43

3rd Period Winner

1 2

No

44

4th Period Winner

1 2

No

63

12 Halftime

1 2

No

69

Will The Game Go To Overtime?

Y N

No

72

1st Period Odd/Even

ODD EVEN

No

73

2nd Period Odd/Even

ODD EVEN

No

74

3rd Period Odd/Even

ODD EVEN

No

75

4th Period Odd/Even

ODD EVEN

No

84

To Win Both Halves

Y N

No

101

Under/Over - Home Team