Semantic Search
Point-in-time and utility-filtered passage retrieval over Ultralayer's financial corpus (1-8 queries).
Semantic Search › Request Body
queriesmax_tokensSnippet token budget
System timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
Exact metadata include/exclude filters.
Match any.
0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical
-1..1; +-.2 neutral; +-.2-.6 mod; +-.6+ strong; mutually exclusive with max_sentiment_score
detailessential:minimal; standard:citable; full:all.
Semantic Search › Responses
Semantic search results at detail=full.
timestampSystem imestamp of the document.
document_idIdentifier of the indexed document.
Title of the source document, if available.
snippetsPassage texts from this document, ordered as they appear in the document.
snippet_cosine_similaritiesCosine similarity of each snippet to the query. Same length and order as snippets.
o200k_base_n_tokenso200k_base token count of the returned snippets.
canonical_entity_namesCanonical entity names across the returned snippets.
utility_scoreToken-weighted utility score of the returned snippets, between 0.0 and 1.0.
sentiment_scoreToken-weighted sentiment score of the returned snippets, between -1.0 and 1.0.
Source information.
Identify Stakeholders
Identify key stakeholders for a query, with optional context and instructions. Commonly ~2 minutes; call once. For Chat Agents: [If a user is waiting on this turn, tell them it takes ~2 minutes and get explicit approval before calling. If no one is waiting (one-shot / autonomous), call and wait.]
Identify Stakeholders › Request Body
queryAdditional context
Additional guidance
As-of system timestamp; inclusive ISO 8601; null=realtime
detailessential:minimal; standard:scored+citable; full:all.
Identify Stakeholders › Responses
Stakeholder identification response at detail=full.
List of identified stakeholders with their impact details.
Comparison dimensions for stakeholders relating to the situation.
Search Developments
Search for developments semantically (or not). Various filters available: timestamp, development type, stakeholder impact, symbols, and more.
Search Developments › Request Body
System timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
Real-world occurrence timestamp; Inclusive ISO 8601
Real-world occurrence timestamp; Inclusive ISO 8601
Match any.
+-.5+ strong; 0..+-.5 weak; 0 neutral; both: >=min OR <=max
0-.2 noise; .2-.4 minor; .4-.6 expected/mod; .6-.8 material; .8-1 critical
0-.2 known; .2-.4 expected; .4-.6 modest; .6-.8 notable; .8-1 shock
<.2 unreliable; .4-.6 incomplete; .6+ strong; .8+ explicit
limitdetailessential:minimal; standard:scored+citable; full:all.
Search Developments › Responses
Developments at detail=full.
development_idLogical identifier for the development across updates.
timestampCanonical backtest system timestamp of this development version.
source_timestampMost recent timestamp of any source used for the development.
occurrence_timestampActual (estimate of) real world time that the development took place.
occurrence_timestamp_confidence_scoreConfidence score in estimate of occurrence_timestamp.
nameName of the development.
descriptionDescription of the development.
development_typeType of the development.
occurrence_statusStatus of the real world occurrence.
rationaleExplanation for all decisions made.
List of involved stakeholders and their impacts.
importance_scoreLLM heuristic of general development importance.
surprise_scoreLLM heuristic of how surprising the development is to the market.
confidence_scoreLLM heuristic of its confidence in everything it presents.
List of events this development is associated with, resolved to their most recent known state.
List of sources used for this development.
Retrieve Development
Retrieve a specific development by its ID.
Retrieve Development › Request Body
development_idSystem timestamp; Inclusive ISO 8601; null=realtime
detailessential:minimal; standard:scored+citable; full:all.
Retrieve Development › Responses
Development at detail=full.
development_idLogical identifier for the development across updates.
timestampCanonical backtest system timestamp of this development version.
source_timestampMost recent timestamp of any source used for the development.
occurrence_timestampActual (estimate of) real world time that the development took place.
occurrence_timestamp_confidence_scoreConfidence score in estimate of occurrence_timestamp.
nameName of the development.
descriptionDescription of the development.
development_typeType of the development.
occurrence_statusStatus of the real world occurrence.
rationaleExplanation for all decisions made.
List of involved stakeholders and their impacts.
importance_scoreLLM heuristic of general development importance.
surprise_scoreLLM heuristic of how surprising the development is to the market.
confidence_scoreLLM heuristic of its confidence in everything it presents.
List of events this development is associated with, resolved to their most recent known state.
List of sources used for this development.
Retrieve Event Developments
Retrieve all developments associated with a known event_id. Filters for timestamp and occurrence are available. Track and understand the full event lifecycle through its developments.
Retrieve Event Developments › Request Body
event_idSystem timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
limitinclude_future_developmentsInclude future occurrence times relative to end_timestamp or now.
detailessential:minimal; standard:scored+citable; full:all.
Retrieve Event Developments › Responses
Event with developments at detail=full.
event_idLogical identifier for the event.
nameName of the event.
descriptionDescription of the event.
event_typeType of the event.
Developments associated with this event, ordered by occurrence_timestamp descending (real-world timeline).
Search Events
Search for events semantically (or not). Various filters available: timestamp, occurrence, event type, symbols, and more.
Search Events › Request Body
System timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
Match any.
limitdevelopments_per_eventinclude_future_developmentsInclude future occurrence times relative to end_timestamp or now.
detailessential:minimal; full:all.
Search Events › Responses
Events at detail=full.
event_idLogical identifier for the event.
nameName of the event.
descriptionDescription of the event.
event_typeType of the event.
Most recent developments for this event (count controlled by developments_per_event param), ordered by occurrence_timestamp descending.
List Wire
Return the most recent wire items that match the given filters.
List Wire › Request Body
System timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
max_recordsMatch any.
Match any.
Match any.
Match any.
Match any.
Match any.
Match any.
Match any.
+-.2 neutral; +-.2-.6 mod; +-.6+ strong; both: >=min OR <=max
Match any.
Match any.
Match any; lowercase ISO 3166-1 alpha-2
Match any.
Match any.
0-.2 noise; .2-.4 low; .4-.6 mod; .6-.8 high; .8-1 critical
<.2 anon; .4-.6 mod; .6+ reputable; .8+ official
detailessential:minimal; standard:citable; full:all.
List Wire › Responses
Wire items at detail=full.
wire_idPrimary key of the wire row.
timestampCanonical system time when this item was put on the wire.
source_timestampSource last-update time.
headlineUltralayer-generated headline.
Normalized publisher/source label, when known.
urlLink to the original item.
content_typeKind of item.
categoriesMulti-label event/theme tags.
recencyWhether the item is about now, the past, or the future.
source_relationshipHow close the source is to the information.
factualityEpistemic status of the item's core claim.
noveltyStory-lifecycle label relative to prior wire items.
Matched earlier wire item for update|duplicate|correction; null for new.
trustworthiness_score0..1 source credibility score.
importance_score0..1 market-importance score.
Market-level scope dimensions (sectors, industries, countries, asset_classes).
Grounded entities with per-entity relevance and sentiment.
Wire Storyline
Retrieve the novelty storyline for a wire item: the linear prior_wire_id ancestor chain plus first-degree branches (items that point at any ancestor).
Wire Storyline › Request Body
wire_idSystem timestamp; Inclusive ISO 8601
System timestamp; Inclusive ISO 8601; null=realtime
Match any.
max_ancestor_depthAncestor cap, including seed.
max_childrenBranched children cap
detailessential:minimal; standard:citable; full:all.
Wire Storyline › Responses
Wire storyline at detail=full.
seed_wire_idThe wire_id that was requested.
Wire id of the novelty root (prior_wire_id IS NULL) when the ancestor walk reached it; null when the walk stopped early (time window or depth cap).
Storyline members ordered by source_timestamp ascending.
Retrieve Entity
Realtime context package for one entity.
Retrieve Entity › Request Body
entityEntity name
Retrieve Entity › Responses
Successful Response
timestampCanonical system timestamp when this package was assembled.
Resolved entity identity.
Most recent non-duplicate wire items where this entity is primary or significant.
Calendar-day bars (oldest first). Empty days are null, not omitted.
Top co-mentioned entities from a bounded recent sample of primary/significant wire items.