ASasknews
forecast

Make an expert forecast for a news event.

Changed on

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

Request

Query parameters

querystring required

The requested forecast.

lookbackinteger

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.

method'kw'

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.

cutoff_datestring nullable

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.

additional_contextstring nullable

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.

expert'general' | 'sports'

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

  • 6513c99e2917Revision changes
    • info

      added the optional property ////// to the response with the status

  • f1818f4f772bRevision changes
    • breaking

      the response property // became optional for the status

    • breaking

      the response property // became optional for the status

    • breaking

      response property sources/items/centroid_distance list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property sources/items/cluster_probability list-of-types was widened by adding types null to media type application/json of response 200