By ticker

Retrieve the event timeline for a ticker or alternate security identifier.

GET/api/tickers/{symbol}/events

Authorizations

Bearer

Authorizationstringheader

Required Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.

Example: Bearer nos_sk_...

Parameters

query & path

symbolstringrequiredpath

Canonical symbol returned by Resolve, for example NVDA.

Example: NVDA

id_typestringquery

symbol, isin, figi, lei, or qid.

Example: symbol

limitintegerquery

Page size. Use a bounded page size for predictable payloads.

Example: 50

cursorstringquery

Opaque cursor returned by the previous page.

Example: eyJ2Ijox...

orderenumquery

Event ordering, newest or oldest first.

Example: desc

includeenumquery

Projection selector: event_lite or event_full. This is a single query value, not an array.

Example: event_lite

include_vectorbooleanquery

Include stored event vectors when available and permitted.

Example: false

include_livebooleanquery

Include the newest live slices when enabled for the deployment.

Example: true

How to use this endpoint

guidance

Use this route when the security identifier is the natural key for your model. Prefer the canonical symbol from Resolve; id_type lets you query by ISIN, FIGI, LEI, or Wikidata QID when that is what your security master contains.

Response body

application/json

These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.

schemastring

Stable ticker timeline contract identifier.

Example: nosible_world_ticker_events_v1

tickerobject

Resolved symbol, identifier type, and normalized lookup value.

Example: { "symbol": "NVDA", "id_type": "symbol", "normalized": "nvda" }

totalinteger

Total number of matching events before the current page is sliced.

Example: 1842

countinteger

Number of events returned in this page.

Example: 100

eventsobject[]

Event records for the route. The projection varies by endpoint: dated list/search routes return lite records, while global search and full-detail routes can include richer fields.

Example: [{ event_id, event, signals, ontology, coverage }]

next_cursorstring | null

Opaque cursor for the next page. Send it back unchanged; null means the result set is exhausted.

Example: eyJ2Ijox...

orderstring

Applied event order, newest or oldest first.

Example: desc

date_windowobject

Effective date range and archive/live boundary.

Example: { "from": "2026-01-01", "to": "2026-07-20", "archive_cutoff": "2026-07-20", "include_live": false }

live_eventsobject[]

Ephemeral page-one live overlay when requested.

Example: []

hydration_missesinteger

Events that could not be hydrated into the requested projection.

Example: 0

as_ofobject

Index build and archive freshness markers.

Example: { "index_build": "world-v1.2", "archive_cutoff": "2026-07-20" }

took_msnumber

Timeline query duration in milliseconds.

Example: 42

Responses and errors

HTTP

200Request succeeded. The response body is shown in the panel on the right.

400invalid_request — The date, filter, cursor, identifier, or request combination is invalid.

403access_denied — The requested archive date is outside the caller's World tier.

404not_found — The requested date, entity, ticker, or event does not exist in the accessible index.

410cursor_expired — The cursor belongs to a replaced index build; restart from the first page.

429rate_limited — The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.

501backend_not_configured — The World backend is not configured for this deployment.

502backend_error — The BFF could not obtain a valid response from the World backend.

504backend_timeout — The World backend or an upstream data source timed out.

404unknown_ticker — The requested symbol or identifier does not resolve to an indexed security.