Codex IPO Support
How to connect a Finnhub key, when the optional AI fallback is worth setting up, how to build a watchlist, and what to do when something doesn't behave as expected.
Codex IPO is a personal IPO watchlist. Add the companies you want to follow and the app checks Finnhub's IPO calendar for each one, surfacing confirmed listing dates, expected windows, exchange and pricing as they are published. Where your Finnhub tier has no coverage, an optional AI search — Claude or OpenAI, your choice — looks for recent news instead. Notifications count down to each listing date.
Codex IPO has no backend of its own, so it uses your API keys rather than ours. That keeps your watchlist on your device and puts you in control of what the app costs to run.
The calendar can't be searched without one. A free Finnhub account covers US markets; Asian and European exchanges need a paid Finnhub tier.
Only worth adding if you follow exchanges your Finnhub tier doesn't cover. If you track US listings on a free key, you never need it.
In the iOS Keychain on iPhone, and in AES-256-GCM encrypted storage backed by the Android Keystore. Each key is sent only to the service it belongs to.
Finnhub's free tier is free. AI fallback calls are billed by Anthropic or OpenAI at their rates — picking a smaller model keeps that negligible.
You bring your own key. It stays on your device, and calls go straight from the app to Finnhub.
Launch Codex IPO and tap the gear icon. The Finnhub API key field is at the top of the screen.
Go to finnhub.io/dashboard in your browser, sign in, and copy the API key shown on your dashboard.
finnhub.io/dashboard → API Key
Paste it into the Finnhub API Key field and save. Use Test to confirm the key works before you rely on it.
Tap Detect and the app reports which tier your key has — US only, US + Asia, or US + Asia + EU — so an exchange you can't reach is obvious rather than silently returning nothing.
Optional, and only used where the calendar comes back empty. Choose one provider — Claude or OpenAI — add its key, and pick the model you want to pay for.
In Settings, set Provider to Claude or OpenAI. Only the section for the provider you pick needs a key.
For Claude, open console.anthropic.com/settings/keys. For OpenAI, open platform.openai.com/api-keys. Create a key, name it something you'll recognise, and copy it — neither console shows it again.
Console → API keys → Create key
Paste the key into the matching field in Settings, then use Test Anthropic or Test OpenAI to confirm it works.
Claude offers Haiku 4.5, Sonnet 4 and Opus 4.1; OpenAI offers GPT-5 nano, GPT-5 mini and GPT-5.2. The defaults — Haiku 4.5 and GPT-5 mini — are the sensible balance of speed, cost and quality. Move up only if results are thin.
Your watchlist is the main screen. Add companies, refresh them, and decide how far ahead you want warning.
Tap + and search by company name or ticker.
Choose the right entry from the results rather than the first one. This matters where several entities share a name — picking here is what the app tracks from then on.
The refresh button re-checks every company in one pass, updating dates, pricing and status together.
Every company carries one of five states:
On iPhone, Settings lets you choose how far ahead the countdown starts — anywhere from 3 to 30 days — and the hour it arrives. On Android, alerts begin three days out. Either way they are scheduled locally and nothing about them leaves the device.
Usually a missing or mistyped Finnhub key. Open Settings, confirm the key is there and press Test. Check your connection too.
Check your Finnhub tier with Detect — a free key sees US exchanges only, so a Hong Kong or European listing will look empty. Either upgrade the Finnhub plan or configure the AI fallback.
Confirm the right provider is selected and its key tests clean. Beyond that, the search only surfaces what has actually been reported — for a company that hasn't publicly signalled an IPO there is nothing to find.
Delete it and add it again, taking care at the pick-the-match step.
Check the app has notification permission, and that the company actually has a confirmed date — rumoured windows don't trigger a countdown.
iOS: Settings → Codex IPO → Notifications · Android: Settings → Apps → Codex IPO → Notifications
No. They are held in that device's secure store only, so each device you use needs its key entered once.