Frequently asked questions

General

How do I share what I'm looking at?

Permalinks. Most panels have a Share action that copies a URL encoding the panel state, focused symbol, filters, and time range. The recipient opens the same view, same selection, same moment. See How do I — Share a permalink.

What's the difference between Atlas and a typical trading terminal?

A trading terminal shows you what the market is doing. Atlas adds the OSINT layer — vessels, aircraft, geolocated news — and lets you correlate market moves with real-world events on a single 3D globe. The Security dashboard adds ~30 sub-panels of fundamental analysis per ticker on top of that.

Is Atlas free to use?

The codebase is governed by the repository's LICENSE file — self-hosting is fully open. Pricing for the hosted plan will be announced before the public launch; see Account & billing for the current state of the billing flow and the roadmap entry in the Changelog.

How do I report a bug or request a feature?

Open an issue on the repository. For security issues, follow the disclosure process described in the project's SECURITY.md — do not file a public issue for security reports.

What languages is Atlas available in?

The application UI ships in six locales: English, German, Spanish, French, Russian, Chinese. The documentation site is currently English-only; additional doc locales are on the roadmap.

Data

Where does the data come from?

Public and licensed providers — Finnhub for equity quotes, EODHD for end-of-day and fundamentals, OpenSky for ADS-B, MarineTraffic for AIS, Cesium Ion for the 3D globe. Every provider is integrated through the Atlas backend. See Data providers.

Are quotes real-time?

It depends on the source and your plan. Finnhub free tier delays some exchanges; the paid tier is sub-second for supported exchanges. EODHD is EOD-only on the free tier. Each Market panel quote is labeled realtime or delayed. Full breakdown in Data delays & limits.

Why doesn't AIS / ADS-B show vessel/aircraft X?

Three common reasons:

1. The transponder is off — voluntarily (any vessel can disable AIS) or by design (some aircraft transmit limited or no ADS-B).
2. Coverage gap — mid-ocean AIS and remote-airspace ADS-B are sparse.
3. The provider hasn't published the most recent position yet — there's lag between transmission and the upstream feed.

Absence of pin ≠ absence of entity.

Why does an EODHD fundamentals number disagree with the company's filing?

EODHD parses filings on its own cadence — there's typically a several-hour to several-day lag, and parsed fields can differ from the raw filing on rare edge cases. For the freshest numbers, read the filing directly from Security dashboard → Disclosures → Filings.

Functionality

Which instruments are supported?

Equities (any Finnhub symbol), FX pairs, crypto pairs, and major commodities. The glossary covers the metrics shown across the platform.

Does Atlas store my watchlist on your servers?

Once you sign in, watchlists sync across devices via the Atlas backend. If you don't sign in, they live in your browser's local storage only and disappear when you clear the cache.

What's the difference between the Market panel and the Security dashboard?

The Market panel is for active trading and quick views — quote, candle, performance, technical, fundamental. The Security dashboard is for deep analysis — five categories totaling ~30 sub-panels per ticker, including transcripts, filings, and analyst estimates.

Can I build my own charts?

Yes — MyGraphs is a multi-series chart builder with spreads, ratios, and basic arithmetic across symbols and fundamentals.

How many alerts can I have?

Soft cap of ~100 active alerts per user. The composer warns above that. There's no hard limit, but very large alert counts degrade UX.

Security and privacy

How do you handle API keys and secrets?

Server-side only. The backend reads keys from os.environ. The frontend never sees provider keys — only VITE_* variables that are safe to be public (e.g., the Cesium Ion access token). The frontend never calls Finnhub, EODHD, OpenSky, MarineTraffic, or Stripe directly. See Data providers.

Should I enable 2FA?

Yes, especially for OSINT-tier accounts. Use a TOTP app, not SMS. Print recovery codes to offline storage. See Settings → Security and OSINT operational security.

What does Atlas log about me?

Method, path, status, latency, and user ID for authenticated requests. Backend deliberately strips upstream api_token query params from logs. Request and response bodies are not logged in default config. See OSINT operational security → What Atlas logs for detail.

What does the AI chat see?

Your active panel's data, your watchlist, the focused symbol, the glossary, and your conversation history within the active thread. It does NOT see other browser tabs, files, or anything not currently visible in your authenticated session. Boundary enforced server-side. See AI chat.

Deployment

Can I self-host Atlas?

Yes — the stack is FastAPI + React + PostgreSQL + Redis. See Self-hosting for the supported deployment shapes and required env vars. You'll need your own API keys for the upstream data providers.

Can I deploy without Stripe?

Yes — Stripe env vars are only required if you're running paid plans. Without them, all users default to free-tier feature flags. See Self-hosting.

Where do the docs live?

VitePress static site at apps/docs/. Independent of the main app. Build with npm run build, deploy as static. See the project README for the full deploy path.

I have a question that isn't here

Open an issue. Common questions get added back into this FAQ over time.