Company Financials API
Company financial data from official filings: 4.26 million entities in thirteen markets, most of them private companies. Except where a market uses a stated proxy date, every figure is keyed to its filing date. A REST API that returns JSON or CSV, usable from curl, Python or an AI agent.
Authentication
Send a key as a bearer token.
# runs as it is, on the demo key
curl "https://www.tradingagentapp.com/api/v1/fundamentals?ticker=AAPL&view=latest" \
-H "Authorization: Bearer demo"
# with your own key
curl "https://www.tradingagentapp.com/api/v1/fundamentals?ticker=AAPL&view=latest" \
-H "Authorization: Bearer ta_live_xxxxxxxx"- Demo key: literally the word
demo. Every company in the warehouse at its most recent reported fiscal year, all fields, at the demo limits below. No signup. - Evaluation key: 30 days for a work email. Full history including
as_of, up to 1,000 entities, a daily cap, no bulk files, for internal evaluation only, one key per email domain, under an electronically signed Evaluation Order Form. Free-mail addresses get the standard free key. Get an evaluation key. - Your own key: created at /account/api-keys. Full history and
as_ofneed a Personal or Commercial data licence (up to a company limit: see Rate limits); bulk files come with the Redistribution Licence and, where the Order Form says so, OEM. Plans and licences: /fundamentals.
Free Data (the demo key, free keys, the sample file, the data pages and per-company downloads) is supplied under the ; using it means you accept that licence. Free and demo responses say so in their field.
Rate limits
These are the published rate limits the licence documents refer to (Data Terms clause 22.6). A request over a limit gets HTTP 429 with Retry-After and X-RateLimit-* headers. We do not lower a paid tier's limit during a period already paid for. Whole-market bulk files are cheaper than paging the API. To test a loader and a hash check first, use the dated bulk sample: 250 US companies in the bulk files' format, with a SHA-256 manifest.
| Demo key (demo) | 60 requests a minute and 2,000 a day, per IP address |
| Remote MCP server, no key | 60 requests a minute and 2,000 a day per connection (MCP session; search_companies at the no-key search limits), and at most 1,000 a minute and 50,000 a day for all connections from one IP address together. A client that keeps no session is counted per IP address, as the demo key. With a key, the key's own limits |
| Free key | 120 a minute and 5,000 a day, per key |
| Evaluation key (30 days) | 120 a minute and 2,000 a day, per key; each call can return a company's full history and every as_of date |
| No key (search, quality, coverage) | 120 a minute on each (the coverage check: 20) and 3,000 a day shared by the three, per IP address; the coverage check also refuses an address over 5,000 lines in an hour |
| Per-company downloads (data pages) | the limits of your account's tier, counted per IP address; signed out, the free-key limits |
| Snapshot files |
GET /api/v1/fundamentals
Annual accounts and financial statements from official filings: France (INPI, 1,494,415 companies with filings from 2017, mostly private), Belgium (National Bank of Belgium, 722,869 companies, statutory accounts from April 2019), Denmark (Danish Business Authority, 552,535 companies, published annual reports), Sweden (Bolagsverket, 586,163 companies, digitally submitted annual reports from 2020), Estonia (e-Business Register, 330,369 companies, financial years from 2019), Slovakia (Register of Financial Statements, 371,911 companies, financial years from 2019), Latvia (Register of Enterprises, 148,665 companies, periods ending 2020 or later), Japan (FSA EDINET, 4,961 filers of an annual securities report, listed and unlisted, from 2016), New Zealand registered charities (Charities Register), and listed issuers from US SEC EDGAR (annual and quarterly, from 2014), Taiwan TWSE and Korea OpenDART. For Australia the data are tax figures, not accounts: total income, taxable income and tax payable for 6,584 large entities, from the Australian Taxation Office, dated by the ATO's publication. Every figure is keyed by its filing date: query with as_of and you get only filings dated on or before that day (a point-in-time query). A later restatement never overwrites an earlier figure (see the methodology). Many Belgian and Danish filers publish gross profit rather than turnover, so revenue is sparse there; each market's manifest states its reporting basis and the methodology gives fill rates, which GET /api/v1/fundamentals/quality serves with no key.
# works right now: public demo key, no signup
curl "https://www.tradingagentapp.com/api/v1/fundamentals?ticker=2330.TW" \
-H "Authorization: Bearer demo"
# a private French company, by SIREN
curl "https://www.tradingagentapp.com/api/v1/fundamentals?ticker=387949530.FR&view=latest" \
-H "Authorization: Bearer demo"
# filings dated on or before 2022-01-01 (full history: see Authentication)
curl "https://www.tradingagentapp.com/api/v1/fundamentals?ticker=AAPL&as_of=2022-01-01&view=latest" \
-H "Authorization: Bearer ta_live_xxxxxxxx"| ticker | the entity's ID: see ID formats below (AAPL, E01766.JP, 387949530.FR …). Omit for the coverage index (markets, tickers, manifests). |
ID formats
Every entity is addressed by its register's own identifier with a market suffix. Send it as ticker; every row carries it back as ticker, with the register's raw identifier as issuer_id.
| Market | ID to send | Example | Notes |
|---|---|---|---|
| United States | ticker symbol | AAPL | SEC filers. issuer_id in each row is the CIK. An issuer no longer on the SEC's ticker list (acquired, delisted, deregistered) is its 10-digit CIK + .US, e.g. 0001037540.US. |
| Japan | EDINET code + .JP | E01766.JP | E and five digits. Every filer of an annual securities report has one, listed or not. Names are in Japanese, as filed. |
| Korea | KRX stock code + .KS (KOSPI) or .KQ (KOSDAQ) | 005930.KS | Listed and delisted companies, annual (a company keeps its stock code after delisting). issuer_id is the OpenDART corp_code (8 digits), which the coverage check also takes. |
| Taiwan | TWSE stock code + .TW | 2330.TW | Listed companies. filed is the statutory deadline for the period. |
| France | SIREN + .FR | 387949530.FR |
GET /api/search
Find an entity's ID from its name, symbol or registration number. No key; counted per IP address at the limits in the table above.
curl "https://www.tradingagentapp.com/api/search?q=solvay"
# {"results":[{"ticker":"0403091220.BE","name":"SOLVAY","market":"BE"}, …]}| q | a name, a symbol or a registration number; not case-sensitive. |
| results | up to 8 hits, each { ticker, name, market }. Pass ticker to /api/v1/fundamentals as it is. |
- Order: an exact ID first, then IDs that start with the query, then names that start with it, then names that contain it. At the same level a named entity comes before an unnamed one.
- A registration number (8 to 10 digits, with or without
.FR,.BEor.DK) is looked up directly and listed first. Here a Belgian number may be typed without its leading 0. - French, Belgian and Danish names are matched word by word, and every word you type must match: words under four characters as whole words (SAP, AXA), longer ones as the start of a word.
- Names are the register's own: Japanese and some Korean entities are named in their own script.
- The MCP server's
search_companiestool calls this endpoint.
GET /api/v1/emissions/{id}
One company's official reported emissions, by company number, as each source publishes them. It is not a market and no free or demo key reads it: a key reads it only under a signed Order Form that names Emissions Data, and only the layers and sources named there. Any other key gets HTTP 403 emissions_not_licensed on all three routes.
curl "https://www.tradingagentapp.com/api/v1/emissions/306138900?id_type=siren&year=2022&scope=3" \
-H "Authorization: Bearer ta_live_xxxxxxxx"
{ "object": "emissions", "id": "306138900", "id_type": "siren", "count": 15, "total": 15, "has_more": false,
"attribution": { "fr": ["Source : ADEME, Bilans GES — …"] },
"data": [ { "source": "fr", "layer": "reported", "year": 2022, "scope": "3",
"scope_basis": "source: method v5 Annexe 7", "category": "P4.1", "gas": null, "metric": null,
"value": 8968573, "value_raw": "8968573", "unit": "tCO2e", "verified_raw": null,
"filing_date": "2023-12-29", "flags": [], "suspect": null,
"source_url": "https://data.ademe.fr/datasets/bilan-ges", "company_name": "…", "source_attribution": "…" },
… ] }Source : ADEME, Bilans GES — Données originales téléchargées sur https://data.ademe.fr/datasets/bilan-ges, mise à jour du 2 novembre 2026. Licence Ouverte / Open Licence 2.0 (https://www.etalab.gouv.fr/licence-ouverte-open-licence) — last updated 2026-11-04. Données modifiées par WU Capital Limited (Trading Agent Data) : champs personnels retirés, format normalisé. — Modified by WU Capital Limited (Trading Agent Data): personal fields left out, format normalised. Not endorsed by ADEME.
| id_type | required. A stock code and a site ID can be the same digits, so an ID means nothing without its type. See the table below. |
| source | comma list of source names. Required, as one name, with id_type=facility. GET /api/v1/emissions lists the sources your key may read. |
Python — pip install pit-fundamentals
Zero-dependency package (pandas optional) with the demo key built in:
pip install pit-fundamentals
import pit_fundamentals as pf
rows = pf.fundamentals("2330.TW") # works instantly, demo key default
snap = pf.latest("AAPL", as_of="2022-01-01") # filings dated on or before that day
# paid key: export PIT_FUNDAMENTALS_KEY=ta_live_… (code unchanged)MCP — npx pit-fundamentals-mcp
The same data as tools for Claude, ChatGPT, Cursor and any other MCP client: search_companies, get_latest_fundamentals, get_fundamentals_history, get_coverage, get_data_dictionary, get_company_status (the register's legal status, with its own code and dates), compare_companies (latest filed values of up to 10 companies side by side) and get_group_structure. Each figure comes back with its period, its filing date and its source notice. Runs on the demo key with no signup.
get_group_structure (and GET /api/v1/fundamentals/group-structure?id=, by ticker or LEI) gives every key the same summary from the group structure file: whether a company has a current direct and ultimate accounting parent there and how many current direct subsidiaries, with the GLEIF golden-copy date; no names or identifiers. The relationships themselves come only under an Order Form that names them. A reply that a key without a licence limits carries more_with_licence: what a licence key adds for that reply, with the address of the licence documents.
1. Install
The local server needs Node.js 20 or later and starts with one command:
npx -y pit-fundamentals-mcpClaude Code:
Spreadsheets — Google Sheets and Excel
The same figures as formulas, with your own key, and the source notices kept in a Sources tab by the add-on: =PIT("2330.TW","revenue",2024). Functions and install.
Notebooks — runnable on the demo key
Two worked examples, each runnable end to end on the demo key, without an account (open in Jupyter, VS Code, or Colab):
- Reporting lag: period end vs filing date — why joining figures on period end, not filing date, lets later information into a historical study — measure the lag yourself
- Taiwan fundamentals in 5 minutes — TSMC by filing date, and why Taiwan's single-quarter figures need no differencing
The API serves figures from official filings, each with its filing date and its source notice. It is data, not investment advice.