List events

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

Endpoint

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

Authentication

This endpoint does not require authentication. You can call it without any headers.

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 placed bets.

integer

Number of results to return per page.

boolean

default:"false"

When true, returns only live events.

integer

The initial index from which to return the results.

boolean

default:"false"

When true, returns only events containing markets you follow.

string

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

boolean

default:"false"

When true, returns only events pending resolution.

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.

Response

Returns a paginated list of events.

integer

required

Total number of events matching the query.

string

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

string

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

array

required

Array of event objects.

Example

curl --request GET \
  --url "https://api.futuur.com/v2.0/events/?currency_mode=play_money&limit=10"

import requests

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

print(response.json())

const response = await fetch(
  "https://api.futuur.com/v2.0/events/?currency_mode=play_money&limit=10"
);

const data = await response.json();
console.log(data);

Sample response

{
  "count": 1234,
  "next": "https://api.futuur.com/v2.0/events/?limit=10&offset=10",
  "previous": null,
  "results": [
    {
      "id": 42,
      "title": "Who will win the 2024 US Presidential Election?",
      "slug": "who-will-win-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