Resolve a ticker to a company

Resolve an exchange-qualified ticker (`TSX:ABC`) or a bare symbol (`ABC`) to a Pulse company, so you can join Pulse data onto your own ticker-keyed records. Only active listings are considered. A bare symbol listed on several exchanges resolves to a list of candidates rather than a single match — qualify it with the exchange to disambiguate.

GET/v1/companies/lookup/

Authorization

apiKeyAuth

AuthorizationBearer <token>

Organization API key, format pulse_<prefix>_<secret>. Created by an organization admin in Settings -> API Keys.

In: header

Query Parameters

ticker*string

Exchange-qualified ticker (EXCHANGE:SYMBOL) or a bare symbol.

Response Body

The resolution. Neither a unique match nor any candidate is guaranteed.

Resolution of a ticker to a Pulse company.

matched is set only when exactly one active listing matches; otherwise it is null and candidates lists every active listing for the symbol so the caller can disambiguate (typically by exchange).

ticker*string

The ticker you asked about, trimmed and echoed back.

matched?|

{company_id, listing_id, verbose_ticker, company_name} on a unique match; otherwise null.

candidates*array<>

Every active listing matching the symbol when the match was not unique; empty on a unique match.

{  "ticker": "TSX:ABRA",  "matched": {    "company_id": 5700,    "listing_id": 1255,    "verbose_ticker": "TSX:ABRA",    "company_name": "AbraSilver Resource Corp"  },  "candidates": []}