Sign in
forecast

Make an expert forecast for a news event.

Make an expert forecast for a news event.

This endpoint reaches into the news archive, looking back lookback days to extract the most relevant news articles, building a timeline of events, and then making an expert forecast.

This endpoint is more expensive than the search endpoint, it is calling gpt-4o or claude 3-5 on approx 15k tokens to build the forecast. This endpoint counts toward "deep" calls in the billing system.

It returns the forecast, the reasoning, and the sources.

get/v1/chat/forecast

Query parameters

querystring required

The requested forecast.

The requested forecast.

lookbackinteger

The number of days to look back for the forecast.

The number of days to look back for the forecast.

articles_to_useinteger

The total number of relevant articles to be extracted from the news archive and used for the forecast.

The total number of relevant articles to be extracted from the news archive and used for the forecast.

method'kw'

Method to use for the context search Currently only 'kw' is supported.

Method to use for the context search Currently only 'kw' is supported.

model'gpt-4o' | 'gpt-4o-mini' | 'gpt-4.1-2025-04-14' | 'claude-3-5-sonnet-latest' | 'claude-3-5-sonnet-20240620' | 'claude-sonnet-4-20250514' | 'claude-opus-4-20250514' | 'claude-sonnet-4-5-20250929' | 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'o1-mini' | 'o3-mini' | 'o3'

The model to use for the forecast.

The model to use for the forecast.

cutoff_datestring nullable

The cutoff date for the forecast. String format is 'YYYY-MM-DD-HH:MM'. This is useful for backtesting forecasts.

The cutoff date for the forecast. String format is 'YYYY-MM-DD-HH:MM'. This is useful for backtesting forecasts.

use_redditboolean

Whether to use Reddit data for the forecast.enterprise customers only.

Whether to use Reddit data for the forecast.enterprise customers only.

additional_contextstring nullable

Additional context to use for the forecast.

Additional context to use for the forecast.

web_searchboolean

Whether to run a live web search and include results in the forecast. enterprise customers only.

Whether to run a live web search and include results in the forecast. enterprise customers only.

expert'general' | 'sports'

The type of expert to use for the forecast.

The type of expert to use for the forecast.

Response

A fully structured Forecast, complete with research.

forecaststring required
resolution_criteriastring required
datestring date-time required
reasoningstring required
timelinestring[] required
opposite_requeststring required
confidencenumber required
llm_confidenceinteger required
model_usedstring required
likelihoodstring required
probabilityinteger required
summarystring required
key_facetsstring[] required
reconciled_informationstring required
candidate_modelsstring[] required
unique_informationstring required
expert_informationobject

Changes

No recorded changes to this endpoint across all 1 revision of this API.