Open-Source Databases · JerBouma

FinanceDatabase

FinanceDatabase is a Python library providing categorized access to 300,000+ financial symbols (equities, ETFs, funds, indices, currencies, cryptocurrencies, money markets) across 117 countries. It enables rapid discovery and classification of financial products by sector, industry, and exchange without providing real-time pricing data.

Talk to DEV.co Discuss Implementation

Source: GitHub — github.com/JerBouma/FinanceDatabase

GitHub stars

816

Forks

Python

Primary language

MIT

License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

Field	Value
Repository	JerBouma/FinanceDatabase
Owner	JerBouma
Primary language	Python
License	MIT — OSI-approved
Stars	8k
Forks	816
Open issues	4
Latest release	2.4.0 (2026-06-02)
Last updated	2026-07-05
Source	https://github.com/JerBouma/FinanceDatabase

What FinanceDatabase is

A Python package that exposes a CSV-backed database of financial instrument metadata via object-oriented queries (Equities, ETFs, Funds, etc.). Data is structured by multiple taxonomies (sectors, industries, countries, exchanges) and queryable through pandas DataFrames; designed as a discovery layer, not a real-time data source.

Quickstart

Get the FinanceDatabase source

Clone the repository and explore it locally.

terminalbash

1git clone https://github.com/JerBouma/FinanceDatabase.git2cd FinanceDatabase3# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Financial product discovery and classification

Rapidly identify and filter equities, ETFs, funds, and other instruments by sector, industry, country, or exchange to support research, screening, or portfolio construction workflows.

Building financial analysis applications

Use as a reference dataset to map ticker symbols to standardized metadata (ISIN, CUSIP, FIGI identifiers) when integrating with downstream data providers (Finance Toolkit, etc.) or analysis pipelines.

Market structure and taxonomy analysis

Analyze distribution of products across sectors, countries, and exchanges; useful for research, reporting, fintech education, and compliance/regulatory mapping.

Implementation considerations

Dataset is large (300k+ symbols); initial load and filtering can be memory-intensive; cache Equities/ETFs objects after first instantiation to avoid repeated deserialization.
Community-maintained CSV structure; monitor GitHub issues and releases for data corrections or schema changes; plan for periodic re-sync with upstream repository.
Symbol coverage and metadata completeness vary by product type and country; validate critical identifiers (ISIN, CUSIP, FIGI) against authoritative sources before downstream use.
Python-only; requires integration layer if consuming from non-Python services; consider wrapping as REST API or gRPC service for polyglot environments.
License is MIT; acceptable for commercial use, but verify with legal counsel for your specific jurisdiction and application context.

When to avoid it — and what to weigh

Real-time or intraday trading data required — This is a static reference database; it explicitly does not provide fundamental data, pricing, or market feeds. Use dedicated data vendors (Bloomberg, FactSet, IEX Cloud) for live data.
Mission-critical production systems without validation — The database relies on community contributions via CSV edits. Data accuracy and freshness are not guaranteed; validate symbols and identifiers against upstream sources before production deployment.
Regulatory/compliance databases requiring formal audit trail — Community-driven, non-audited dataset. For regulated use (KYC, AML, regulatory reporting), require formal data governance and attestation from authoritative sources.
High-frequency or microsecond-precision applications — Built for categorization and discovery, not latency-critical workloads. Not suitable for HFT, algorithmic execution, or systems with strict timing requirements.

License & commercial use

Licensed under MIT (MIT License), an OSI-approved permissive open-source license. Allows commercial use, modification, and distribution with minimal restrictions (retain license and copyright notices).

MIT license explicitly permits commercial use. However, as a community-driven, non-audited reference dataset, use for regulated or mission-critical applications (KYC, AML, SEC reporting) requires independent validation and formal data governance. Assess data quality and liability exposure with legal/compliance teams. No warranty or SLA is provided by the project.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

Signal	Assessment
Maintenance	Active
Documentation	Adequate
License clarity	Clear
Deployment complexity	Low
DEV.co fit	Good
Assessment confidence	High

Security considerations

No sensitive secrets managed by the library. Threats to consider: (1) dependency supply-chain risk (pip install); audit transitive dependencies. (2) Data injection if symbols or identifiers are unsanitized before downstream use (e.g., SQL queries). (3) Community-maintained data integrity; validate symbols and metadata independently for regulated use. (4) No encryption or access control; treat as public reference data. No known CVEs reported; standard Python security hygiene applies.

Alternatives to consider

yfinance + manual categorization

Free, Python-native, but provides pricing and fundamentals instead of categorization; requires custom mapping to build sector/industry taxonomies.

IEX Cloud or Alpha Vantage (reference data APIs)

Commercial services with curated, audited reference data (symbols, ISIN, sector codes) and SLAs; better for regulated use but require paid subscriptions.

Bloomberg Terminal or FactSet

Comprehensive, audited financial databases with real-time data, deep taxonomies, and regulatory compliance; enterprise-grade but expensive and not open-source.

Software development agency

Build on FinanceDatabase with DEV.co software developers

Devco can help you wrap FinanceDatabase into scalable APIs, validate data for regulatory use, or build custom financial analysis platforms. Start with a free consultation.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

finviz database ydb

Related on DEV.co

Explore the category and the services that help you build with it.

Open-Source Databases Custom Software & Financial Data Integration API Development for Data Services Web Application Development Talk to DEV.co

FinanceDatabase FAQ

Does FinanceDatabase provide real-time stock prices or fundamentals?

No. It is a static reference database of symbol metadata (name, sector, industry, exchange, identifiers). Use the Finance Toolkit or yfinance for pricing and fundamental data.

How often is the database updated?

Unknown from the data provided. Repository shows active development (last push 2026-07-05), but update cadence for symbol additions/corrections is not specified. Check GitHub releases or contribute via CONTRIBUTING.md for details.

Can I use this in a commercial product or service?

Yes, MIT license permits commercial use. However, independently validate data accuracy for regulated use (KYC, AML, compliance); the project provides no warranty or SLA. Consult legal counsel for your jurisdiction.

What if a symbol is missing or incorrect?

Community-driven; submit corrections or additions via GitHub issues or the CONTRIBUTING.md workflow. Expect volunteer-driven response times; for production use, implement independent validation checks.

Software developers & web developers for hire

DEV.co helps companies turn open-source tools like FinanceDatabase into production software. Our software development services cover the full lifecycle — architecture, web development, integration, and maintenance — delivered by software developers and web developers who ship. Engage our software development agency to implement or customize it for your open-source databases stack.

Ready to integrate financial product discovery into your application?

Devco can help you wrap FinanceDatabase into scalable APIs, validate data for regulatory use, or build custom financial analysis platforms. Start with a free consultation.

Talk to DEV.co Schedule a Consultation