Help Center
Developer docs
doc.astreus.ai →01
How do I create an account?
Open the home page and choose Register. You need an email address and a password; a verification code is emailed to you and the account is live as soon as you enter it. No payment details are asked for.
I didn't get the verification email.
Check spam first — the message comes from our no-reply address. If it still hasn't arrived after a few minutes, request a new code from the sign-in screen. Codes expire, so always use the most recent one.
I forgot my password.
Use Forgot password on the sign-in screen. You'll get a reset code by email; entering it lets you set a new password. For security the reset never reveals whether an address has an account.
What should I do first?
Connect the agent you already use (next section) and ask it about a company you know well, including the world around it: its central bank, its government, the ports its goods leave from. Then open the same company in the terminal and click a single number in its income statement: the jump to the source filing is the fastest way to see whether the data is trustworthy for your work.
02
How do I add Astreus to Claude?
In Claude, open Settings → Connectors → Add custom connector and paste https://astreus.ai/api/mcp. Claude sends you to Astreus to sign in and approve read-only access; no API key is needed. It works on Claude mobile too, and you can revoke it from Claude's connector settings at any time.
What about Claude Code, Cursor, VS Code or my own agent?
Those clients connect to the same address with an API key from the developer portal, sent as Authorization: Bearer pk_live_…. The MCP server guide has the exact command or config for each client. Inside the terminal, Analyst Hub → AI Agent Settings walks through the same steps for Claude, ChatGPT and Copilot.
Which tools does the agent get?
Companies (statements, segments, filings, transcripts, guidance, ownership, people), macro and central banks, government, markets and assets. The connected server's tools/list is the authoritative list; the tool reference documents each one.
How do I check what my agents have used?
Analyst Hub → AI Agent Settings in the terminal shows, beside Connect your agent, what your connected apps have asked for. Agent calls are metered on your plan, the same as API calls.
Is there an Astreus agent of its own?
Yes: Agent → Agent Chat, an agent that researches your files and works in Excel, Word and PowerPoint, steered by you. It is in early access, so most accounts see it but can't use it yet. Ask us if you'd like to try it.
04
What's on a company page?
Income statement, balance sheet and cash flow (annual, quarterly and trailing twelve months), ratios, segments and KPIs, filings, transcripts and events. Pro adds Guidance inside Financials, Storyline, and the Map of physical assets. Statements default to the latest restated figures.
Why does a company I searched for not appear?
Because it hasn't cleared review yet. A company becomes visible when its filings parse cleanly and its statements reconcile, not when its ticker is known. The coverage guide lists every market served, and coverage requests are how the queue gets prioritised.
A figure is blank. Does that mean zero?
No — and this distinction matters. A blank cell means either the company never reported that line, or the value failed validation and was withheld rather than served. Astreus never substitutes a zero for a missing number, so an empty cell is always “not available”, never “nil”. Agents get the same distinction: a null, never a zero.
Can I see what was originally filed rather than the restatement?
Yes. Statements can be switched to an as-reported basis, which shows the figures as they appeared in the original filing rather than as later revised. Use as-reported when you're reconstructing what the market knew at the time, and the default restated basis when you want today's best estimate of history.
05
Click a cell in a financial statement and Astreus opens the document it came from at the figure itself: for SEC filers, the exact inline-XBRL fact, matched by its concept and reporting context rather than by a text search that might land on the wrong table; for companies that file documents rather than XBRL, the page the figure sits on.
Standardization is visible rather than hidden: where a reported line has been mapped into a standard concept, the mapping is shown, so you can disagree with it and go back to the raw fact. Older filings, or filings still in the queue, may not have a traceable target yet, and the viewer says so instead of guessing.
Agents get the same trace through the API's fact-source endpoint and the MCP server's get_fact_source tool, which return the filing, period and location for any served figure.
06
What's on a country page?
An Overview, then the Economy (growth, labour, prices, trade, fiscal and more), the Government (its leadership, the legislature and the bills moving through it, and the courts) and Money & Prices (the central bank: its leadership, the policy rate, credit, money supply and the yield curve). Overview is free; the other sections are Pro.
Why did a historical value change?
Because statistical agencies revise. Macro series are stored point-in-time, meaning every vintage is kept: the value that was published on a given date is still retrievable after it is revised. That's what makes a back-test honest — you can ask what the number was believed to be at the time, instead of what it was later corrected to.
Where are international organisations and conflicts?
Under Research → Macro. Organisations lists every international body with its members in joining order, and each member's page shows its seat and record there. Conflicts lists armed conflicts as events of their own, with every party on each side; a party state opens its country page.
And currencies?
Research → More Research → FX shows any base currency against every other, from the last close to ten years, and every pair has its own page with its own news. Crypto sits next to it, priced in any currency (data provided by CoinGecko).
07
The Map (a Pro surface) is geographic information rebuilt for finance. Its layers show live shipping (AIS) on the sea lanes, the ports vessels call at and the chokepoints they pass; live flights (ADS-B) between the world's airports; and every active satellite in orbit, each linked to the company that holds it.
A company's own Map tab draws its physical assets, such as buildings and toll gates, where they are. Only reviewed, sourced assets are shown, so a company with no reviewed assets yet has an empty map rather than a guessed one.
08
How do I get an API key?
From the developer portal. Keys are created, rotated, and revoked there, and the same page shows your usage against your plan's limits. Pass the key as an X-API-KEY header.
What are the limits?
Per plan, and published as numbers on the pricing page. When you exceed one the API returns 429 along with how many seconds to wait — back off on that value rather than retrying immediately.
Is there anything for agents and LLM tooling?
Yes. Alongside the OpenAPI 3.1 spec at /openapi.json, there are machine-readable descriptions at /llms.txt, /agents.md, and /skill.md, plus an MCP manifest at /.well-known/mcp.json.
Do I have to cite Astreus?
You don't have to cite us, but you should cite the filing. Every figure the API returns can be resolved to its accession number and period; carrying that through into whatever you build is what keeps the output auditable for whoever reads it next.
09
Where do I manage my subscription?
Settings → Billing. Upgrades, invoices, payment methods, and cancellation all run through the Stripe customer portal from there. Cancelling stops the next renewal and leaves access in place until the end of the period you've paid for.
Can I turn analytics off?
Yes, and it's off until you turn it on. Usage measurement is strictly opt-in behind the consent banner, and you can change your mind at any time in Settings. See the Privacy Policy for exactly what is and isn't collected.
How do I export or delete my data?
To delete your account and its data yourself, open Settings › Account Controls and confirm with the code we email you. For a copy of your personal data, email saif@astreus.ai from the address on the account and we'll send it. Note that company and macro data isn't personal data — it comes from public filings and stays regardless.
Something looks wrong in the data.
Please tell us, and include the company, the line item, and the period. Data corrections are the highest-priority class of bug report here — a wrong number that looks confident is worse than a missing one.