simonlin1212/global-stock-data

感谢 [@HoRiZonn0](https://github.com/HoRiZonn0)（issue #2）提供完整字段对照。逐条实测复现后确认其报告**全部正确**，并发现比报告更严重的后果：

### 修复（PR #1 @APTX4869-maker + 连带 bug） - **5 个函数漏传 `params` 导致始终拿不到数据（PR #1）**：`stock_quote_eastmoney` / `stock_kline_yahoo` / `fund_flow_daily` / `stock_search` / `market_stock_list` 都构造了 `params` dict，但 `requests.get(url, ...)` 时漏了 `param

- **5 个函数漏传 `params` 导致始终拿不到数据（PR #1）**：`stock_quote_eastmoney` / `stock_kline_yahoo` / `fund_flow_daily` / `stock_search` / `market_stock_list` 都构造了 `params` dict，但 `requests.get(url, ...)` 时漏了 `params=params`，请求实际是裸 URL → 服务端返回空（东财 push2 

Apache License                            Version 2.0, January 2004                         http://www.apache.org/licenses/

http://www.apache.org/licenses/

http://www.apache.org/licenses/LICENSE-2.0

<p align="center">   <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>

<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python 3.9+"></a>

<a href="https://github.com/simonlin1212/global-stock-data/stargazers"><img src="https://img.shields.io/github/stars/simonlin1212/global-stock-data?style=social" alt="GitHub stars"></a>

<a href="#architecture"><img src="https://img.shields.io/badge/layers-17-2ea44f.svg" alt="Layers"></a>

<a href="#endpoints"><img src="https://img.shields.io/badge/endpoints-50%2B-2ea44f.svg" alt="Endpoints"></a>

<a href="#data-sources"><img src="https://img.shields.io/badge/sources-18-2ea44f.svg" alt="Sources"></a>

<a href="#data-sources"><img src="https://img.shields.io/badge/auth-zero-success.svg" alt="Zero-Auth"></a>

> Compatible with [Claude Code](https://github.com/anthropics/claude-code) · [Codex](https://github.com/openai/codex) · [OpenClaw](https://github.com/openclaw/openclaw). The Skill file is structured Markdown + embedded Python — any AI codin

# 2. Download SKILL.md curl -o ~/.claude/skills/global-stock-data/SKILL.md \

curl -o ~/.claude/skills/global-stock-data/SKILL.md \

https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md

**Q: How does this relate to a-stock-data?** Sister project. [a-stock-data](https://github.com/simonlin1212/a-stock-data) covers China A-shares; global-stock-data covers US and HK. Install both — they don't conflict.

Sister project. [a-stock-data](https://github.com/simonlin1212/a-stock-data) covers China A-shares; global-stock-data covers US and HK. Install both — they don't conflict.

[Apache License 2.0](./LICENSE) — **Author:** Simon Lin · X [@linsizhen](https://x.com/linsizhen) · Email: [simonlin0423@gmail.com](mailto:simonlin0423@gmail.com)

<p align="center">   <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>

<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg" alt="License: Apache 2.0"></a>

<a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python 3.9+"></a>

<a href="https://github.com/simonlin1212/global-stock-data/stargazers"><img src="https://img.shields.io/github/stars/simonlin1212/global-stock-data?style=social" alt="GitHub stars"></a>

<a href="#架构"><img src="https://img.shields.io/badge/层数-17-2ea44f.svg" alt="层数"></a>

<a href="#端点"><img src="https://img.shields.io/badge/端点-50%2B-2ea44f.svg" alt="端点"></a>

<a href="#数据源"><img src="https://img.shields.io/badge/数据源-18-2ea44f.svg" alt="数据源"></a>

<a href="#数据源"><img src="https://img.shields.io/badge/鉴权-零-success.svg" alt="零鉴权"></a>

> 兼容 [Claude Code](https://github.com/anthropics/claude-code) · [Codex](https://github.com/openai/codex) · [OpenClaw](https://github.com/openclaw/openclaw)。Skill 文件本质是结构化 Markdown + 内嵌 Python，任何支持上下文注入的 AI 编程助手都能用。

# 2. 下载 SKILL.md curl -o ~/.claude/skills/global-stock-data/SKILL.md \

curl -o ~/.claude/skills/global-stock-data/SKILL.md \

https://raw.githubusercontent.com/simonlin1212/global-stock-data/main/SKILL.md

**和 a-stock-data 什么关系？** 姊妹项目。[a-stock-data](https://github.com/simonlin1212/a-stock-data) 覆盖 A 股，global-stock-data 覆盖美股，两个 Skill 可同时装、互不冲突。

[Apache License 2.0](./LICENSE) — 自由使用，注明出处即可。**Author:** Simon Lin · X [@linsizhen](https://x.com/linsizhen) · Email: [simonlin0423@gmail.com](mailto:simonlin0423@gmail.com)

> 📦 项目主页：https://github.com/simonlin1212/global-stock-data — 更新、反馈、支持作者

> 作者：Simon 林 · X [@linsizhen](https://x.com/linsizhen) · 邮箱：simonlin0423@gmail.com

| **台湾证交所 / 柜买中心 OpenAPI** | **授权**：本工具用到的 13 个数据集都登记在台湾「政府资料开放平台」，授权方式为《政府资料开放授权条款-第1版》：*「授權使用者不限目的、時間及地域、非專屬、不可撤回、免授權金進行利用」*，但须按条款的「显名声明」**注明来源**，否则视为未取得授权。两家网站条款的知识产权一节写明，经授权给政府资料开放平台的资料 *「不在此限」*，同时要求转载 *「清楚註明資料來源，並確保資料完整性，不得任意增刪」*。**程序下

| **美国劳工部 ETA**（每周失业金申领） | 劳工部版权页：*"Materials created by the federal government are generally part of the **public domain** and may be used, reproduced and distributed without permission."* 不得以暗示与劳工部有关联或受其认可的方式使用；可注明来源 *"U.S. Department of 

s = requests.Session()

# Step 1: 获取 cookie     s.get('https://fc.yahoo.com', timeout=10)

s.get('https://fc.yahoo.com', timeout=10)

# Step 2: 获取 crumb     r = s.get('https://query2.finance.yahoo.com/v1/test/getcrumb', timeout=10)

r = s.get('https://query2.finance.yahoo.com/v1/test/getcrumb', timeout=10)

"""Yahoo quoteSummary 统一查询"""     s = get_yahoo_session()     r = s.get(f'https://query2.finance.yahoo.com/v10/finance/quoteSummary/{symbol}', params={

s = get_yahoo_session()     r = s.get(f'https://query2.finance.yahoo.com/v10/finance/quoteSummary/{symbol}', params={         'modules': ','.join(modules),

r = s.get(f'https://query2.finance.yahoo.com/v10/finance/quoteSummary/{symbol}', params={

UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36" DATACENTER_URL = "https://datacenter-web.eastmoney.com/api/data/v1/get"

DATACENTER_URL = "https://datacenter-web.eastmoney.com/api/data/v1/get"

"source": "WEB", "client": "WEB",     }     r = requests.get(DATACENTER_URL, params=params, headers={"User-Agent": UA}, timeout=15)

}     r = requests.get(DATACENTER_URL, params=params, headers={"User-Agent": UA}, timeout=15)     d = r.json()

r = requests.get(DATACENTER_URL, params=params, headers={"User-Agent": UA}, timeout=15)

try:         if data is not None or json_body is not None:             r = requests.post(url, params=params, data=data, json=json_body, headers=h, timeout=timeout)

if data is not None or json_body is not None:             r = requests.post(url, params=params, data=data, json=json_body, headers=h, timeout=timeout)         else:

r = requests.post(url, params=params, data=data, json=json_body, headers=h, timeout=timeout)

else:             r = requests.get(url, params=params, headers=h, timeout=timeout)         r.raise_for_status()

r = requests.get(url, params=params, headers=h, timeout=timeout)

ticker: 纯字母，如 "AAPL", "TSLA", "BABA"     """     url = f"https://hq.sinajs.cn/list=gb_{ticker.lower()}"

"""     url = f"https://hq.sinajs.cn/list=gb_{ticker.lower()}"     r = requests.get(url, headers={

url = f"https://hq.sinajs.cn/list=gb_{ticker.lower()}"     r = requests.get(url, headers={         "Referer": "https://finance.sina.com.cn/",

r = requests.get(url, headers={

"Referer": "https://finance.sina.com.cn/",

ticker: 纯字母，如 "AAPL"     """     url = f"https://qt.gtimg.cn/q=us{ticker.upper()}"

"""     url = f"https://qt.gtimg.cn/q=us{ticker.upper()}"     r = requests.get(url, timeout=10)

url = f"https://qt.gtimg.cn/q=us{ticker.upper()}"     r = requests.get(url, timeout=10)     r.encoding = "gbk"

r = requests.get(url, timeout=10)

code: 五位数字，如 "00700", "09988"     """     url = f"https://qt.gtimg.cn/q=r_hk{code}"

"""     url = f"https://qt.gtimg.cn/q=r_hk{code}"     r = requests.get(url, timeout=10)

url = f"https://qt.gtimg.cn/q=r_hk{code}"     r = requests.get(url, timeout=10)     r.encoding = "gbk"

r = requests.get(url, timeout=10)

code: 五位数字，如 "00700"     """     url = f"https://hq.sinajs.cn/list=rt_hk{code}"

"""     url = f"https://hq.sinajs.cn/list=rt_hk{code}"     r = requests.get(url, headers={

url = f"https://hq.sinajs.cn/list=rt_hk{code}"     r = requests.get(url, headers={         "Referer": "https://finance.sina.com.cn/",

r = requests.get(url, headers={

"Referer": "https://finance.sina.com.cn/",

curl -s "https://qt.gtimg.cn/q=usAAPL"  | iconv -f GBK -t UTF-8 | tr '~' '\n' | cat -n

curl -s "https://qt.gtimg.cn/q=hk00700" | iconv -f GBK -t UTF-8 | tr '~' '\n' | cat -n

> 港股 `hk` 与 `r_hk` 两种前缀返回的字段布局完全一致（均 78 个），可互换。 > 感谢 [@HoRiZonn0](https://github.com/HoRiZonn0) 在 issue #2 中提供的完整对照，本表据此逐条复测后修订。

> 感谢 [@HoRiZonn0](https://github.com/HoRiZonn0) 在 issue #2 中提供的完整对照，本表据此逐条复测后修订。

如不确定前缀，先调 stock_search() 获取 mkt_num     """     url = "https://push2.eastmoney.com/api/qt/stock/get"

"""     url = "https://push2.eastmoney.com/api/qt/stock/get"     params = {

url = "https://push2.eastmoney.com/api/qt/stock/get"

"fields": "f43,f44,f45,f46,f47,f48,f55,f57,f58,f59,f60,f170",     }     r = requests.get(url, params=params, timeout=10)

}     r = requests.get(url, params=params, timeout=10)     d = r.json().get("data")

r = requests.get(url, params=params, timeout=10)

返回: [{date, open, high, low, close, volume}, ...]     """     url = "https://stock.finance.sina.com.cn/usstock/api/jsonp.php/var/US_MinKService.getDailyK"

"""     url = "https://stock.finance.sina.com.cn/usstock/api/jsonp.php/var/US_MinKService.getDailyK"     params = {"symbol": ticker.upper(), "num": num}

url = "https://stock.finance.sina.com.cn/usstock/api/jsonp.php/var/US_MinKService.getDailyK"     params = {"symbol": ticker.upper(), "num": num}     r = requests.get(url, params=params, headers={"Referer": "https://finance.sina.com.cn/"}, t

params = {"symbol": ticker.upper(), "num": num}     r = requests.get(url, params=params, headers={"Referer": "https://finance.sina.com.cn/"}, timeout=15)     text = r.text

r = requests.get(url, params=params, headers={"Referer": "https://finance.sina.com.cn/"}, timeout=15)

url = f"https://query2.finance.yahoo.com/v8/finance/chart/{symbol}"     r = requests.get(url, params=params, timeout=20, headers={

r = requests.get(url, params=params, timeout=20, headers={

返回: [{date, main_net, big_net, mid_net, small_net, main_pct, ...}, ...]     """     url = "https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get"

"""     url = "https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get"     params = {

url = "https://push2his.eastmoney.com/api/qt/stock/fflow/daykline/get"

"lmt": limit,     }     r = requests.get(url, params=params, timeout=15)

}     r = requests.get(url, params=params, timeout=15)     d = r.json()

r = requests.get(url, params=params, timeout=15)

CBOE_BASE = "https://cdn.cboe.com/api/global/delayed_quotes"

r = s.get(f"https://query2.finance.yahoo.com/v7/finance/options/{symbol}",

raise ValueError(f"无效的指数代码: {index!r}")     start, end = _check_range(start, end, _YMD)     raw = official_get(f"https://cdn.cboe.com/api/global/us_indices/daily_prices/{idx}_History.csv")

start, end = _check_range(start, end, _YMD)     raw = official_get(f"https://cdn.cboe.com/api/global/us_indices/daily_prices/{idx}_History.csv")     reader = csv.reader(io.StringIO(raw))

raw = official_get(f"https://cdn.cboe.com/api/global/us_indices/daily_prices/{idx}_History.csv")

返回: {"company_name": ..., "filings": [{form, date, accession_number, primary_document}, ...]}     """     url = f"https://data.sec.gov/submissions/CIK{cik}.json"

"""     url = f"https://data.sec.gov/submissions/CIK{cik}.json"     r = requests.get(url, headers=SEC_HEADERS, timeout=15)

url = f"https://data.sec.gov/submissions/CIK{cik}.json"     r = requests.get(url, headers=SEC_HEADERS, timeout=15)     r.raise_for_status()

r = requests.get(url, headers=SEC_HEADERS, timeout=15)

"primary_document": primary_docs[i] if i < len(primary_docs) else "",             "description": descriptions[i] if i < len(descriptions) else "",             "url": f"https://www.sec.gov/Archives/edgar/data/{int(cik)}/{accessions[i].replac

"description": descriptions[i] if i < len(descriptions) else "",             "url": f"https://www.sec.gov/Archives/edgar/data/{int(cik)}/{accessions[i].replace('-', '')}/{primary_docs[i]}" if i < len(primary_docs) and primary_docs[i] else "

"url": f"https://www.sec.gov/Archives/edgar/data/{int(cik)}/{accessions[i].replace('-', '')}/{primary_docs[i]}" if i < len(primary_docs) and primary_docs[i] else "",

返回: {"company": ..., "metrics": {"Revenue": [{end, val, form, filed}, ...], ...}}     """     url = f"https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json"

"""     url = f"https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json"     r = requests.get(url, headers=SEC_HEADERS, timeout=15)

url = f"https://data.sec.gov/api/xbrl/companyfacts/CIK{cik}.json"     r = requests.get(url, headers=SEC_HEADERS, timeout=15)     r.raise_for_status()

r = requests.get(url, headers=SEC_HEADERS, timeout=15)

105=NASDAQ, 106=NYSE, 107=美股ETF, 116=港股     """     url = "https://searchapi.eastmoney.com/api/suggest/get"

"""     url = "https://searchapi.eastmoney.com/api/suggest/get"     params = {

url = "https://searchapi.eastmoney.com/api/suggest/get"

"count": count,     }     r = requests.get(url, params=params, timeout=10)

}     r = requests.get(url, params=params, timeout=10)     d = r.json()

r = requests.get(url, params=params, timeout=10)

注意: 需要先获取 Yahoo cookie 才能调用，否则返回 400     """     s = requests.Session()

"""     s = requests.Session()     s.headers["User-Agent"] = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"

s = requests.Session()

s.get("https://fc.yahoo.com", timeout=10)  # 获取 cookie

url = "https://query2.finance.yahoo.com/v1/finance/search"

global _cik_cache     if not _cik_cache:         r = requests.get("https://www.sec.gov/files/company_tickers.json",

if not _cik_cache:         r = requests.get("https://www.sec.gov/files/company_tickers.json",                          headers=SEC_HEADERS, timeout=15)

r = requests.get("https://www.sec.gov/files/company_tickers.json",

url = "https://push2.eastmoney.com/api/qt/clist/get"

"po": 1 if sort_desc else 0,     }     r = requests.get(url, params=params, timeout=15)

}     r = requests.get(url, params=params, timeout=15)     d = r.json()

r = requests.get(url, params=params, timeout=15)

try:             raw = official_get(                 f"https://cdn.finra.org/equity/regsho/daily/{market}shvol{d}.txt")

raw = official_get(                 f"https://cdn.finra.org/equity/regsho/daily/{market}shvol{d}.txt")         except DataNotAvailable:

f"https://cdn.finra.org/equity/regsho/daily/{market}shvol{d}.txt")

def _si_fetch(d: str, only: str = None) -> dict:     raw = official_get(f"https://cdn.finra.org/equity/otcmarket/biweekly/shrt{d}.csv")

raw = official_get(f"https://cdn.finra.org/equity/otcmarket/biweekly/shrt{d}.csv")

for d in ([date] if date else _recent_weekdays(7)):         dt = datetime.strptime(d, "%Y%m%d")         url = (f"https://www.sec.gov/Archives/edgar/daily-index/"

dt = datetime.strptime(d, "%Y%m%d")         url = (f"https://www.sec.gov/Archives/edgar/daily-index/"                f"{dt.year}/QTR{(dt.month - 1) // 3 + 1}/form.{d}.idx")

url = (f"https://www.sec.gov/Archives/edgar/daily-index/"

filings.append({"form": form, "form_label": _FORM_LABEL.get(form, ""),                             "company": company, "cik": cik, "date": filed,                             "url": f"https://www.sec.gov/Archives/{path}" if path else None})

"company": company, "cik": cik, "date": filed,                             "url": f"https://www.sec.gov/Archives/{path}" if path else None})         if by_form:

"url": f"https://www.sec.gov/Archives/{path}" if path else None})

if date_to:         p["dateRange"], p["enddt"] = "custom", date_to     j = official_get("https://efts.sec.gov/LATEST/search-index", params=p, as_json=True)

p["dateRange"], p["enddt"] = "custom", date_to     j = official_get("https://efts.sec.gov/LATEST/search-index", params=p, as_json=True)     hits = (j.get("hits") or {}).get("hits") or []

j = official_get("https://efts.sec.gov/LATEST/search-index", params=p, as_json=True)

t = assert_us_ticker(ticker).replace(".", "-")      # SEC 代码表写 BRK-B     if _sec_tickers is None:         _sec_tickers = official_get("https://www.sec.gov/files/company_tickers.json", as_json=True)

if _sec_tickers is None:         _sec_tickers = official_get("https://www.sec.gov/files/company_tickers.json", as_json=True)     for v in _sec_tickers.values():

_sec_tickers = official_get("https://www.sec.gov/files/company_tickers.json", as_json=True)

stop：可选判断函数，已读到的行满足它就不再往更早的分页读（分页从新到旧读）。     """     j = official_get(f"https://data.sec.gov/submissions/CIK{cik10}.json", as_json=True)

"""     j = official_get(f"https://data.sec.gov/submissions/CIK{cik10}.json", as_json=True)     f = j.get("filings") or {}

j = official_get(f"https://data.sec.gov/submissions/CIK{cik10}.json", as_json=True)

for pg in sorted(f.get("files") or [], key=lambda x: x.get("filingTo") or "", reverse=True):             if (pg.get("filingTo") or "9999") >= lo and (not until or (pg.get("filingFrom") or "") <= until):                 rows += _sec_rows(off

if (pg.get("filingTo") or "9999") >= lo and (not until or (pg.get("filingFrom") or "") <= until):                 rows += _sec_rows(official_get(f"https://data.sec.gov/submissions/{pg['name']}", as_json=True))                 if stop and st

rows += _sec_rows(official_get(f"https://data.sec.gov/submissions/{pg['name']}", as_json=True))

if not acc or not doc.lower().endswith(".xml"):             continue         url = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{acc.replace('-', '')}/{doc}"

continue         url = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{acc.replace('-', '')}/{doc}"         root = _xml(official_get(url, raw=True))

url = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{acc.replace('-', '')}/{doc}"

# 按报告期取最新（晚交的旧季度不会被当成最新）；同一报告期取最晚申报的那份     r = max(cands, key=lambda x: (x["reportDate"] or "", x["filingDate"] or ""))     base = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{r['accessionNumber'].replace('-', '')}"

r = max(cands, key=lambda x: (x["reportDate"] or "", x["filingDate"] or ""))     base = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{r['accessionNumber'].replace('-', '')}"     items = ((official_get(base + "/index.json", as_json

base = f"https://www.sec.gov/Archives/edgar/data/{int(cik10)}/{r['accessionNumber'].replace('-', '')}"

try:             j = official_get(                 f"https://data.sec.gov/api/xbrl/frames/us-gaap/{tag}/{unit}/{period}.json",

j = official_get(                 f"https://data.sec.gov/api/xbrl/frames/us-gaap/{tag}/{unit}/{period}.json",                 timeout=45, as_json=True)

f"https://data.sec.gov/api/xbrl/frames/us-gaap/{tag}/{unit}/{period}.json",

"""美国国债收益率曲线（每日，1M~30Y）。政府数据，S 级。返回 [0] 为最新一日"""     year = year or datetime.now().year     url = ("https://home.treasury.gov/resource-center/data-chart-center/interest-rates/"

year = year or datetime.now().year     url = ("https://home.treasury.gov/resource-center/data-chart-center/interest-rates/"            f"daily-treasury-rates.csv/{year}/all?type=daily_treasury_yield_curve"

url = ("https://home.treasury.gov/resource-center/data-chart-center/interest-rates/"

if market_contains:         q["$where"] = f"upper(contract_market_name) like upper('%{market_contains}%')"     return official_get("https://publicreporting.cftc.gov/resource/6dca-aqww.json",

q["$where"] = f"upper(contract_market_name) like upper('%{market_contains}%')"     return official_get("https://publicreporting.cftc.gov/resource/6dca-aqww.json",                         params=q, as_json=True)

return official_get("https://publicreporting.cftc.gov/resource/6dca-aqww.json",

⚠<U+FE0F> D 级：Nasdaq 条款禁止自动抓取，仅供个人学习研究，见「数据源合规分级」"""     date = date or datetime.now().strftime("%Y-%m-%d")     j = official_get("https://api.nasdaq.com/api/calendar/earnings",

date = date or datetime.now().strftime("%Y-%m-%d")     j = official_get("https://api.nasdaq.com/api/calendar/earnings",                      params={"date": date}, headers={"Accept": "application/json"},

j = official_get("https://api.nasdaq.com/api/calendar/earnings",

if "lastNObservations" in params:      # 部分国家周末/假日记为空值（菲律宾），多取几天再截         params["lastNObservations"] += 10     rows = _sdmx_csv(f"https://stats.bis.org/api/v1/data/WS_CBPOL/{key}/all",

params["lastNObservations"] += 10     rows = _sdmx_csv(f"https://stats.bis.org/api/v1/data/WS_CBPOL/{key}/all",                      dict(params, format="csv"))

rows = _sdmx_csv(f"https://stats.bis.org/api/v1/data/WS_CBPOL/{key}/all",

if not (flow.isalnum() and _SDMX_PART.match(key)):         raise ValueError(f"非法的 ECB 数据集或序列代码：{flow!r} / {key!r}")     rows = _sdmx_csv(f"https://data-api.ecb.europa.eu/service/data/{flow}/{key}",

raise ValueError(f"非法的 ECB 数据集或序列代码：{flow!r} / {key!r}")     rows = _sdmx_csv(f"https://data-api.ecb.europa.eu/service/data/{flow}/{key}",                      dict(_period_params(last, start, end), format="csvdata"))

rows = _sdmx_csv(f"https://data-api.ecb.europa.eu/service/data/{flow}/{key}",

"""     names = {"DFR": "deposit_facility", "MRR_FR": "main_refinancing", "MLFR": "marginal_lending"}     url = "https://data-api.ecb.europa.eu/service/data/FM/B.U2.EUR.4F.KR.DFR+MRR_FR+MLFR.LEV"

names = {"DFR": "deposit_facility", "MRR_FR": "main_refinancing", "MLFR": "marginal_lending"}     url = "https://data-api.ecb.europa.eu/service/data/FM/B.U2.EUR.4F.KR.DFR+MRR_FR+MLFR.LEV"     start, end = _check_range(start, end, _PERIOD_D)

url = "https://data-api.ecb.europa.eu/service/data/FM/B.U2.EUR.4F.KR.DFR+MRR_FR+MLFR.LEV"

if not kind:         raise ValueError(f"rate 只能是 {sorted(_NYFED_RATES)}，收到 {rate!r}")     base = f"https://markets.newyorkfed.org/api/rates/{kind}/{rate.lower()}"

raise ValueError(f"rate 只能是 {sorted(_NYFED_RATES)}，收到 {rate!r}")     base = f"https://markets.newyorkfed.org/api/rates/{kind}/{rate.lower()}"     start, end = _check_range(start, end, _YMD_ONLY)

base = f"https://markets.newyorkfed.org/api/rates/{kind}/{rate.lower()}"

if not 1 <= int(last) <= 5000:         raise ValueError("last 范围 1–5000（超过 5000 时美联储返回空文件）")     text = official_get("https://www.federalreserve.gov/datadownload/Output.aspx", params={

raise ValueError("last 范围 1–5000（超过 5000 时美联储返回空文件）")     text = official_get("https://www.federalreserve.gov/datadownload/Output.aspx", params={         "rel": rel, "series": _FED_PACKAGES[rel], "lastobs": str(int(last)), "from": "", "to":

text = official_get("https://www.federalreserve.gov/datadownload/Output.aspx", params={

if fields or default_fields:         params["fields"] = fields or default_fields     j = official_get("https://api.fiscaldata.treasury.gov/services/api/fiscal_service" + path,

params["fields"] = fields or default_fields     j = official_get("https://api.fiscaldata.treasury.gov/services/api/fiscal_service" + path,                      params=params, as_json=True)

j = official_get("https://api.fiscaldata.treasury.gov/services/api/fiscal_service" + path,

_TW = {     "twse": {"base": "https://openapi.twse.com.tw/v1",

"twse": {"base": "https://openapi.twse.com.tw/v1",

"margin": "/exchangeReport/MI_MARGN", "exdividend": "/exchangeReport/TWT48U_ALL",              "dividend": "/opendata/t187ap45_L"},     "tpex": {"base": "https://www.tpex.org.tw/openapi/v1",

"dividend": "/opendata/t187ap45_L"},     "tpex": {"base": "https://www.tpex.org.tw/openapi/v1",              "quotes": "/tpex_mainboard_daily_close_quotes",

"tpex": {"base": "https://www.tpex.org.tw/openapi/v1",

_EIA_PRICE = {     "WTI": "https://www.eia.gov/dnav/pet/hist/LeafHandler.ashx?n=PET&s=RWTC&f=D",

"WTI": "https://www.eia.gov/dnav/pet/hist/LeafHandler.ashx?n=PET&s=RWTC&f=D",

"BRENT": "https://www.eia.gov/dnav/pet/hist/LeafHandler.ashx?n=PET&s=RBRTE&f=D",

"HENRY_HUB": "https://www.eia.gov/dnav/ng/hist/rngwhhdD.htm",   # 天然气走 LeafHandler 会 404

"""     rd = list(csv.reader(io.StringIO(         official_get("https://ir.eia.gov/wpsr/table1.csv").lstrip("<U+FEFF>"))))

rd = list(csv.reader(io.StringIO(         official_get("https://ir.eia.gov/wpsr/table1.csv").lstrip("<U+FEFF>"))))     if not rd or len(rd[0]) < 8 or rd[0][0].strip() != "STUB_1":

official_get("https://ir.eia.gov/wpsr/table1.csv").lstrip("<U+FEFF>"))))

official_get("https://ir.eia.gov/wpsr/table1.csv").lstrip("<U+FEFF>"))))

if not pet:         raise DataNotAvailable("EIA WPSR table1.csv 没有库存行")     g = json.loads(official_get("https://ir.eia.gov/ngs/wngsr.json").lstrip("<U+FEFF>"))

raise DataNotAvailable("EIA WPSR table1.csv 没有库存行")     g = json.loads(official_get("https://ir.eia.gov/ngs/wngsr.json").lstrip("<U+FEFF>"))     gas = []

g = json.loads(official_get("https://ir.eia.gov/ngs/wngsr.json").lstrip("<U+FEFF>"))

g = json.loads(official_get("https://ir.eia.gov/ngs/wngsr.json").lstrip("<U+FEFF>"))

_BLS_API = "https://api.bls.gov/publicAPI/v1/timeseries/data/"

_BLS_ICS = "https://www.bls.gov/schedule/news_release/bls.ics"

_DOL_CLAIMS = "https://oui.doleta.gov/unemploy/wkclaims/report.asp"

> 📦 https://github.com/simonlin1212/global-stock-data — Star ⭐ 是最好的支持