当前位置：首页 > news >正文

经济指标和日历事件：使用Finnhub Python API进行宏观经济分析

news 2026/6/9 22:39:34

经济指标和日历事件：使用Finnhub Python API进行宏观经济分析

【免费下载链接】finnhub-pythonFinnhub Python API Client. Finnhub API provides institutional-grade financial data to investors, fintech startups and investment firms. We support real-time stock price, global fundamentals, global ETFs holdings and alternative data. https://finnhub.io/docs/api项目地址: https://gitcode.com/gh_mirrors/fi/finnhub-python

Finnhub Python API是一款功能强大的金融数据工具，能为投资者、金融科技创业者和投资公司提供机构级别的金融数据支持，涵盖实时股价、全球基本面、全球ETF持仓和替代数据等。借助它，我们可以轻松获取经济指标与日历事件数据，深入开展宏观经济分析。

📊 快速入门：安装与初始化Finnhub Python API

要使用Finnhub Python API，首先需要进行安装。你可以通过以下步骤获取项目并安装依赖：

克隆仓库：git clone https://gitcode.com/gh_mirrors/fi/finnhub-python
安装依赖：cd finnhub-python && pip install -r requirements.txt

安装完成后，通过以下代码初始化客户端，准备开始获取经济数据：

import finnhub import os # 初始化Finnhub客户端 finnhub_client = finnhub.Client(api_key=os.environ["FINNHUB_API_KEY"])

🔍 核心功能探索：经济指标与日历事件接口

Finnhub Python API提供了丰富的接口用于获取经济指标和日历事件数据，以下是两个关键接口的详细介绍。

获取经济指标代码：`economic_code`方法

通过economic_code方法可以获取所有可用的经济指标代码，这些代码是后续获取具体经济数据的关键。例如：

# 获取经济指标代码列表 economic_codes = finnhub_client.economic_code() print("部分经济指标代码:", economic_codes[0:5])

该方法对应源码中的实现位于 finnhub/client.py：

def economic_code(self): return self._get("/economic/code")

获取经济日历事件：`calendar_economic`方法

使用calendar_economic方法可以获取指定日期范围内的经济日历事件，帮助我们及时了解重要的经济事件安排。例如：

# 获取2021年1月1日至1月7日的经济日历事件 economic_events = finnhub_client.calendar_economic('2021-01-01', '2021-01-07') print("经济日历事件:", economic_events)

该方法在源码中的实现位于 finnhub/client.py：

def calendar_economic(self, _from=None, to=None): return self._get("/calendar/economic", params={ "from": _from, "to": to })

🚀 实用示例：宏观经济分析场景应用

下面通过一个完整的示例，展示如何使用Finnhub Python API获取经济指标数据和经济日历事件，并进行简单的宏观经济分析。

import finnhub import os # 初始化客户端 finnhub_client = finnhub.Client(api_key=os.environ["FINNHUB_API_KEY"]) # 1. 获取经济指标代码 print("=== 经济指标代码 ===") economic_codes = finnhub_client.economic_code() for code in economic_codes[:3]: # 打印前3个指标代码 print(f"指标名称: {code['name']}, 代码: {code['code']}") # 2. 获取特定经济指标数据（以美国制造业PMI为例，代码可能需根据实际情况调整） target_code = "MA-USA-656880" print(f"\n=== {target_code} 经济数据 ===") economic_data = finnhub_client.economic_data(target_code) print(economic_data) # 3. 获取未来一周经济日历事件 from datetime import datetime, timedelta today = datetime.now().strftime("%Y-%m-%d") next_week = (datetime.now() + timedelta(days=7)).strftime("%Y-%m-%d") print(f"\n=== {today} 至 {next_week} 经济日历事件 ===") calendar_events = finnhub_client.calendar_economic(today, next_week) for event in calendar_events[:3]: # 打印前3个事件 print(f"事件: {event['event']}, 日期: {event['date']}, 国家: {event['country']}")