Find tickers

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

Explanation

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.

GET/api/resolve/ticker

Request

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

Response

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

Example: nosible_world_resolve_v1

qstring

Original ticker lookup query.

Example: NVDA

countinteger

Number of ticker candidates returned.

Example: 1

resultsobject[]

Ranked ticker candidates with type, profile, metadata, reference, filter, and events URL.

Example: [{ kind, type, ticker, name, profile, metadata, reference, events_url, filter }]

as_ofobject

Index build and archive cutoff used for the lookup.

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

Responses and errors

HTTP

200Request succeeded. The body is shown in the response example.

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.

422validation_error — A body field has the wrong type or form, such as a limit sent as a string; the message names it.

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.

503api_key_metering_unavailable — API key usage metering is temporarily unavailable, so the request was not served; wait for the Retry-After header (30 seconds) and retry.

502backend_error — The World backend could not be reached or did not return a valid response; retry shortly.

504backend_timeout — The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.

404unknown_entity_or_ticker — No ticker candidate matched the query within the resolver's accessible universe.