Find tickers

Resolve a ticker symbol, issuer name, or alternate security identifier without returning entity candidates.

GET/api/v2.0-preview/resolve/ticker

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

qstringrequiredquery

Ticker symbol, issuer name, or alternate security identifier.

Example: NVDA

limitintegerquery

Maximum number of ticker candidates; defaults to 10 and is capped at 50.

Example: 3

How to use this endpoint

guidance

In V2.0-preview, each ticker names the Atlas entity of its issuing company in reference.entity, so a ticker leads straight to that company's Atlas graph. Use the ticker resolver when the input is a symbol, issuer name, or alternate security identifier. Each result includes the same profile metadata as Ticker Profile.

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

Response schema name.

qstring

The query.

countinteger

Ticker candidates found.

resultsobject[]

Ticker candidates, best first, each with its issuer's reference data and Atlas entity in reference.

results[].namestring

The entity's canonical Atlas name, or the issuer's name for a ticker.

results[].tickerstring

Symbol with its exchange suffix (tickers only), such as NVDA.US.

results[].identifiersobject

isin, figi, lei and wiki_qid of the security (tickers only).

results[].matchstring

How the query matched: exact, prefix or fuzzy.

results[].scorenumber

Ranking score; higher is better.

results[].total_eventsinteger

Indexed events of the candidate.

results[].first_datedate

Date of its earliest indexed event.

results[].last_datedate

Date of its latest indexed event.

results[].events_urlstring

The candidate's event timeline on this API version.

results[].filterobject

Ready-made World Search filter for the candidate.

results[].profileobject

The same identity fields as the candidate's profile endpoint.

results[].metadataobject

What the indexed events of this entity look like: events_by_year, facets (the top 20 values of each categorical event field, such as language, country, sentiment and every taxonomy level) and numeric (count, missing, sum, min, max and mean of lat, lng, total_coverage, total_netlocs, coverage_concentration_index and materiality_score).

results[].metadata.events_by_yearobject[]

Events per year: {year, count}.

results[].metadata.facetsobject

Top values of each categorical field: {field: [{value, count}]}.

results[].metadata.numericobject

Summary statistics of each numeric field.

results[].referenceobject

Reference data for the issuer: its Atlas entity, name, website, identifiers, listing, country and classification. Each part is present only when it is known.

results[].reference.entityobject

The issuer's Atlas entity, {type, name}: the entity the Atlas API and the entity endpoints use. Absent when the ticker is not mapped to an Atlas entity.

results[].reference.entity.typestring

NER type of the issuer's entity: ORG.

results[].reference.entity.namestring

Canonical Atlas name of the issuer, such as Nvidia.

results[].reference.company_namestring

Issuer name.

results[].reference.websitesobject

Issuer websites: website.

results[].reference.websites.websitestring

Main website of the issuer.

results[].reference.identifiersobject

Identifiers of the issuer and security.

results[].reference.identifiers.isinstring

ISIN of the security.

results[].reference.identifiers.leistring

LEI of the issuer.

results[].reference.identifiers.figistring

FIGI of the security.

results[].reference.identifiers.wiki_qidstring

Wikidata identifier of the issuer.

results[].reference.identifiers.companyv5_idstring

NOSIBLE company identifier of the issuer.

results[].reference.marketobject

Listing: exchange and mic.

results[].reference.market.exchangestring

Exchange of the listing.

results[].reference.market.micstring

ISO 10383 market identifier code of the exchange.

results[].reference.geographyobject

Issuer country: country_iso.

results[].reference.geography.country_isostring

ISO 3166-1 alpha-2 country of the issuer.

results[].reference.classificationobject

GICS classification of the issuer: sector and industry.

results[].reference.classification.sectorstring

GICS sector.

results[].reference.classification.industrystring

GICS industry.

results[].kindstring

ticker.

results[].typestring

TICKER.

as_ofobject

index_build and archive_cutoff: the index that answered.

took_msinteger

Server time in milliseconds.

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.

401api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.

401invalid_api_key — The API key is invalid or has been revoked.

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.

503api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.

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_entity_or_ticker — No ticker candidate matched the query within the resolver's accessible universe.