API 3: Market List by Event ID

Updated on November 5, 2025
  • Endpoint: GET /api/v1/events/markets?eid={{eventId}}
  • Description: Fetches all betting markets available for a specific event. The data object maps each eventId to an array of market definitions.
  • Method: GET

Request Parameters

ParamTypeDescription
eidstringOne or more Event IDs (comma-separated). Supports up to 50 market IDs.

Request Example

GET /api/v1/events/markets?eid=34484327 HTTP/1.1
Host: {{baseUrl}}

Sample Response

{
  "data": {
    "34484327": [
      {
        "na": "Test session 3",
        "mid": "4.206169577467-F2",
        "eid": 34484327,
        "si": 4,
        "s": true,
        "if": null,
        "go": false,
        "di": 1,
        "ty": "session",
        "rt": false
      },
      {
        "na": "Match Odds",
        "mid": "1.245405948",
        "eid": 34484327,
        "si": 4,
        "s": true,
        "go": false,
        "ty": "match-odd",
        "rt": false,
        "r": [
          { "na": "England", "rid": 10301 },
          { "na": "India", "rid": 414464 },
          { "na": "The Draw", "rid": 60443 }
        ]
      },
      {
        "na": "Bookmaker 0% comm",
        "mid": "4.210402143219-BM",
        "eid": 34484327,
        "si": 4,
        "s": true,
        "rt": false,
        "ty": "bookmaker",
        "r": [
          { "na": "England", "rid": 715794 },
          { "na": "India", "rid": 370439 }
        ]
      }
    ],
    "34493448": [
      {
        "na": "ball run SL",
        "mid": "4.376814275143-BB",
        "eid": 34493448,
        "si": 4,
        "s": true,
        "go": false,
        "ty": "ball-by-ball",
        "rt": false,
        "bl": 0.1
      },
      {
        "na": "Match Odds",
        "mid": "1.245441832",
        "eid": 34493448,
        "si": 4,
        "s": false,
        "go": false,
        "rt": true,
        "ty": "match-odd",
        "r": [
          { "na": "Sri Lanka", "rid": 7337 },
          { "na": "Bangladesh", "rid": 7659 }
        ]
      },
      {
        "na": "India",
        "mid": "4.823575532015-P",
        "eid": 997267739,
        "si": 4,
        "s": true,
        "if": null,
        "go": false,
        "ty": "player-race",
        "m": [
          {
            "s": true,
            "go": false,
            "mid": "4.150816830653-PR",
            "r": [
              {
                "rid": 225572,
                "na": "India"
              },
              {
                "rid": 713186,
                "na": "England"
              }
            ],
            "if": null
          }
        ]
      }
    ]
  }
}

Glossary of Response Keys

KeyFull NameTypeDescription
dataeventMarketMapOBJECTMap of eventId to an array of market objects
midmarketIdSTRINGUnique identifier for the market
eideventIdINTID of the event
nanameSTRINGName of the market
sisportIdINTSport ID the market belongs to
sisActiveBOOLEANWhether the market is active
gogameOverBOOLEANIf the market is marked as concluded
didisplayIdINTDisplay ID used for market sequence (only for session and other markets)
tytypeSTRINGType of market (e.g., match-odd, bookmaker, session)
rrunnersARRAYList of runner objects with name (na) and runnerId (rid)
blballNumberFLOAT(For ball-by-ball type) shows the specific ball number
ifinfoCommentsNULLABLECommentary/notes given for a specific market
rtrecallMarketBOOLWhether the market is recalled or not

Glossary of Keys (Player Race – Nested Market Format)

KeyTypeDescription
naSTRINGName of the market or event
midSTRINGMarket ID – unique identifier for this market
eidNUMBEREvent ID – unique identifier for the event
siNUMBERSport ID – the sport to which this event belongs
sBOOLEANMarket active status (true = active, false = inactive)
ifNULLABLEInfo Comments
goBOOLEANGame over flag (true = game finished, false = ongoing)
tySTRINGType of the market (e.g., player-race)
mARRAYNested markets inside this market (for player-race, multi-market grouping)

Nested Object (m[])

KeyTypeDescription
sBOOLEANNested market active status
goBOOLEANNested market game over flag
midSTRINGNested market ID
rARRAYArray of runners/players in the nested market
ifNULLABLEInfo Comments

Runner Object (r[] inside m[])

KeyTypeDescription
ridNUMBERRunner/Player ID – unique identifier
naSTRINGName of the runner/player