Pular para o conteúdo principal
GET
/
events
/
public
/
list
Listar eventos
curl --request GET \
  --url https://api.n2.market/api/v1/events/public/list \
  --header 'X-API-Key: <api-key>'
{
  "events": [
    {
      "id": "event-123",
      "titles": {
        "pt": "Copa do Mundo 2026",
        "en": "World Cup 2026",
        "es": "Copa del Mundo 2026"
      },
      "subTitles": {
        "pt": "Fase de grupos",
        "en": "Group stage",
        "es": "Fase de grupos"
      },
      "descriptions": {
        "pt": "Mercados relacionados à Copa do Mundo",
        "en": "Markets related to the World Cup",
        "es": "Mercados relacionados con la Copa del Mundo"
      },
      "images": [
        "https://cdn.n2.market/events/worldcup.png"
      ],
      "highlighted": true,
      "markets": [
        {
          "id": "market-456",
          "questions": {
            "pt": "Brasil será campeão?",
            "en": "Will Brazil be champion?",
            "es": "¿Brasil será campeón?"
          },
          "outcomes": [
            {
              "id": "yes",
              "text": {
                "pt": "Sim",
                "en": "Yes",
                "es": "Sí"
              },
              "probability": 0.25
            },
            {
              "id": "no",
              "text": {
                "pt": "Não",
                "en": "No",
                "es": "No"
              },
              "probability": 0.75
            }
          ],
          "status": "ACTIVE"
        }
      ],
      "createdAt": "2026-01-15T10:00:00.000Z",
      "updatedAt": "2026-03-30T12:00:00.000Z"
    }
  ],
  "total": 25,
  "limit": 20,
  "offset": 0
}

Autorizações

X-API-Key
string
header
obrigatório

API Key for authentication. Get your key from the dashboard.

Parâmetros de consulta

highlighted
boolean

Filtrar por destacados. true devuelve solo eventos destacados, false devuelve solo eventos no destacados.

marketHighlighted
boolean

Filter by market highlighted status within events

categoryIds
string

Lista separada por comas de UUIDs de categorías para filtrar los resultados.

limit
integer
padrão:20

Número máximo de eventos a devolver

Intervalo obrigatório: 1 <= x <= 100
offset
integer
padrão:0

Cantidad de eventos a omitir para la paginación

Intervalo obrigatório: x >= 0

Resposta

200 - application/json

Lista de eventos obtenida correctamente

events
object[]
total
integer
limit
integer
offset
integer