List Events

Retrieve a list of multi-outcome events. Events group related markets together (e.g., "2026 World Cup Winner").

GET /api/events

Query Parameters

Parameter	Type	Required	Description
status	string	optional	Filter: `active`, `resolved`
page	integer	optional	Page number
limit	integer	optional	Items per page

Response

Response 200 OK

{
  "success": true,
  "data": [
    {
      "id": 23,
      "title": "2026 NBA MVP",
      "slug": "2026-nba-mvp",
      "description": "Who will win the 2026 NBA MVP award?",
      "category": "Sports",
      "image_url": "/images/events/nba-mvp.png",
      "status": "active",
      "end_date": "2026-06-15T00:00:00.000Z",
      "markets_count": 8,
      "total_volume": 125400.00,
      "created_at": "2026-01-10T08:00:00.000Z"
    }
  ],
  "total": 45
}

Example

curl https://oddsforge.org/api/events?status=active

Featured Events

GET /api/events/featured

Returns the currently featured event with its markets.