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

akshare/energy/energy_oil_em.py

@@ -5,6 +5,7 @@ Date: 2024/1/20 23:00
 Desc: 东方财富-数据中心-中国油价
 https://data.eastmoney.com/cjsj/oil_default.html
 """
+
 import pandas as pd
 import requests
 
@@ -29,7 +30,6 @@ def energy_oil_hist() -> pd.DataFrame:
         "p": "1",
         "pageNo": "1",
         "pageNum": "1",
-        "_": "1652959763351",
     }
     r = requests.get(url, params=params)
     data_json = r.json()
@@ -66,7 +66,6 @@ def energy_oil_detail(date: str = "20220517") -> pd.DataFrame:
         "pageNumber": "1",
         "pageSize": "1000",
         "source": "WEB",
-        "_": "1652959763351",
     }
     r = requests.get(url, params=params)
     data_json = r.json()

akshare/event/cons.py

@@ -4,6 +4,7 @@
 Date: 2023/9/24 15:22
 Desc: 百度地图慧眼-迁徙城市代码映射
 """
+
 province_dict = {
     "820000": "澳门",
     "810000": "香港",

akshare/event/migration.py

@@ -1,9 +1,10 @@
 #!/usr/bin/env python
 # -*- coding:utf-8 -*-
 """
-Date: 2023/9/24 16:30
+Date: 2024/5/12 22:30
 Desc: 百度地图慧眼-百度迁徙数据
 """
+
 import json
 
 import pandas as pd
@@ -92,7 +93,7 @@ def migration_scale_baidu(
 
 if __name__ == "__main__":
     migration_area_baidu_df = migration_area_baidu(
-        area="上海市", indicator="move_in", date="20230922"
+        area="杭州市", indicator="move_out", date="20240401"
     )
     print(migration_area_baidu_df)
 

akshare/exceptions.py

@@ -0,0 +1,43 @@
+"""
+AKShare 异常处理模块
+"""
+
+
+class AkshareException(Exception):
+    """Base exception for akshare library"""
+
+    def __init__(self, message):
+        self.message = message
+        super().__init__(self.message)
+
+
+class APIError(AkshareException):
+    """Raised when API request fails"""
+
+    def __init__(self, message, status_code=None):
+        self.status_code = status_code
+        super().__init__(f"API Error: {message} (Status code: {status_code})")
+
+
+class DataParsingError(AkshareException):
+    """Raised when data parsing fails"""
+
+    pass
+
+
+class InvalidParameterError(AkshareException):
+    """Raised when an invalid parameter is provided"""
+
+    pass
+
+
+class NetworkError(AkshareException):
+    """Raised when network-related issues occur"""
+
+    pass
+
+
+class RateLimitError(AkshareException):
+    """Raised when API rate limit is exceeded"""
+
+    pass

akshare/file_fold/calendar.json

@@ -8310,5 +8310,248 @@
   "20241226",
   "20241227",
   "20241230",
-  "20241231"
-]
+  "20241231",
+  "20250102",
+  "20250103",
+  "20250106",
+  "20250107",
+  "20250108",
+  "20250109",
+  "20250110",
+  "20250113",
+  "20250114",
+  "20250115",
+  "20250116",
+  "20250117",
+  "20250120",
+  "20250121",
+  "20250122",
+  "20250123",
+  "20250124",
+  "20250127",
+  "20250205",
+  "20250206",
+  "20250207",
+  "20250210",
+  "20250211",
+  "20250212",
+  "20250213",
+  "20250214",
+  "20250217",
+  "20250218",
+  "20250219",
+  "20250220",
+  "20250221",
+  "20250224",
+  "20250225",
+  "20250226",
+  "20250227",
+  "20250228",
+  "20250303",
+  "20250304",
+  "20250305",
+  "20250306",
+  "20250307",
+  "20250310",
+  "20250311",
+  "20250312",
+  "20250313",
+  "20250314",
+  "20250317",
+  "20250318",
+  "20250319",
+  "20250320",
+  "20250321",
+  "20250324",
+  "20250325",
+  "20250326",
+  "20250327",
+  "20250328",
+  "20250331",
+  "20250401",
+  "20250402",
+  "20250403",
+  "20250407",
+  "20250408",
+  "20250409",
+  "20250410",
+  "20250411",
+  "20250414",
+  "20250415",
+  "20250416",
+  "20250417",
+  "20250418",
+  "20250421",
+  "20250422",
+  "20250423",
+  "20250424",
+  "20250425",
+  "20250428",
+  "20250429",
+  "20250430",
+  "20250506",
+  "20250507",
+  "20250508",
+  "20250509",
+  "20250512",
+  "20250513",
+  "20250514",
+  "20250515",
+  "20250516",
+  "20250519",
+  "20250520",
+  "20250521",
+  "20250522",
+  "20250523",
+  "20250526",
+  "20250527",
+  "20250528",
+  "20250529",
+  "20250530",
+  "20250603",
+  "20250604",
+  "20250605",
+  "20250606",
+  "20250609",
+  "20250610",
+  "20250611",
+  "20250612",
+  "20250613",
+  "20250616",
+  "20250617",
+  "20250618",
+  "20250619",
+  "20250620",
+  "20250623",
+  "20250624",
+  "20250625",
+  "20250626",
+  "20250627",
+  "20250630",
+  "20250701",
+  "20250702",
+  "20250703",
+  "20250704",
+  "20250707",
+  "20250708",
+  "20250709",
+  "20250710",
+  "20250711",
+  "20250714",
+  "20250715",
+  "20250716",
+  "20250717",
+  "20250718",
+  "20250721",
+  "20250722",
+  "20250723",
+  "20250724",
+  "20250725",
+  "20250728",
+  "20250729",
+  "20250730",
+  "20250731",
+  "20250801",
+  "20250804",
+  "20250805",
+  "20250806",
+  "20250807",
+  "20250808",
+  "20250811",
+  "20250812",
+  "20250813",
+  "20250814",
+  "20250815",
+  "20250818",
+  "20250819",
+  "20250820",
+  "20250821",
+  "20250822",
+  "20250825",
+  "20250826",
+  "20250827",
+  "20250828",
+  "20250829",
+  "20250901",
+  "20250902",
+  "20250903",
+  "20250904",
+  "20250905",
+  "20250908",
+  "20250909",
+  "20250910",
+  "20250911",
+  "20250912",
+  "20250915",
+  "20250916",
+  "20250917",
+  "20250918",
+  "20250919",
+  "20250922",
+  "20250923",
+  "20250924",
+  "20250925",
+  "20250926",
+  "20250929",
+  "20250930",
+  "20251009",
+  "20251010",
+  "20251013",
+  "20251014",
+  "20251015",
+  "20251016",
+  "20251017",
+  "20251020",
+  "20251021",
+  "20251022",
+  "20251023",
+  "20251024",
+  "20251027",
+  "20251028",
+  "20251029",
+  "20251030",
+  "20251031",
+  "20251103",
+  "20251104",
+  "20251105",
+  "20251106",
+  "20251107",
+  "20251110",
+  "20251111",
+  "20251112",
+  "20251113",
+  "20251114",
+  "20251117",
+  "20251118",
+  "20251119",
+  "20251120",
+  "20251121",
+  "20251124",
+  "20251125",
+  "20251126",
+  "20251127",
+  "20251128",
+  "20251201",
+  "20251202",
+  "20251203",
+  "20251204",
+  "20251205",
+  "20251208",
+  "20251209",
+  "20251210",
+  "20251211",
+  "20251212",
+  "20251215",
+  "20251216",
+  "20251217",
+  "20251218",
+  "20251219",
+  "20251222",
+  "20251223",
+  "20251224",
+  "20251225",
+  "20251226",
+  "20251229",
+  "20251230",
+  "20251231"
+]

akshare/forex/cons.py

@@ -0,0 +1,192 @@
+symbol_market_map = {
+    "EURCNYC": 120,
+    "JPYZAR": 119,
+    "NZDCNYC": 120,
+    "CNYRUBC": 120,
+    "AUDCNYC": 120,
+    "JPYGBP": 119,
+    "JPYSGD": 119,
+    "JPYCNH": 133,
+    "JPYAUD": 119,
+    "USDBRL": 119,
+    "JPYEUR": 119,
+    "JPYTRY": 119,
+    "JPYCAD": 119,
+    "CHFZAR": 119,
+    "JPYHKD": 119,
+    "SEKEUR": 119,
+    "JPYUSD": 119,
+    "GBPCNYC": 120,
+    "JPYNZD": 119,
+    "CHFGBP": 119,
+    "USDIDR": 119,
+    "CHFSGD": 119,
+    "USDPLN": 119,
+    "CHFCNH": 133,
+    "SEKUSD": 119,
+    "CHFAUD": 119,
+    "USDKRW": 119,
+    "EURPLN": 119,
+    "USDHUF": 119,
+    "CHFCAD": 119,
+    "USDTHB": 119,
+    "CHFEUR": 119,
+    "JPYCNYC": 120,
+    "EURHUF": 119,
+    "CHFHKD": 119,
+    "SGDCNYC": 120,
+    "CHFUSD": 119,
+    "USDINR": 119,
+    "USDCZK": 119,
+    "CHFNZD": 119,
+    "USDMXN": 119,
+    "GBPPLN": 119,
+    "USDZAR": 119,
+    "JPYCHF": 119,
+    "EURCZK": 119,
+    "EURZAR": 119,
+    "CADCNYC": 120,
+    "NOKEUR": 119,
+    "NZDGBP": 119,
+    "NOKUSD": 119,
+    "NZDSGD": 119,
+    "USDGBP": 119,
+    "HKDGBP": 119,
+    "NZDCNH": 133,
+    "NZDAUD": 119,
+    "HKDSGD": 119,
+    "CNYSARC": 120,
+    "USDSGD": 119,
+    "CNYAEDC": 120,
+    "EURGBP": 119,
+    "CADGBP": 119,
+    "USDCNH": 133,
+    "CNYTRYC": 120,
+    "CADSGD": 119,
+    "USDAUD": 119,
+    "GBPZAR": 119,
+    "EURSGD": 119,
+    "HKDCNH": 133,
+    "NZDCAD": 119,
+    "CADCNH": 133,
+    "HKDAUD": 119,
+    "NZDEUR": 119,
+    "EURCNH": 133,
+    "EURAUD": 119,
+    "NZDHKD": 119,
+    "CADAUD": 119,
+    "AUDGBP": 119,
+    "USDDKK": 119,
+    "HKDCAD": 119,
+    "USDCAD": 119,
+    "AUDSGD": 119,
+    "USDTRY": 119,
+    "EURTRY": 119,
+    "USDEUR": 119,
+    "NZDUSD": 119,
+    "SGDGBP": 119,
+    "USDHKD": 119,
+    "AUDCNH": 133,
+    "EURDKK": 119,
+    "USDARS": 119,
+    "USDSAR": 119,
+    "TRYUSD": 119,
+    "TRYEUR": 119,
+    "SARUSD": 119,
+    "INRUSD": 119,
+    "HUFUSD": 119,
+    "HUFEUR": 119,
+    "HKDUSD": 119,
+    "HKDEUR": 119,
+    "HKDCNYC": 120,
+    "EURCAD": 119,
+    "DKKUSD": 119,
+    "DKKEUR": 119,
+    "CNYMOPC": 120,
+    "CNHSGD": 133,
+    "CNHGBP": 133,
+    "CNHAUD": 133,
+    "CADEUR": 119,
+    "SGDCNH": 133,
+    "EURHKD": 119,
+    "CADHKD": 119,
+    "USDCNYC": 120,
+    "GBPSGD": 119,
+    "EURUSD": 119,
+    "SGDAUD": 119,
+    "HKDNZD": 119,
+    "USDNZD": 119,
+    "GBPCNH": 133,
+    "CADUSD": 119,
+    "AUDCAD": 119,
+    "CNYTHBC": 120,
+    "CNHEUR": 133,
+    "GBPAUD": 119,
+    "AUDEUR": 119,
+    "CADNZD": 119,
+    "EURNZD": 119,
+    "CNHCAD": 133,
+    "AUDHKD": 119,
+    "SGDCAD": 119,
+    "AUDUSD": 119,
+    "SGDEUR": 119,
+    "CNHHKD": 133,
+    "GBPCAD": 119,
+    "CNHUSD": 133,
+    "SGDHKD": 119,
+    "GBPEUR": 119,
+    "SGDUSD": 119,
+    "AUDNZD": 119,
+    "GBPHKD": 119,
+    "GBPUSD": 119,
+    "CNHNZD": 133,
+    "CHFCNYC": 120,
+    "SGDNZD": 119,
+    "ZARGBP": 119,
+    "USDNOK": 119,
+    "GBPNZD": 119,
+    "CZKEUR": 119,
+    "EURNOK": 119,
+    "CHFJPY": 119,
+    "NZDCHF": 119,
+    "PLNGBP": 119,
+    "HKDCHF": 119,
+    "ZARUSD": 119,
+    "USDCHF": 119,
+    "ZAREUR": 119,
+    "MXNUSD": 119,
+    "EURCHF": 119,
+    "CADCHF": 119,
+    "CZKUSD": 119,
+    "CNYKRWC": 120,
+    "CNHCHF": 133,
+    "AUDCHF": 119,
+    "PLNEUR": 119,
+    "CNYMXNC": 120,
+    "SGDCHF": 119,
+    "PLNUSD": 119,
+    "USDSEK": 119,
+    "GBPCHF": 119,
+    "EURSEK": 119,
+    "CNYMYRC": 120,
+    "NZDJPY": 119,
+    "ZARCHF": 119,
+    "USDJPY": 119,
+    "THBUSD": 119,
+    "HKDJPY": 119,
+    "EURJPY": 119,
+    "CADJPY": 119,
+    "AUDJPY": 119,
+    "TRYJPY": 119,
+    "CNHJPY": 133,
+    "SGDJPY": 119,
+    "GBPJPY": 119,
+    "CNYZARC": 120,
+    "ZARJPY": 119,
+    "USDRUB": 119,
+    "CNYDKKC": 120,
+    "CNYNOKC": 120,
+    "CNYHUFC": 120,
+    "CNYPLNC": 120,
+    "CNYSEKC": 120,
+}

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)