{"id":"c41bca0b-fb18-49e3-ae6d-2c122fb632a2","shortId":"f4UUTd","kind":"skill","title":"akshare-docs","tagline":"AKShare 开源金融数据接口库，提供股票、期货、期权、基金、外汇、债券、指数、加密货币等全品类金融数据；当用户需要获取各类金融市场数据时使用","description":"# AKShare 金融数据获取\n\n## 任务目标\n- 本 Skill 用于：通过 AKShare 接口获取全品类金融市场数据\n- 能力包含：股票、期货、期权、基金、外汇、债券、指数、加密货币、宏观经济等数据\n- 触发条件：用户提及 AKShare 或需要获取各类金融数据时\n\n## 前置准备\n- 依赖说明：安装 akshare 库（已包含在 dependency 中）\n- 凭证配置：AKShare 无需注册或 API Key，直接调用即可使用\n- 环境要求：Python 3.9+，建议定期更新 `pip install akshare --upgrade`\n\n## 操作步骤\n- 标准流程：\n  1. 确定数据需求 — 智能体理解用户意图（股票/期货/基金/外汇等）\n  2. 调用对应脚本 — 根据数据类型选择脚本\n  3. 解析结果 — 智能体分析返回的 JSON 格式数据\n- 脚本调用映射：\n  - 股票数据 → `python scripts/stock_data.py --type hist --symbol 000001 --start 20240101 --end 20240131`\n  - 期货数据 → `python scripts/futures_data.py --type daily --exchange CFFEX --start 20240101 --end 20240131`\n  - 基金数据 → `python scripts/fund_data.py --type etf --symbol 510300`\n  - 外汇数据 → `python scripts/forex_data.py --type spot --symbol usd`\n  - 宏观经济 → `python scripts/macro_data.py --type gdp`\n  - 加密货币 → `python scripts/crypto_data.py --type price --symbol BTC/USDT`\n- 可选分支：\n  - 当需要多只标的：使用逗号分隔多个代码\n  - 当需要指定周期：使用 `--period` 参数（daily/weekly/monthly）\n  - 当需要复权数据：使用 `--adjust` 参数（qfq/hfq/空值）\n\n## 使用示例\n- 示例1：获取股票历史K线\n  - 场景/输入：用户说\"获取贵州茅台2024年的日K线数据\"\n  - 预期产出：返回日期、开盘价、最高价、最低价、收盘价、成交量等OHLCV数据\n  - 关键要点：调用 `python scripts/stock_data.py --type hist --symbol 600519 --start 20240101 --end 20241231 --period daily --adjust qfq`\n- 示例2：获取期货数据\n  - 场景/输入：用户说\"查看沪深300股指期货数据\"\n  - 预期产出：返回期货合约的K线数据、持仓量、成交量等信息\n  - 关键要点：调用 `python scripts/futures_data.py --type daily --symbol IF2406 --start 20240101 --end 20240131`\n- 示例3：获取基金数据\n  - 场景/输入：用户说\"查询沪深300ETF的行情\"\n  - 预期产出：返回ETF的实时行情或历史净值数据\n  - 关键要点：调用 `python scripts/fund_data.py --type etf --symbol 510300`\n- 示例4：获取宏观经济数据\n  - 场景/输入：用户说\"查看中国GDP数据\"\n  - 预期产出：返回GDP历史数据和最新值\n  - 关键要点：调用 `python scripts/macro_data.py --type gdp`\n\n## 数据分类详解\n\n### 股票数据（A股/港股/美股）\n- **实时行情**：`ak.stock_zh_a_spot_em()` - 全部A股实时行情\n- **历史K线**：`ak.stock_zh_a_hist(symbol, period, start_date, end_date, adjust)`\n- **分钟K线**：`ak.stock_zh_a_hist_min_em(symbol, period, start_date, end_date)`\n- **个股信息**：`ak.stock_individual_info_em(symbol)` - 基本信息、市值、行业等\n- **财务数据**：`ak.stock_fundamental(symbol)` - 基本面数据\n- **估值指标**：`ak.stock_valuation(symbol)` - PE、PB等\n- **港股数据**：`ak.stock_hk_spot_em()`, `ak.stock_hk_hist()`\n- **美股数据**：`ak.stock_us_daily(symbol)`, `ak.stock_us_spot_em()`\n\n### 期货数据\n- **期货行情**：`ak.futures_zh_spot()` - 实时行情\n- **期货K线**：`get_futures_daily(start_date, end_date, market)` - 按交易所\n- **库存数据**：`ak.futures_inventory_99(symbol)` - 期货库存\n\n### 基金数据\n- **ETF行情**：`ak.fund_etf_spot_em()` - ETF实时行情\n- **ETF历史**：`ak.fund_etf_hist_em(symbol, period, start_date, end_date, adjust)`\n- **开放式基金**：`ak.fund_open_fund_daily_em(symbol)` - 每日净值\n- **基金评级**：`ak.fund_rating_all()` - 基金评级信息\n\n### 期权数据\n- **期权历史**：`ak.option_hist_dce(symbol)` - 交易所期权数据\n- **ETF期权**：`ak.option_sse_spot_price(symbol)` - 上证50ETF期权\n\n### 债券数据\n- **可转债**：`ak.bond_zh_cov()` - 可转债列表\n- **可转债K线**：`ak.bond_zh_hs_cov_daily(symbol)` - 可转债历史数据\n- **债券报价**：`ak.bond_spot_quote()` - 中国债券现货报价\n\n### 外汇贵金属\n- **外汇行情**：`ak.forex_spot_em()` - 外汇实时行情\n- **汇率数据**：`ak.forex_usd_cny()` - 美元兑人民币\n- **贵金属**：`ak.metals_gold()` - 国际金价\n\n### 指数数据\n- **A股指数**：`ak.stock_zh_index_daily_em(symbol)` - 指数历史数据\n- **指数成分**：`ak.index_stock_cons_csindex(symbol)` - 指数成分股\n\n### 加密货币\n- **币种列表**：`ak.crypto_binance_symbols()` - 币安交易对\n- **实时价格**：`ak.crypto_binance_btc_usdt_spot()` - BTC/USDT价格\n- **K线数据**：`ak.crypto_binance_btc_usdt_kline(period)` - 加密货币K线\n\n### 宏观经济\n- **中国GDP**：`ak.macro_china_gdp()`, `ak.macro_china_gdp_yearly()`\n- **CPI数据**：`ak.macro_china_cpi_yearly()`, `ak.macro_china_cpi()`\n- **PMI数据**：`ak.macro_china_pmi()`\n- **美国数据**：`ak.macro_usa_non_farm()`, `ak.macro_usa_cpi_monthly()`\n\n### 特色数据\n- **龙虎榜**：`ak.stock_lhb_detail_em(start_date, end_date)` - 龙虎榜详情\n- **融资融券**：`ak.stock_margin_sse(start_date, end_date)` - 融资融券数据\n- **北向资金**：`ak.stock_hsgt_hist_em(symbol)` - 陆港通数据\n- **股东数据**：`ak.stock_gdfx_top_10_em(symbol, date)` - 前十大股东\n- **板块行情**：`ak.stock_board_industry_name_em()` - 行业板块\n- **限售解禁**：`ak.stock_restricted_release_queue_em(symbol)` - 限售解禁\n- **资金流向**：`ak.stock_market_fund_flow()` - 市场资金流向\n\n## 资源索引\n### 脚本：\n- [scripts/stock_data.py](scripts/stock_data.py)（用途与参数：获取股票K线/行情/财务数据，支持 --type/--symbol/--start/--end/--period/--adjust）\n- [scripts/futures_data.py](scripts/futures_data.py)（用途与参数：获取期货数据，支持 --type/--symbol/--exchange/--start/--end）\n- [scripts/fund_data.py](scripts/fund_data.py)（用途与参数：获取基金数据，支持 --type/--symbol/--start/--end）\n- [scripts/forex_data.py](scripts/forex_data.py)（用途与参数：获取外汇贵金属数据，支持 --type/--symbol）\n- [scripts/macro_data.py](scripts/macro_data.py)（用途与参数：获取宏观经济数据，支持 --type）\n- [scripts/crypto_data.py](scripts/crypto_data.py)（用途与参数：获取加密货币数据，支持 --type/--symbol/--period）\n- [scripts/index_data.py](scripts/index_data.py)（用途与参数：获取指数数据，支持 --type/--symbol/--start/--end）\n- [scripts/option_data.py](scripts/option_data.py)（用途与参数：获取期权数据，支持 --type/--symbol）\n- [scripts/bond_data.py](scripts/bond_data.py)（用途与参数：获取债券数据，支持 --type/--symbol）\n- [scripts/special_data.py](scripts/special_data.py)（用途与参数：获取龙虎榜/融资融券/北向资金等特色数据，支持 --type/--symbol/--start/--end）\n\n### 参考文档：\n- [股票数据文档](references/stock.md)（何时读取：需要查看股票相关API参数说明时）\n- [期货数据文档](references/futures.md)（何时读取：需要查看期货相关API参数说明时）\n- [基金数据文档](references/fund.md)（何时读取：需要查看基金相关API参数说明时）\n- [宏观经济文档](references/macro.md)（何时读取：需要查看宏观数据API参数说明时）\n- [AKShare官方文档](https://akshare.akfamily.xyz)（何时读取：需要查看最新API文档时）\n\n## 注意事项\n- AKShare 无需注册或 API Key，直接调用即可使用\n- A股股票代码格式：纯数字代码（如 000001、600519），不带市场前缀\n- 港股股票代码格式：纯数字代码（如 00700）\n- 美股股票代码格式：英文代码（如 AAPL、TSLA）\n- 数据列名：A股数据为中文列名，美股/港股数据为英文列名\n- 建议定期更新AKShare版本：`pip install akshare --upgrade`\n- 由于上游数据源变化，接口更新频繁，遇到错误时可先尝试更新版本\n- 脚本返回 JSON 格式数据，智能体负责解析并转换为用户友好的展示\n- 非Python用户可使用 AKTools HTTP API封装\n- 数据仅供学术研究使用，不构成投资建议\n\n## 快速参考\n### 函数命名规则\n```\n{asset_type}_{market}_{data_type}_{data_source}\n```\n- **Asset type**: `stock`（股票）, `futures`（期货）, `fund`（基金）, `bond`（债券）, `forex`（外汇）, `option`（期权）, `macro`（宏观）, `index`（指数）\n- **Market**: `zh`（中国）, `us`（美国）, `hk`（香港）, 或交易所代码\n- **Data type**: `spot`（实时）, `hist`（历史）, `daily`（日线）, `minute`（分钟）\n- **Data source**: `em`（东方财富）, `sina`（新浪财经）, 交易所缩写\n\n### 复权类型\n- `\"\"` - 不复权\n- `\"qfq\"` - 前复权\n- `\"hfq\"` - 后复权\n\n### 周期类型\n- `\"daily\"` - 日线\n- `\"weekly\"` - 周线\n- `\"monthly\"` - 月线\n- `\"1\"`, `\"5\"`, `\"15\"`, `\"30\"`, `\"60\"` - 分钟线","tags":["akshare","docs","finance","quant","skills","lzwme","agent-skills"],"capabilities":["skill","source-lzwme","skill-akshare-docs","topic-agent-skills","topic-skills"],"categories":["finance-quant-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/lzwme/finance-quant-skills/akshare-docs","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add lzwme/finance-quant-skills","source_repo":"https://github.com/lzwme/finance-quant-skills","install_from":"skills.sh"}},"qualityScore":"0.469","qualityRationale":"deterministic score 0.47 from registry signals: · indexed on github topic:agent-skills · 39 github stars · SKILL.md body (6,090 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:58:28.359Z","embedding":null,"createdAt":"2026-05-09T01:05:17.991Z","updatedAt":"2026-05-18T18:58:28.359Z","lastSeenAt":"2026-05-18T18:58:28.359Z","tsv":"'000001':84,642 '00700':648 '1':62,741 '10':497 '15':743 '2':69 '20240101':86,97,163,189 '20240131':88,99,191 '20241231':165 '3':72 '3.9':54 '30':744 '5':742 '510300':106,207 '60':745 '600519':161,643 '99':315 'aapl':652 'adjust':136,168,245,336,537 'ak.bond':366,371,379 'ak.crypto':416,421,429 'ak.forex':385,390 'ak.fund':320,326,338,346 'ak.futures':298,313 'ak.index':408 'ak.macro':438,441,446,450,454,458,462 'ak.metals':395 'ak.option':352,358 'ak.stock':228,235,247,260,269,274,280,284,288,292,400,468,478,487,494,503,510,518 'akshar':2,4,15,22,36,41,47,58,634,661 'akshare-doc':1 'akshare.akfamily.xyz':630 'akshare官方文档':629 'aktool':671 'api':49,636 'api封装':673 'asset':678,685 'a股':224 'a股指数':399 'a股数据为中文列名':655 'a股股票代码格式':639 'binanc':417,422,430 'board':504 'bond':693 'btc':423,431 'btc/usdt':125,426 'cffex':95 'china':439,442,447,451,455 'cni':392 'con':410 'cov':368,374 'cpi':448,452,464 'cpi数据':445 'csindex':411 'daili':93,167,185,290,305,341,375,403,717,735 'daily/weekly/monthly':133 'data':681,683,711,721 'date':242,244,256,258,307,309,333,335,473,475,482,484,500 'dce':354 'depend':44 'detail':470 'doc':3 'em':232,252,263,283,295,323,329,342,387,404,471,490,498,507,514,723 'end':87,98,164,190,243,257,308,334,474,483,535,547,556,586,611 'etf':104,205,321,327 'etf历史':325 'etf实时行情':324 'etf期权':357 'etf行情':319 'exchang':94,545 'farm':461 'flow':521 'forex':695 'fund':340,520,691 'fundament':270 'futur':304,689 'gdfx':495 'gdp':118,221,440,443 'get':303 'gold':396 'hfq':732 'hist':82,159,238,250,286,328,353,489,715 'hk':281,285,708 'hs':373 'hsgt':488 'http':672 'if2406':187 'index':402,701 'individu':261 'industri':505 'info':262 'instal':57,660 'inventori':314 'json':75,667 'key':50,637 'kline':433 'k线数据':428 'lhb':469 'macro':699 'margin':479 'market':310,519,680,703 'min':251 'minut':719 'month':465,739 'name':506 'non':460 'open':339 'option':697 'pb等':278 'pe':277 'period':131,166,240,254,331,434,536,577 'pip':56,659 'pmi':456 'pmi数据':453 'price':123,361 'python':53,79,90,101,108,115,120,156,182,202,218 'qfq':169,730 'qfq/hfq':138 'queue':513 'quot':381 'rate':347 'references/fund.md':622 'references/futures.md':618 'references/macro.md':626 'references/stock.md':614 'releas':512 'restrict':511 'scripts/bond_data.py':594,595 'scripts/crypto_data.py':121,570,571 'scripts/forex_data.py':109,557,558 'scripts/fund_data.py':102,203,548,549 'scripts/futures_data.py':91,183,538,539 'scripts/index_data.py':578,579 'scripts/macro_data.py':116,219,564,565 'scripts/option_data.py':587,588 'scripts/special_data.py':601,602 'scripts/stock_data.py':80,157,525,526 'sina':725 'skill':19 'skill-akshare-docs' 'sourc':684,722 'source-lzwme' 'spot':111,231,282,294,300,322,360,380,386,425,713 'sse':359,480 'start':85,96,162,188,241,255,306,332,472,481,534,546,555,585,610 'stock':409,687 'symbol':83,105,112,124,160,186,206,239,253,264,271,276,291,316,330,343,355,362,376,405,412,418,491,499,515,533,544,554,563,576,584,593,600,609 'top':496 'topic-agent-skills' 'topic-skills' 'tsla':653 'type':81,92,103,110,117,122,158,184,204,220,532,543,553,562,569,575,583,592,599,608,679,682,686,712 'upgrad':59,662 'us':289,293,706 'usa':459,463 'usd':113,391 'usdt':424,432 'valuat':275 'week':737 'year':444,449 'zh':229,236,248,299,367,372,401,704 '上证50etf期权':363 '不复权':729 '不带市场前缀':644 '不构成投资建议':675 '东方财富':724 '个股信息':259 '中':45 '中国':705 '中国gdp':437 '中国债券现货报价':382 '交易所期权数据':356 '交易所缩写':727 '价格':427 '任务目标':17 '估值指标':273 '何时读取':615,619,623,627,631 '使用':130,135 '使用示例':140 '使用逗号分隔多个代码':128 '依赖说明':39 '债券':11,30,694 '债券报价':378 '债券数据':364 '全部a股实时行情':233 '关键要点':154,180,200,216 '凭证配置':46 '函数命名规则':677 '分钟':720 '分钟k线':246 '分钟线':746 '前十大股东':501 '前复权':731 '前置准备':38 '加密货币':32,119,414 '加密货币k线':435 '加密货币等全品类金融数据':13 '北向资金':486 '北向资金等特色数据':606 '历史':716 '历史k线':234 '参数':132,137 '参考文档':612 '可转债':365 '可转债k线':370 '可转债列表':369 '可转债历史数据':377 '可选分支':126 '后复权':733 '周期类型':734 '周线':738 '国际金价':397 '场景':143,172,194,210 '基本信息':265 '基本面数据':272 '基金':9,28,67,692 '基金数据':100,318 '基金数据文档':621 '基金评级':345 '基金评级信息':349 '复权类型':728 '外汇':10,29,696 '外汇实时行情':388 '外汇数据':107 '外汇等':68 '外汇行情':384 '外汇贵金属':383 '如':641,647,651 '安装':40 '宏观':700 '宏观经济':114,436 '宏观经济文档':625 '宏观经济等数据':33 '实时':714 '实时价格':420 '实时行情':227,301 '已包含在':43 '币安交易对':419 '币种列表':415 '市值':266 '市场资金流向':522 '库':42 '库存数据':312 '建议定期更新':55 '建议定期更新akshare版本':658 '开放式基金':337 '开源金融数据接口库':5 '开盘价':149 '当用户需要获取各类金融市场数据时使用':14 '当需要复权数据':134 '当需要多只标的':127 '当需要指定周期':129 '快速参考':676 '成交量等ohlcv数据':153 '成交量等信息':179 '或交易所代码':710 '或需要获取各类金融数据时':37 '持仓量':178 '指数':12,31,702 '指数历史数据':406 '指数成分':407 '指数成分股':413 '指数数据':398 '按交易所':311 '接口更新频繁':664 '接口获取全品类金融市场数据':23 '提供股票':6 '操作步骤':60 '支持':531,542,552,561,568,574,582,591,598,607 '收盘价':152 '数据仅供学术研究使用':674 '数据分类详解':222 '数据列名':654 '新浪财经':726 '无需注册或':48,635 '日线':718,736 '智能体分析返回的':74 '智能体理解用户意图':64 '智能体负责解析并转换为用户友好的展示':669 '最低价':151 '最高价':150 '月线':740 '期权':8,27,698 '期权历史':351 '期权数据':350 '期货':7,26,66,690 '期货k线':302 '期货库存':317 '期货数据':89,296 '期货数据文档':617 '期货行情':297 '本':18 '板块行情':502 '查看中国gdp数据':213 '查看沪深300股指期货数据':175 '查询沪深300etf的行情':197 '标准流程':61 '根据数据类型选择脚本':71 '格式数据':76,668 '每日净值':344 '汇率数据':389 '注意事项':633 '港股':225 '港股数据':279 '港股数据为英文列名':657 '港股股票代码格式':645 '特色数据':466 '环境要求':52 '用于':20 '用户提及':35 '用户说':145,174,196,212 '用途与参数':527,540,550,559,566,572,580,589,596,603 '由于上游数据源变化':663 '直接调用即可使用':51,638 '确定数据需求':63 '示例1':141 '示例2':170 '示例3':192 '示例4':208 '空值':139 '纯数字代码':640,646 '美元兑人民币':393 '美国':707 '美国数据':457 '美股':226,656 '美股数据':287 '美股股票代码格式':649 '股东数据':493 '股票':25,65,688 '股票数据':78,223 '股票数据文档':613 '能力包含':24 '脚本':524 '脚本调用映射':77 '脚本返回':666 '英文代码':650 '获取债券数据':597 '获取加密货币数据':573 '获取基金数据':193,551 '获取外汇贵金属数据':560 '获取宏观经济数据':209,567 '获取指数数据':581 '获取期权数据':590 '获取期货数据':171,541 '获取股票k线':528 '获取股票历史k线':142 '获取贵州茅台2024年的日k线数据':146 '获取龙虎榜':604 '融资融券':477,605 '融资融券数据':485 '行业板块':508 '行业等':267 '行情':529 '解析结果':73 '触发条件':34 '调用':155,181,201,217 '调用对应脚本':70 '财务数据':268,530 '贵金属':394 '资源索引':523 '资金流向':517 '输入':144,173,195,211 '返回etf的实时行情或历史净值数据':199 '返回gdp历史数据和最新值':215 '返回日期':148 '返回期货合约的k线数据':177 '通过':21 '遇到错误时可先尝试更新版本':665 '金融数据获取':16 '陆港通数据':492 '限售解禁':509,516 '需要查看基金相关api参数说明时':624 '需要查看宏观数据api参数说明时':628 '需要查看最新api文档时':632 '需要查看期货相关api参数说明时':620 '需要查看股票相关api参数说明时':616 '非python用户可使用':670 '预期产出':147,176,198,214 '香港':709 '龙虎榜':467 '龙虎榜详情':476","prices":[{"id":"9bcff84b-312c-4d2b-a1f0-9d04b66f07c9","listingId":"c41bca0b-fb18-49e3-ae6d-2c122fb632a2","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"lzwme","category":"finance-quant-skills","install_from":"skills.sh"},"createdAt":"2026-05-09T01:05:17.991Z"}],"sources":[{"listingId":"c41bca0b-fb18-49e3-ae6d-2c122fb632a2","source":"github","sourceId":"lzwme/finance-quant-skills/akshare-docs","sourceUrl":"https://github.com/lzwme/finance-quant-skills/tree/main/skills/akshare-docs","isPrimary":false,"firstSeenAt":"2026-05-09T01:05:17.991Z","lastSeenAt":"2026-05-18T18:58:28.359Z"}],"details":{"listingId":"c41bca0b-fb18-49e3-ae6d-2c122fb632a2","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"lzwme","slug":"akshare-docs","github":{"repo":"lzwme/finance-quant-skills","stars":39,"topics":["agent-skills","skills"],"license":null,"html_url":"https://github.com/lzwme/finance-quant-skills","pushed_at":"2026-05-18T07:34:02Z","description":"一个面向金融量化交易领域的 Agent Skills 技能维护仓库，主要聚焦A股量化交易。","skill_md_sha":"78b3c242de4052b8fba0ab378c8083ba40dbfdc4","skill_md_path":"skills/akshare-docs/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/lzwme/finance-quant-skills/tree/main/skills/akshare-docs"},"layout":"multi","source":"github","category":"finance-quant-skills","frontmatter":{"name":"akshare-docs","description":"AKShare 开源金融数据接口库，提供股票、期货、期权、基金、外汇、债券、指数、加密货币等全品类金融数据；当用户需要获取各类金融市场数据时使用"},"skills_sh_url":"https://skills.sh/lzwme/finance-quant-skills/akshare-docs"},"updatedAt":"2026-05-18T18:58:28.359Z"}}