GET
List market groups

Authorizations

X-API-Key
string
header
required

ISV / partner credential — public half. Required on every request.

Identifies the integration partner (ISV) making the call. Issued by Dime Trades when the ISV is onboarded and sent on every /partner/* endpoint:

  • On the two partner endpoints that create accounts or issue tokens (POST /partner/customers, POST /partner/customers/login), it is accompanied by X-API-Secret and is the only authentication — there is no user token yet.
  • On every other partner endpoint it is sent alongside the user's Authorization: Bearer <token>: the API key says which platform is calling, the bearer token says which user it is calling for.

Credentials are scoped to one or more brands; using a key with a brandId outside that scope returns 403. Staging and production keys are separate. The key identifies your platform — treat it as a backend credential.

Query Parameters

isActive
boolean

Restrict to active (or inactive) groups. Omitted, both are returned — so check isActive before rendering a tab.

subcategoryId
integer

Restrict to one sport's groups. Accepts either a level-1 sport id (Basketball, Soccer) or a league id beneath it (MLB, La Liga).

Groups are stored against the sport, so a league id climbs to its parent and then returns only those of the sport's groups that the league's own events actually populate — e.g. Baseball has 9 groups, while KBO returns 6 and CPBL 2. That keeps a league's group bar free of tabs that would open onto nothing.

Omit to get every sport's groups across pages.

Required range: x >= 1
Example:

7

eventId
integer

Restrict to groups that have at least one market for this specific event. Use this on the event detail page so empty tabs (groups with no markets for the event being viewed) are never returned.

Required range: x >= 1
Example:

5454

page
integer
default:1
Required range: x >= 1
limit
integer
default:15
Required range: x >= 1

Response

Market groups returned.

data
object
errors
array