Ticker profile

Retrieve one indexed ticker with the same observed metadata as the Ticker Directory and CompanyV4 reference metadata.

GET/api/tickers/profile

Authorizations

Bearer

Authorizationstringrequiredheader

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

symbolstringrequiredquery

Ticker symbol or alternate identifier to look up.

Example: NVDA

id_typeenumquery

Identifier type: symbol, isin, figi, lei, or qid. Defaults to symbol.

Example: symbol

How to use this endpoint

guidance

Use Ticker Profile for one known symbol or alternate identifier. It returns the same observed metadata as Ticker Directory plus CompanyV4 reference metadata.

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 profile contract identifier.

Example: nosible_world_ticker_profile_v1

profileobject

Raw indexed ticker identity, date range, event count, and events URL.

Example: { "kind": "ticker", "type": "TICKER", "name": "NVDA", "normalized": "nvda", "total_events": 15905, "first_date": "2010-01-07", "last_date": "2026-09-16" }

metadataobject

Complete observed event metadata: yearly counts, categorical facets, and numeric summaries.

Example: { "events_by_year": [{ "year": "2026", "count": 4186 }], "facets": {}, "numeric": {} }

referenceobject

CompanyV4 names, websites, identifiers, market data, geography, classification, status, and provenance when available.

Example: { "company_name": "NVIDIA Corporation", "identifiers": { "isin": "US67066G1040" } }

filterobject

Copy-pasteable exact ticker filter.

Example: { "ticker": { "eq": "NVDA" } }

as_ofobject

Index build and archive cutoff used for the profile.

Example: { "archive_cutoff": "2026-09-16" }

Responses and errors

HTTP

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

400invalid_request — The symbol query parameter is required.

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 was minted against a replaced index build. Restart pagination 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.