{"full_name":"JerBouma/FinanceDatabase","owner":"JerBouma","name":"FinanceDatabase","shard":"1","url":"https://github.com/JerBouma/FinanceDatabase","description":"This is a database of 300.000+ symbols containing Equities, ETFs, Funds, Indices, Currencies, Cryptocurrencies and Money Markets.","homepage":"https://www.jeroenbouma.com/projects/financedatabase","topics":["finance","database","financials","analysis","equities","etfs","funds","indices","futures","currencies","cryptocurrencies","fundamental-analysis","sector-analysis","fundamentals","stock-data"],"tag_pages":["analysis","database","finance","stock-data"],"language":"Python","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/46355364?u=73e5ebde1d475768f58349190a0afcd460cba106&v=4","created_at":"2021-01-28T18:36:09Z","pushed_at":"2026-11-15T12:05:51Z","metrics":{"stars":9627,"forks":1002,"watchers":122,"issues":61,"prs":176,"releases":18,"issues_open":2,"issues_closed":59,"prs_open":0,"prs_closed":33,"prs_merged":143,"discussions":19},"growth":{"day":{"stars":3,"forks":0,"base_day":"2026-11-15"}},"history":{"dates":["2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[9607,9612,9612,9613,9618,9624,9627],"forks":[1001,1001,1002,1003,1002,1002,1002],"watchers":[null,123,123,123,123,122,122],"issues_open":[null,2,2,2,2,2,2],"prs_open":[null,7,7,7,9,0,0]},"boards":{},"same_owner":[],"issues":[{"number":78,"title":"[DATA] How can we contribute ISIN codes ?","comments":2,"created_at":"2024-03-28T23:18:15Z"},{"number":120,"title":"[DATA]","comments":0,"created_at":"2026-02-02T06:52:47Z"}],"discussions":[{"number":206,"title":"FinanceDatabase 2.5.0","comments":0,"category":"General","created_at":"2026-10-10T17:08:31Z"},{"number":152,"title":"FinanceDatabase 2.4.0","comments":0,"category":"General","created_at":"2026-06-02T14:12:20Z"},{"number":137,"title":"What exchanges and countries does the database cover?","comments":1,"category":"General","created_at":"2026-05-17T03:20:49Z"},{"number":106,"title":"Need some help with exporting data to file","comments":1,"category":"Q&A","created_at":"2025-06-14T18:14:04Z"},{"number":103,"title":"Dolt format for version control and incremental downloads","comments":3,"category":"Ideas","created_at":"2025-05-21T09:36:12Z"},{"number":92,"title":"How to fetch Symbols list for Exchange Short Name","comments":2,"category":"General","created_at":"2025-02-28T01:52:20Z"},{"number":89,"title":"How are the databases updated","comments":2,"category":"General","created_at":"2024-10-25T19:44:13Z"},{"number":69,"title":"Equities.search() by index (e.g. S&P500)","comments":1,"category":"Ideas","created_at":"2023-12-24T21:57:34Z"}],"latest_release":{"name":"FinanceDatabase 2.5.2","tag":"2.5.2","published_at":"2026-11-14T15:24:56Z","body":"2.5.2 continues the data-quality work of 2.5.1, with checks across the whole database that were each verified against a source, and better primary listings for companies abroad. The hosted MCP server now shows a setup page and a usage dashboard when it is opened in a browser. It also includes fixes from contributors, and from this version on, releases are published by GitHub Actions after an approval.\n\n## Package\n\n- **Filtered selections keep `to_toolkit()`.** Slicing or filtering the result of `select()` or `search()`, for example `selection[selection[\"market_cap\"] == \"Large Cap\"]`, now returns a `FinanceFrame` instead of a plain DataFrame (#255, thanks @wavebyrd).\n- **An empty search list matches nothing** instead of raising an error, e.g. `fd.Equities().search(name=[])` (#252, thanks @jackiectl2).\n- **Better primary listings** for `only_primary_listing`. Countries without a main venue get a home venue, home lines on a country's own venue come first, and lines with an ISIN win at home. Avon now resolves to AVON.L, FACC to Vienna and STMicroelectronics to Paris (#243).\n\n## MCP server\n\n- **A setup page in the browser.** Opening `https://financedatabase.jeroenbouma.com/mcp` (or `/`) in a browser shows how to add the server in three steps, instead of a \"Not Acceptable\" error. MCP clients are unaffected (#245, #247).\n- **A usage dashboard at `/stats`** in the browser: key figures, calls and users per day, and the most used tools. Scripts still get the JSON (#248).\n- **Missing numbers are `null`** in tool answers instead of non-standard `NaN` tokens (#254, thanks @jackiectl2).\n- **Infinite limits and offsets** fall back to the default instead of failing (#249, thanks @jackiectl2).\n- **Setup wizard** (`financedatabase-mcp-setup`):\n  - It writes Claude Desktop's config to `~/.config/Claude/` on Linux, which is where Claude Desktop reads it.\n  - It adds Devin Desktop, formerly Windsurf (`~/.config/devin/`, or `%APPDATA%\\devin\\` on Windows).\n  - Older Windsurf installs remain an option (#256).\n\n## Data\n\n- **Correctness and quality checks across the whole database**, each change verified against an exchange list, filing or other public source (#244):\n  - delisted and re-tickered lines updated;\n  - bonds, warrants and certificates removed from equities;\n  - tokenized stocks removed from cryptocurrencies;\n  - SPACs moved to Capital Markets;\n  - new Korean (KRX) and Thai (SET) companies added;\n  - US ETF delistings are now recorded by the weekly update.\n- **Consistent listings** (#242). A company's listings now share one country, industry and market cap tier. Blank identifiers and categories are filled from the share's other listings.\n- **Corrected names and categories:** SAP SE, Meta Platforms, Inc., Tencent Holdings Limited and Toyota Boshoku (#246).\n\n## Releases\n\n- Releases are built and published by GitHub Actions after an approval. This covers the package on PyPI, the GitHub release with `financedatabase.mcpb` and the MCP Registry entry (#257).\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}