akshare 1.14.49__py3-none-any.whl → 1.17.99__py3-none-any.whl

akshare/forex/forex_em.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python
+# -*- coding:utf-8 -*-
+"""
+Date: 2025/6/23 15:00
+Desc: 东方财富网-行情中心-外汇市场-所有汇率
+https://quote.eastmoney.com/center/gridlist.html#forex_all
+"""
+
+import pandas as pd
+import requests
+
+from akshare.forex.cons import symbol_market_map
+from akshare.utils.func import fetch_paginated_data
+
+
+def forex_spot_em() -> pd.DataFrame:
+    """
+    东方财富网-行情中心-外汇市场-所有汇率-实时行情数据
+    https://quote.eastmoney.com/center/gridlist.html#forex_all
+    :return: 实时行情数据
+    :rtype: pandas.DataFrame
+    """
+    url = "https://push2.eastmoney.com/api/qt/clist/get"
+    params = {
+        "np": "1",
+        "fltt": "2",
+        "invt": "2",
+        "fs": "m:119,m:120,m:133",
+        "fields": "f12,f13,f14,f1,f2,f4,f3,f152,f17,f18,f15,f16",
+        "fid": "f3",
+        "pn": "1",
+        "pz": "100",
+        "po": "1",
+        "dect": "1",
+        "wbp2u": "|0|0|0|web",
+    }
+    temp_df = fetch_paginated_data(url, params)
+    temp_df.rename(
+        columns={
+            "index": "序号",
+            "f12": "代码",
+            "f14": "名称",
+            "f17": "今开",
+            "f4": "涨跌额",
+            "f3": "涨跌幅",
+            "f2": "最新价",
+            "f15": "最高",
+            "f16": "最低",
+            "f18": "昨收",
+        },
+        inplace=True,
+    )
+    temp_df = temp_df[
+        [
+            "序号",
+            "代码",
+            "名称",
+            "最新价",
+            "涨跌额",
+            "涨跌幅",
+            "今开",
+            "最高",
+            "最低",
+            "昨收",
+        ]
+    ]
+    temp_df["最新价"] = pd.to_numeric(temp_df["最新价"], errors="coerce")
+    temp_df["涨跌额"] = pd.to_numeric(temp_df["涨跌额"], errors="coerce")
+    temp_df["涨跌幅"] = pd.to_numeric(temp_df["涨跌幅"], errors="coerce")
+    temp_df["今开"] = pd.to_numeric(temp_df["今开"], errors="coerce")
+    temp_df["最高"] = pd.to_numeric(temp_df["最高"], errors="coerce")
+    temp_df["最低"] = pd.to_numeric(temp_df["最低"], errors="coerce")
+    temp_df["昨收"] = pd.to_numeric(temp_df["昨收"], errors="coerce")
+    return temp_df
+
+
+def forex_hist_em(symbol: str = "USDCNH") -> pd.DataFrame:
+    """
+    东方财富网-行情中心-外汇市场-所有汇率-历史行情数据
+    https://quote.eastmoney.com/cnyrate/EURCNYC.html
+    :param symbol: 品种代码；可以通过 ak.forex_spot_em() 来获取所有可获取历史行情数据的品种代码
+    :type symbol: str
+    :return: 历史行情数据
+    :rtype: pandas.DataFrame
+    """
+    url = "https://push2his.eastmoney.com/api/qt/stock/kline/get"
+    market_code = symbol_market_map[symbol]
+    params = {
+        "secid": f"{market_code}.{symbol}",
+        "klt": "101",
+        "fqt": "1",
+        "lmt": "50000",
+        "end": "20500000",
+        "iscca": "1",
+        "fields1": "f1,f2,f3,f4,f5,f6,f7,f8",
+        "fields2": "f51,f52,f53,f54,f55,f56,f57,f58,f59,f60,f61,f62,f63,f64",
+        "ut": "f057cbcbce2a86e2866ab8877db1d059",
+        "forcect": 1,
+    }
+    r = requests.get(url, params=params)
+    data_json = r.json()
+    temp_df = pd.DataFrame([item.split(",") for item in data_json["data"]["klines"]])
+    temp_df["code"] = data_json["data"]["code"]
+    temp_df["name"] = data_json["data"]["name"]
+    temp_df.columns = [
+        "日期",
+        "今开",
+        "最新价",
+        "最高",
+        "最低",
+        "-",
+        "-",
+        "振幅",
+        "-",
+        "-",
+        "-",
+        "-",
+        "-",
+        "-",
+        "代码",
+        "名称",
+    ]
+    temp_df = temp_df[
+        [
+            "日期",
+            "代码",
+            "名称",
+            "今开",
+            "最新价",
+            "最高",
+            "最低",
+            "振幅",
+        ]
+    ]
+    temp_df["日期"] = pd.to_datetime(temp_df["日期"], errors="coerce").dt.date
+    temp_df["今开"] = pd.to_numeric(temp_df["今开"], errors="coerce")
+    temp_df["最新价"] = pd.to_numeric(temp_df["最新价"], errors="coerce")
+    temp_df["最高"] = pd.to_numeric(temp_df["最高"], errors="coerce")
+    temp_df["最低"] = pd.to_numeric(temp_df["最低"], errors="coerce")
+    temp_df["振幅"] = pd.to_numeric(temp_df["振幅"], errors="coerce")
+    return temp_df
+
+
+if __name__ == "__main__":
+    forex_spot_em_df = forex_spot_em()
+    print(forex_spot_em_df)
+
+    forex_hist_em_df = forex_hist_em(symbol="USDCNH")
+    print(forex_hist_em_df)

akshare/fortune/fortune_500.py

@@ -1,14 +1,13 @@
 #!/usr/bin/env python
 # -*- coding:utf-8 -*-
 """
-Date: 2024/3/11 17:22
+Date: 2024/8/4 17:22
 Desc: 历年世界 500 强榜单数据
 https://www.fortunechina.com/fortune500/index.htm
 特殊情况说明：
 2010年由于网页端没有公布公司所属的国家, 故 2010 年数据没有国家这列
 """
 
-import json
 from functools import lru_cache
 from io import StringIO
 
@@ -69,42 +68,7 @@ def fortune_rank(year: str = "2015") -> pd.DataFrame:
         return df
 
 
-def fortune_rank_eng(year: str = "2023") -> pd.DataFrame:
-    """
-    注意你的网速
-    https://fortune.com/ranking/global500/
-    https://fortune.com/global500/2012/search/
-    :param year: "1995"
-    :type year: str
-    :return: 历年排名
-    :rtype: pandas.DataFrame
-    """
-    url = f"https://fortune.com/ranking/global500/{year}/search/"
-    r = requests.get(url)
-    soup = BeautifulSoup(r.text, features="lxml")
-    code = json.loads(
-        soup.find(name="script", attrs={"type": "application/ld+json"}).string
-    )["identifier"]
-    url = "https://content.fortune.com/wp-json/irving/v1/data/franchise-search-results"
-    params = {
-        "list_id": code,
-        "token": "Zm9ydHVuZTpCcHNyZmtNZCN5SndjWkkhNHFqMndEOTM=",
-    }
-    r = requests.get(url, params=params)
-    big_df = pd.DataFrame()
-    for i in range(len(r.json()[1]["items"][0]["fields"])):
-        temp_df = pd.DataFrame([item["fields"][i] for item in r.json()[1]["items"]])
-        big_df[temp_df["key"].values[0]] = temp_df["value"]
-    big_df["rank"] = big_df["rank"].astype(int)
-    big_df.sort_values(by="rank", inplace=True)
-    big_df.reset_index(drop=True, inplace=True)
-    return big_df
-
-
 if __name__ == "__main__":
-    fortune_rank_eng_df = fortune_rank_eng(year="2022")
-    print(fortune_rank_eng_df)
-
     fortune_rank_df = fortune_rank(year="2023")  # 2010 不一样
     print(fortune_rank_df)
 

akshare/fortune/fortune_bloomberg.py

@@ -5,6 +5,7 @@ Date: 2022/4/10 18:24
 Desc: 彭博亿万富豪指数
 https://www.bloomberg.com/billionaires/
 """
+
 import pandas as pd
 import requests
 from bs4 import BeautifulSoup
@@ -34,8 +35,8 @@ def index_bloomberg_billionaires_hist(year: str = "2021") -> pd.DataFrame:
     for dic_key in dic_keys:
         dic[dic_key] = []
 
-    for l in trs:
-        item = l.findAll("td")
+    for ll in trs:
+        item = ll.findAll("td")
         for i in range(len(item)):
             v = item[i].text
             if i == 0 and not v.isdigit():
@@ -110,5 +111,7 @@ if __name__ == "__main__":
     index_bloomberg_billionaires_df = index_bloomberg_billionaires()
     print(index_bloomberg_billionaires_df)
 
-    index_bloomberg_billionaires_hist_df = index_bloomberg_billionaires_hist(year="2021")
+    index_bloomberg_billionaires_hist_df = index_bloomberg_billionaires_hist(
+        year="2021"
+    )
     print(index_bloomberg_billionaires_hist_df)

akshare/fortune/fortune_forbes_500.py

@@ -5,6 +5,7 @@ Date: 2022/1/26 15:10
 Desc: 福布斯中国-榜单
 https://www.forbeschina.com/lists
 """
+
 import pandas as pd
 import requests
 from bs4 import BeautifulSoup
@@ -24,8 +25,7 @@ def forbes_rank(symbol: str = "2021福布斯中国创投人100") -> pd.DataFrame
     r = requests.get(url, verify=False)
     soup = BeautifulSoup(r.text, "lxml")
     need_list = [
-        item.find_all("a")
-        for item in soup.find_all("div", attrs={"class": "col-sm-4"})
+        item.find_all("a") for item in soup.find_all("div", attrs={"class": "col-sm-4"})
     ]
     all_list = []
     for item in need_list:
@@ -33,10 +33,7 @@ def forbes_rank(symbol: str = "2021福布斯中国创投人100") -> pd.DataFrame
     name_url_dict = dict(
         zip(
             [item.text.strip() for item in all_list],
-            [
-                "https://www.forbeschina.com" + item["href"]
-                for item in all_list
-            ],
+            ["https://www.forbeschina.com" + item["href"] for item in all_list],
         )
     )
     r = requests.get(name_url_dict[symbol], verify=False)

akshare/fortune/fortune_hurun.py

@@ -5,6 +5,7 @@ Date: 2023/12/22 20:00
 Desc: 胡润排行榜
 https://www.hurun.net/
 """
+
 import warnings
 
 import pandas as pd
@@ -76,7 +77,7 @@ def hurun_rank(indicator: str = "胡润百富榜", year: str = "2023") -> pd.Dat
                 temp_df = pd.DataFrame(data_json["rows"])
                 offset = offset + 20
                 big_df = pd.concat([big_df, temp_df], ignore_index=True)
-            except requests.exceptions.JSONDecodeError as e:
+            except requests.exceptions.JSONDecodeError:
                 offset = offset + 40
                 continue
         big_df.rename(

akshare/fortune/fortune_xincaifu_500.py

@@ -5,6 +5,7 @@ Date: 2022/10/30 21:12
 Desc: 新财富 500 人富豪榜
 http://www.xcf.cn/zhuanti/ztzz/hdzt1/500frb/index.html
 """
+
 import json
 
 import pandas as pd
@@ -32,26 +33,28 @@ def xincaifu_rank(year: str = "2022") -> pd.DataFrame:
         "year": year,
         "pageNo": "1",
         "from": "jsonp",
-        "_": "1604722171732",
     }
     r = requests.get(url, params=params)
     data_text = r.text
     data_json = json.loads(data_text[data_text.find("{") : -1])
     temp_df = pd.DataFrame(data_json["data"]["rows"])
     temp_df.columns
-    temp_df.rename(columns={
-        'assets': "财富",
-        'year': "年份",
-        'sex': "性别",
-        'name': "姓名",
-        'rank': "排名",
-        'company': "主要公司",
-        'industry': "相关行业",
-        'id': "-",
-        'addr': "公司总部",
-        'rankLst': "-",
-        'age': "年龄",
-    }, inplace=True)
+    temp_df.rename(
+        columns={
+            "assets": "财富",
+            "year": "年份",
+            "sex": "性别",
+            "name": "姓名",
+            "rank": "排名",
+            "company": "主要公司",
+            "industry": "相关行业",
+            "id": "-",
+            "addr": "公司总部",
+            "rankLst": "-",
+            "age": "年龄",
+        },
+        inplace=True,
+    )
     temp_df = temp_df[
         [
             "排名",

akshare/fund/fund_announcement_em.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python
+# -*- coding:utf-8 -*-
+"""
+Date: 2025/9/20 17:40
+Desc: 东方财富网站-天天基金网-基金档案-基金公告
+https://fundf10.eastmoney.com/jjgg_000001.html
+"""
+
+import time
+
+import pandas as pd
+import requests
+
+
+def fund_announcement_dividend_em(symbol: str = "000001") -> pd.DataFrame:
+    """
+    东方财富网站-天天基金网-基金档案-基金公告-分红配送
+    https://fundf10.eastmoney.com/jjgg_000001_2.html
+    :param symbol: 基金代码; 可以通过调用 ak.fund_name_em() 接口获取
+    :type symbol: str
+    :return: 分红配送-公告列表
+    :rtype: pandas.DataFrame
+    """
+    url = "http://api.fund.eastmoney.com/f10/JJGG"
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
+                      "Chrome/80.0.3987.149 Safari/537.36",
+        "Referer": f"http://fundf10.eastmoney.com/jjgg_{symbol}_2.html",
+    }
+    params = {
+        "fundcode": symbol,
+        "pageIndex": "1",
+        "pageSize": "1000",
+        "type": "2",
+        "_": round(time.time() * 1000),
+    }
+    r = requests.get(url, params=params, headers=headers)
+    data_json = r.json()
+    temp_df = pd.DataFrame(data_json["Data"])
+    temp_df.columns = [
+        "基金代码",
+        "公告标题",
+        "基金名称",
+        "_",
+        "_",
+        "公告日期",
+        "_",
+        "报告ID",
+    ]
+    temp_df = temp_df[["基金代码", "公告标题", "基金名称", "公告日期", "报告ID"]]
+    temp_df.sort_values(by=["公告日期"], inplace=True, ignore_index=True)
+    temp_df["公告日期"] = pd.to_datetime(temp_df["公告日期"], errors="coerce").dt.date
+    return temp_df
+
+
+def fund_announcement_report_em(symbol: str = "000001") -> pd.DataFrame:
+    """
+    东方财富网站-天天基金网-基金档案-基金公告-定期报告
+    https://fundf10.eastmoney.com/jjgg_000001_3.html
+    :param symbol: 基金代码; 可以通过调用 ak.fund_name_em() 接口获取
+    :type symbol: str
+    :return: 定期报告-公告列表
+    :rtype: pandas.DataFrame
+    """
+    url = "http://api.fund.eastmoney.com/f10/JJGG"
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) "
+                      "Chrome/80.0.3987.149 Safari/537.36",
+        "Referer": f"http://fundf10.eastmoney.com/jjgg_{symbol}_3.html",
+    }
+    params = {
+        "fundcode": symbol,
+        "pageIndex": "1",
+        "pageSize": "1000",
+        "type": "3",
+        "_": round(time.time() * 1000),
+    }
+    r = requests.get(url, params=params, headers=headers)
+    data_json = r.json()
+    temp_df = pd.DataFrame(data_json["Data"])
+    temp_df.columns = [
+        "基金代码",
+        "公告标题",
+        "基金名称",
+        "_",
+        "_",
+        "公告日期",
+        "_",
+        "报告ID",
+    ]
+    temp_df = temp_df[["基金代码", "公告标题", "基金名称", "公告日期", "报告ID"]]
+    temp_df.sort_values(by=["公告日期"], inplace=True, ignore_index=True)
+    temp_df["公告日期"] = pd.to_datetime(temp_df["公告日期"], errors="coerce").dt.date
+    return temp_df
+
+
+def fund_announcement_personnel_em(symbol: str = "000001") -> pd.DataFrame:
+    """
+    东方财富网站-天天基金网-基金档案-基金公告-人事调整
+    https://fundf10.eastmoney.com/jjgg_000001_4.html
+    :param symbol: 基金代码; 可以通过调用 ak.fund_name_em() 接口获取
+    :type symbol: str
+    :return: 人事调整-公告列表
+    :rtype: pandas.DataFrame
+    """
+    url = "http://api.fund.eastmoney.com/f10/JJGG"
+    headers = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36",
+        "Referer": f"http://fundf10.eastmoney.com/jjgg_{symbol}_4.html",
+    }
+    params = {
+        "fundcode": symbol,
+        "pageIndex": "1",
+        "pageSize": "1000",
+        "type": "4",
+        "_": round(time.time() * 1000),
+    }
+    r = requests.get(url, params=params, headers=headers)
+    data_json = r.json()
+    temp_df = pd.DataFrame(data_json["Data"])
+    temp_df.columns = [
+        "基金代码",
+        "公告标题",
+        "基金名称",
+        "_",
+        "_",
+        "公告日期",
+        "_",
+        "报告ID",
+    ]
+    temp_df = temp_df[["基金代码", "公告标题", "基金名称", "公告日期", "报告ID"]]
+    temp_df.sort_values(by=["公告日期"], inplace=True, ignore_index=True)
+    temp_df["公告日期"] = pd.to_datetime(temp_df["公告日期"], errors="coerce").dt.date
+    return temp_df
+
+
+if __name__ == "__main__":
+    fund_announcement_dividend_em_df = fund_announcement_dividend_em(symbol="000001")
+    print(fund_announcement_dividend_em_df)
+
+    fund_announcement_report_em_df = fund_announcement_report_em(symbol="000001")
+    print(fund_announcement_report_em_df)
+
+    fund_announcement_personnel_em_df = fund_announcement_personnel_em(symbol="000001")
+    print(fund_announcement_personnel_em_df)

akshare/fund/fund_aum_em.py

@@ -4,6 +4,7 @@
 Date: 2023/11/11 16:30
 Desc: 东方财富-基金
 """
+
 from io import StringIO
 
 import pandas as pd
@@ -17,22 +18,27 @@ def fund_aum_em() -> pd.DataFrame:
     :return: 基金公司排名列表
     :rtype: pandas.DataFrame
     """
-    url = 'https://fund.eastmoney.com/Company/home/gspmlist'
-    params = {
-        'fundType': '0'
-    }
+    url = "https://fund.eastmoney.com/Company/home/gspmlist"
+    params = {"fundType": "0"}
     r = requests.get(url, params=params)
     temp_df = pd.read_html(StringIO(r.text))[0]
-    del temp_df['相关链接']
-    del temp_df['天相评级']
-    temp_df.columns = ['序号', '基金公司', '成立时间', '全部管理规模', '全部基金数', '全部经理数']
-    expanded_df = temp_df['全部管理规模'].str.split(' ', expand=True)
-    temp_df['全部管理规模'] = expanded_df.iloc[:, 0].str.replace(",", "")
-    temp_df['更新日期'] = expanded_df.iloc[:, 1]
-    temp_df['全部管理规模'] = pd.to_numeric(temp_df['全部管理规模'], errors="coerce")
-    temp_df['全部基金数'] = pd.to_numeric(temp_df['全部基金数'], errors="coerce")
-    temp_df['全部经理数'] = pd.to_numeric(temp_df['全部经理数'], errors="coerce")
-    temp_df['成立时间'] = pd.to_datetime(temp_df['成立时间'], errors="coerce").dt.date
+    del temp_df["相关链接"]
+    del temp_df["天相评级"]
+    temp_df.columns = [
+        "序号",
+        "基金公司",
+        "成立时间",
+        "全部管理规模",
+        "全部基金数",
+        "全部经理数",
+    ]
+    expanded_df = temp_df["全部管理规模"].str.split(" ", expand=True)
+    temp_df["全部管理规模"] = expanded_df.iloc[:, 0].str.replace(",", "")
+    temp_df["更新日期"] = expanded_df.iloc[:, 1]
+    temp_df["全部管理规模"] = pd.to_numeric(temp_df["全部管理规模"], errors="coerce")
+    temp_df["全部基金数"] = pd.to_numeric(temp_df["全部基金数"], errors="coerce")
+    temp_df["全部经理数"] = pd.to_numeric(temp_df["全部经理数"], errors="coerce")
+    temp_df["成立时间"] = pd.to_datetime(temp_df["成立时间"], errors="coerce").dt.date
     return temp_df
 
 
@@ -43,17 +49,15 @@ def fund_aum_trend_em() -> pd.DataFrame:
     :return: 基金市场管理规模走势图
     :rtype: pandas.DataFrame
     """
-    url = 'https://fund.eastmoney.com/Company/home/GetFundTotalScaleForChart'
-    payload = {
-        'fundType': '0'
-    }
+    url = "https://fund.eastmoney.com/Company/home/GetFundTotalScaleForChart"
+    payload = {"fundType": "0"}
     r = requests.get(url, data=payload)
     data_json = r.json()
     temp_df = pd.DataFrame()
-    temp_df['date'] = data_json['x']
-    temp_df['value'] = data_json['y']
-    temp_df['date'] = pd.to_datetime(temp_df['date'], errors="coerce").dt.date
-    temp_df['value'] = pd.to_numeric(temp_df['value'], errors="coerce")
+    temp_df["date"] = data_json["x"]
+    temp_df["value"] = data_json["y"]
+    temp_df["date"] = pd.to_datetime(temp_df["date"], errors="coerce").dt.date
+    temp_df["value"] = pd.to_numeric(temp_df["value"], errors="coerce")
     return temp_df
 
 
@@ -61,27 +65,37 @@ def fund_aum_hist_em(year: str = "2023") -> pd.DataFrame:
     """
     东方财富-基金-基金公司历年管理规模排行列表
     https://fund.eastmoney.com/Company/lsgm.html
+    :param year: query year
+    :type year: str
     :return: 基金公司历年管理规模排行列表
     :rtype: pandas.DataFrame
     """
-    url = 'https://fund.eastmoney.com/Company/home/HistoryScaleTable'
-    params = {
-        'year': year
-    }
+    url = "https://fund.eastmoney.com/Company/home/HistoryScaleTable"
+    params = {"year": year}
     r = requests.get(url, params=params)
     temp_df = pd.read_html(StringIO(r.text))[0]
-    temp_df.columns = ['序号', '基金公司', '总规模', '股票型', '混合型', '债券型', '指数型', 'QDII', '货币型']
-    temp_df['总规模'] = pd.to_numeric(temp_df['总规模'], errors="coerce")
-    temp_df['股票型'] = pd.to_numeric(temp_df['股票型'], errors="coerce")
-    temp_df['混合型'] = pd.to_numeric(temp_df['混合型'], errors="coerce")
-    temp_df['债券型'] = pd.to_numeric(temp_df['债券型'], errors="coerce")
-    temp_df['指数型'] = pd.to_numeric(temp_df['指数型'], errors="coerce")
-    temp_df['QDII'] = pd.to_numeric(temp_df['QDII'], errors="coerce")
-    temp_df['货币型'] = pd.to_numeric(temp_df['货币型'], errors="coerce")
+    temp_df.columns = [
+        "序号",
+        "基金公司",
+        "总规模",
+        "股票型",
+        "混合型",
+        "债券型",
+        "指数型",
+        "QDII",
+        "货币型",
+    ]
+    temp_df["总规模"] = pd.to_numeric(temp_df["总规模"], errors="coerce")
+    temp_df["股票型"] = pd.to_numeric(temp_df["股票型"], errors="coerce")
+    temp_df["混合型"] = pd.to_numeric(temp_df["混合型"], errors="coerce")
+    temp_df["债券型"] = pd.to_numeric(temp_df["债券型"], errors="coerce")
+    temp_df["指数型"] = pd.to_numeric(temp_df["指数型"], errors="coerce")
+    temp_df["QDII"] = pd.to_numeric(temp_df["QDII"], errors="coerce")
+    temp_df["货币型"] = pd.to_numeric(temp_df["货币型"], errors="coerce")
     return temp_df
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     fund_aum_em_df = fund_aum_em()
     print(fund_aum_em_df)