zfin/docs/reference/cli/lookup.md

zfin lookup

Resolve a CUSIP (9-character security identifier) to its ticker via the OpenFIGI API.

Usage: zfin lookup <CUSIP>

Successful results are cached indefinitely in cusip_tickers.srf. OPENFIGI_API_KEY raises the rate limit, but the unauthenticated tier works for low volume. Mutual funds frequently have no OpenFIGI coverage; the command says so and suggests a manual portfolio entry.

Example

zfin lookup 037833100

037833100  →  AAPL

Use this when a holding in your portfolio is identified by CUSIP (e.g. a 401k share class) and you need its ticker for a ticker:: alias. See ticker aliases.

See also

• portfolio.srf reference -- using ticker:: aliases.
• Environment variables -- OPENFIGI_API_KEY.

---

CLI command reference