Adding a company

Give a ticker. It is looked up in the SEC's own ticker-to-CIK map and stored, so this is the only step that ever downloads that map.

⛔⛔ The CIK must be zero-padded to ten digits behind a CIK prefix, and the unpadded form silently 404s. Verified live on 2026-07-30: CIK0000320193 returns 200 and CIK320193, 0000320193 and 320193 all return 404. The map gives cik_str as a plain NUMBER (320193), so this recipe pads it — there is no pad transform, so it adds 10,000,000,000, splits the result into characters, drops the leading digit and rejoins. Ugly, deterministic, and the alternative is a 404 you would have to diagnose.

⚠ The ticker map is the WHOLE market — 10,426 entries, ~800 KB. That is why resolution happens once here rather than on every refresh, and why this recipe is slower than the ones that use the stored CIK.

⚠ A ticker that is not in the map cannot be watched. The map covers SEC registrants; a foreign listing, a fund, or a private company will not be there. The recipe stops and says so rather than storing a company whose refreshes would all fail.

⚠ Tickers are reused. The SEC's map is authoritative for who holds a ticker TODAY; a company that later changes ticker keeps working here, because what is stored is the CIK, not the symbol.