Об этом проекте

FinanceDatabase — это открытый Python-пакет, поставляемый с большой курируемой справочной базой финансовых инструментов. Он охватывает более 300 000 символов: акции (около 112 690 в 11 секторах, 80 отраслях, 117 странах и 84 биржах), ETF (около 36 481 в 313 семействах и 44 категориях), фонды (около 57 853 в 1 540 семействах), индексы (около 91 181), валюты (около 2 556), криптовалюты (около 3 367) и денежные рынки (около 1 367). Проект явно не является источником рыночных данных или фундаментальных показателей. Вместо этого он сосредоточен на категоризации продуктов и метаданных: для каждого символа хранятся тикер, название, валюта, сектор, группа отраслей, отрасль, биржа, рынок, страна, штат, город, почтовый индекс, веб-сайт, диапазон рыночной капитализации, идентификаторы ISIN, CUSIP и FIGI. Это делает его полезным для выяснения того, какие продукты существуют в данной стране, секторе или отрасли, а также для обогащения других рабочих процессов с финансовыми данными (автор сочетает его с отдельным пакетом FinanceToolkit для фактических данных о ценах и фундаментальных показателях). Установка выполняется одной командой `pip install financedatabase -U`, после чего пакет импортируется как `import financedatabase as fd`. Каждый класс активов представлен отдельным классом (например, `fd.Equities()`), и после создания экземпляра его можно запрашивать через `select(...)` с использованием фильтров по ключевым словам, таких как `country`, `sector`, `industry`, `exchange`, `market`, `currency`, `market_cap` и `only_primary_listing`. Фильтры принимают либо одно значение, либо список значений, и в этом случае возвращается любое совпадение. Вспомогательный метод `show_options(...)` выводит список различных значений, доступных для каждого столбца, при необходимости суженный другими фильтрами, что позволяет пользователям изучать таксономию без загрузки полных файлов данных. Поскольку одна и та же компания может быть котируемой на нескольких биржах, результаты могут содержать дублирующиеся компании; флаг `only_primary_listing` или явный фильтр `exchange`/`market` сужает выборку. Лежащие в основе данные хранятся в виде CSV-файлов, что проект подчёркивает как осознанный выбор дизайна: участники без опыта программирования могут редактировать файлы напрямую, чтобы добавлять, изменять или удалять тикеры, а README содержит призыв к вкладу сообщества через руководство CONTRIBUTING.md. Пакет распространяется на PyPI, поддерживает несколько версий Python и поддерживается Jeroen Bouma. Он позиционируется как бесплатная, управляемая сообществом альтернатива коммерческим поставщикам справочных данных для всех, кому нужен широкий, фильтруемый обзор глобального мира финансовых продуктов.