> ## Documentation Index
> Fetch the complete documentation index at: https://docs.futuur.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List events

> Retrieve a paginated list of prediction market events with optional filters.

Retrieve a list of prediction market events. Use query parameters to filter by category, search term, currency mode, and other criteria.

## Endpoint

```
GET https://api.futuur.com/v2.0/events/
```

## Authentication

<Note>
  This endpoint does not require authentication. You can call it without HMAC headers.
</Note>

## Request

<ParamField query="categories" type="integer[]">
  Filter events by one or more category IDs.
</ParamField>

<ParamField query="currency_mode" type="string" default="play_money">
  Filter by currency mode. One of `play_money` or `real_money`.
</ParamField>

<ParamField query="hide_my_bets" type="boolean" default="false">
  When `true`, excludes events where you have active bets.
</ParamField>

<ParamField query="live" type="boolean" default="false">
  When `true`, returns only live events.
</ParamField>

<ParamField query="only_markets_i_follow" type="boolean" default="false">
  When `true`, returns only events containing markets you follow.
</ParamField>

<ParamField query="pending_resolution" type="boolean" default="false">
  When `true`, returns only events pending resolution.
</ParamField>

<ParamField query="resolved_only" type="boolean" default="false">
  When `true`, returns only resolved events.
</ParamField>

<ParamField query="search" type="string">
  Full-text search query. Between 1 and 100 characters.
</ParamField>

<ParamField query="tag" type="string">
  Filter by tag. Between 1 and 100 characters.
</ParamField>

<ParamField query="ordering" type="string">
  Field to sort results by. Prefix with `-` for descending order.
</ParamField>

<ParamField query="limit" type="integer">
  Number of results to return per page.
</ParamField>

<ParamField query="offset" type="integer">
  The initial index from which to return the results.
</ParamField>

## Response

Returns a paginated list of events.

<ResponseField name="count" type="integer" required>
  Total number of events matching the query.
</ResponseField>

<ResponseField name="next" type="string">
  URL to the next page of results, or `null` if this is the last page.
</ResponseField>

<ResponseField name="previous" type="string">
  URL to the previous page of results, or `null` if this is the first page.
</ResponseField>

<ResponseField name="results" type="object[]" required>
  Array of event objects.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl -G "https://api.futuur.com/v2.0/events/" \
    --data-urlencode "search=US election" \
    --data-urlencode "currency_mode=play_money" \
    --data-urlencode "limit=5"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.futuur.com/v2.0/events/",
      params={
          "search": "US election",
          "currency_mode": "play_money",
          "limit": 5,
      },
  )

  events = response.json()["results"]
  for event in events:
      print(event["id"], event["title"])
  ```
</CodeGroup>

```json Sample response (200 OK) theme={null}
{
  "count": 42,
  "next": "https://api.futuur.com/v2.0/events/?limit=5&offset=5",
  "previous": null,
  "results": [
    {
      "id": 12345,
      "title": "Who will win the 2024 US Presidential Election?",
      "slug": "who-will-win-2024-us-presidential-election",
      "status": "open",
      "markets": [...]
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.