Find the exact symbol to pass to every other tool. A US listing is its bare ticker (`AAPL`, `BRK-B`); a listing on another exchange is `MIC:TICKER`, its market identifier code and ticker (`XETR:SIE`, `XLIS:NOS`). Every symbol these tools print is accepted back by the price, company and dataset tools.

## SearchListings

Find listings by company name or ticker (`query`), by ISIN (`isin`), or list every listing of one exchange (`exchange`) or country (`market`). Search ranks exact tickers first, then names, then larger companies. An ISIN returns every listing of that security, each in its own currency; a US or Canadian ISIN also matches a US listing by the CUSIP it embeds. A security type reads `—` where no registration states it.

**Parameters:** `query` or `isin` (not both); optional `exchange` (an exchange code from `ListExchanges`, to narrow a search or list one exchange); `market` (a country code, used on its own); `maxResults` (default 20, max 500); `offset`.

**Ask:** *"Which listing does ISIN US0378331005 belong to?"*

**Returns:**

```
Listings of ISIN US0378331005:

Symbol | Company | Country | Currency | ISIN | Type | Main listing
-------|---------|---------|----------|------|------|-------------
AAPL | Apple Inc. | US | USD | — | — | yes
```

## GetStockProfile

One listing and the company behind it: the description, website, sector and industry, SEC CIK, LEI and fiscal year end, the security's ISIN and type, and the company's other listings with the symbol each is read by.

**Parameters:** `ticker` (required — a bare US ticker or `MIC:TICKER`).

**Ask:** *"What is Siemens' Xetra listing, and where else does it trade?"*

**Returns:**

```
# Siemens Aktiengesellschaft (XETR:SIE)

- Listing: XETR:SIE, DE, trades in EUR, main listing
- Security: —, ISIN DE0007236101
- Sector / industry: Industrials / Specialty Industrial Machinery
- LEI: W38RGI023J3WT1HWRP32
- Website: https://www.siemens.com/
```

## ListExchanges

The markets listings are covered on: the US directory and each exchange outside the US, with the exchange codes its listings are written under, its country code, main currency, regular session in local time, and listing count.

**Parameters:** none.

**Ask:** *"Which European exchanges can I read prices for?"*

**Returns** (trimmed):

```
Covered markets:

Market | Country | Exchange codes | Currency | Session (local) | Listings
-------|---------|----------------|----------|-----------------|---------
United States | US | — (bare ticker) | USD | 09:30–16:00 America/New_York | 15,967
Euronext Lisbon | PT | XLIS, ENXL, ALXL | EUR | 08:00–16:30 Europe/Lisbon | 43
Xetra | DE | XETR | EUR | 09:00–17:30 Europe/Berlin | 439
```