List events

Retrieve a list of prediction market events. Use query parameters to filter by category, currency mode, tags, or search terms. This endpoint does not require authentication.

Endpoint

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

Authentication

No authentication required.

Request

integer[]

Filter events by one or more category IDs.

string

default:"play_money"

Filter by currency mode. One of play_money or real_money.

boolean

default:"false"

When true, excludes events where you have active wagers.

boolean

default:"false"

When true, returns only live events.

boolean

default:"false"

When true, returns only events containing markets you follow.

boolean

default:"false"

When true, returns only events that are closed but not yet resolved.

boolean

default:"false"

When true, returns only resolved events.

string

Full-text search query. Maximum 100 characters.

string

Filter events by tag. Maximum 100 characters.

string

Field to sort results by. Prefix with - for descending order.

integer

Number of results to return per page.

integer

The initial index from which to return the results.

Response

Returns a paginated list of events.

integer

required

Total number of events matching the query.

string

URL for the next page of results, or null if this is the last page.

string

URL for the previous page of results, or null if this is the first page.

object[]

required

Array of event objects.

Example

curl -G "https://api.futuur.com/v2.0/events/" \
  --data-urlencode "search=US election" \
  --data-urlencode "currency_mode=play_money" \
  --data-urlencode "limit=5"

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"])

Sample response (200 OK)

{
  "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": "2024-us-presidential-election",
      "status": "open",
      "markets": [...]
    }
  ]
}

Events

Markets

Orders

Wagers

Account

Realtime (websockets)

Endpoint

Authentication

Request

Response

Example

​Endpoint

​Authentication

​Request

​Response

​Example

Endpoint

Authentication

Request

Response

Example