HAS_MCP_EQUIVALENT

Search Developments

Search for developments semantically (or not). Various filters available: timestamp, development type, stakeholder impact, symbols, and more.

post/v0/search/search_developments

Request

Base URL: https://api.ultralayer.ai
URL: https://api.ultralayer.ai/v0/search/search_developments
Auth: HTTP bearer

Request body

querystring nullable

start_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601

end_timestampstring date-time nullable

System timestamp; Inclusive ISO 8601; null=realtime

start_occurrence_timestampstring date-time nullable

Real-world occurrence timestamp; Inclusive ISO 8601

end_occurrence_timestampstring date-time nullable

Real-world occurrence timestamp; Inclusive ISO 8601

development_typestring nullable

symbolsstring[] nullable

Match any.

min_impact_scorenumber nullable

+-.5+ strong; 0..+-.5 weak; 0 neutral; both: >=min OR <=max

max_impact_scorenumber nullable

min_importance_scorenumber nullable

0-.2 noise; .2-.4 minor; .4-.6 expected/mod; .6-.8 material; .8-1 critical

min_surprise_scorenumber nullable

0-.2 known; .2-.4 expected; .4-.6 modest; .6-.8 notable; .8-1 shock

min_confidence_scorenumber nullable

<.2 unreliable; .4-.6 incomplete; .6+ strong; .8+ explicit

limitinteger

detail'full' | 'standard' | 'essential'

essential:minimal; standard:scored+citable; full:all.

Example request

{
  "query": "Semiconductor supply chain disruptions",
  "development_type": "corporate_action",
  "symbols": [
    "NVDA",
    "AAPL"
  ]
}

Response

Developments at detail=full.

development_idinteger required

Logical identifier for the development across updates.

timestampstring date-time required

Canonical backtest system timestamp of this development version.

source_timestampstring date-time required

Most recent timestamp of any source used for the development.

occurrence_timestampstring date-time required

Actual (estimate of) real world time that the development took place.

occurrence_timestamp_confidence_scorenumber required

Confidence score in estimate of occurrence_timestamp.

namestring required

Name of the development.

descriptionstring required

Description of the development.

development_typestring required

Type of the development.

occurrence_statusstring required

Status of the real world occurrence.

rationalestring required

Explanation for all decisions made.

importance_scorenumber required

LLM heuristic of general development importance.

surprise_scorenumber required

LLM heuristic of how surprising the development is to the market.

confidence_scorenumber required

LLM heuristic of its confidence in everything it presents.

Changes

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