# akfamily/akshare architecture

> Architecture diagram of the GitHub repository akfamily/akshare, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akfamily/akshare
- Repository: https://github.com/akfamily/akshare

## Overview

AKShare is a Python financial-data interface library: users call exported functions and receive tabular results, commonly pandas DataFrames. Its broad domain modules cover market data, fundamentals, macroeconomics, and research; individual interfaces fetch and normalize data from external providers. Shared HTTP configuration and response parsing support those interfaces. The README documents offline interface search and metadata lookup as additional capabilities. Relationships among unsampled domain modules are intentionally not inferred; the diagram focuses on documented exports, sampled calls, and shared request infrastructure.

Main entry points: [`akshare/__init__.py`](https://github.com/akfamily/akshare/blob/main/akshare/__init__.py) (AKShare API), [`akshare/fund/fund_manager.py`](https://github.com/akfamily/akshare/blob/main/akshare/fund/fund_manager.py) (Fund Managers), [`akshare/utils/http.py`](https://github.com/akfamily/akshare/blob/main/akshare/utils/http.py) (HTTP Client), [`akshare/stock`](https://github.com/akfamily/akshare/tree/main/akshare/stock) (Stock Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Public Interface"]
  node_exports["AKShare API<br/>[__init__.py]"]
  node_registry["Interface Search<br/>[registry.py]"]
end

subgraph group_markets["Market Data"]
  node_stock["Stock Data"]
  node_stock_history["Stock History<br/>[stock_hist_em.py]"]
  node_futures["Futures Data"]
  node_futures_quotes["Futures Quotes<br/>[futures_zh_sina.py]"]
  node_options["Options Data"]
  node_indices["Index Data"]
end

subgraph group_finance["Financial Data"]
  node_bonds["Bond Data"]
  node_funds["Fund Data"]
  node_fund_manager["Fund Managers<br/>[fund_manager.py]"]
  node_macro["Macro Data"]
  node_fx_rates["FX And Rates"]
  node_alternative["Alternative Data"]
end

subgraph group_research["Research Data"]
  node_research_api["Research Data"]
  node_indicators["Indicators"]
end

subgraph group_infra["Request Infrastructure"]
  node_http["HTTP Client<br/>[http.py]"]
  node_config["Network Config<br/>[context.py]"]
  node_jsonish["Response Parser<br/>[jsonish.py]"]
  node_datasets["Bundled Datasets<br/>[datasets.py]"]
  node_errors["Error Types<br/>[exceptions.py]"]
end

node_user(("Python User"))
node_eastmoney(("Eastmoney"))
node_sina(("Sina"))

node_user -->|"calls"| node_exports
node_exports -->|"exports"| node_stock_history
node_exports -->|"exports"| node_stock
node_exports -->|"exports"| node_futures
node_exports -->|"exports"| node_indices
node_exports -->|"exports"| node_macro
node_exports -->|"exports"| node_research_api
node_user -->|"searches"| node_registry
node_user -->|"calls"| node_fund_manager
node_fund_manager -->|"fetches"| node_eastmoney
node_fund_manager -->|"requests via"| node_http
node_fund_manager -->|"parses with"| node_jsonish
node_user -.->|"requests data"| node_stock
node_user -.->|"requests data"| node_futures
node_user -.->|"requests data"| node_options
node_user -.->|"requests data"| node_bonds
node_user -.->|"requests data"| node_funds
node_user -.->|"requests data"| node_macro
node_user -.->|"requests data"| node_fx_rates
node_user -.->|"requests data"| node_alternative
node_user -.->|"requests data"| node_indicators
node_stock_history -->|"requests via"| node_http
node_futures_quotes -->|"requests via"| node_http
node_futures_quotes -->|"fetches"| node_sina
node_http -->|"reads settings"| node_config
node_jsonish -->|"raises"| node_errors
node_stock -.->|"fetches from"| node_eastmoney
node_macro -.->|"fetches from"| node_eastmoney

click node_exports "https://github.com/akfamily/akshare/blob/main/akshare/__init__.py"
click node_registry "https://github.com/akfamily/akshare/blob/main/akshare/registry.py"
click node_stock "https://github.com/akfamily/akshare/tree/main/akshare/stock"
click node_stock_history "https://github.com/akfamily/akshare/blob/main/akshare/stock/quote/stock_hist_em.py"
click node_futures "https://github.com/akfamily/akshare/tree/main/akshare/futures"
click node_futures_quotes "https://github.com/akfamily/akshare/blob/main/akshare/futures/futures_zh_sina.py"
click node_options "https://github.com/akfamily/akshare/tree/main/akshare/option"
click node_indices "https://github.com/akfamily/akshare/tree/main/akshare/index"
click node_bonds "https://github.com/akfamily/akshare/tree/main/akshare/bond"
click node_funds "https://github.com/akfamily/akshare/tree/main/akshare/fund"
click node_fund_manager "https://github.com/akfamily/akshare/blob/main/akshare/fund/fund_manager.py"
click node_macro "https://github.com/akfamily/akshare/tree/main/akshare/macro"
click node_fx_rates "https://github.com/akfamily/akshare/tree/main/akshare/fx"
click node_alternative "https://github.com/akfamily/akshare/tree/main/akshare/alternative"
click node_research_api "https://github.com/akfamily/akshare/tree/main/akshare/research"
click node_indicators "https://github.com/akfamily/akshare/tree/main/akshare/indicator"
click node_http "https://github.com/akfamily/akshare/blob/main/akshare/utils/http.py"
click node_config "https://github.com/akfamily/akshare/blob/main/akshare/utils/context.py"
click node_jsonish "https://github.com/akfamily/akshare/blob/main/akshare/utils/jsonish.py"
click node_datasets "https://github.com/akfamily/akshare/blob/main/akshare/datasets.py"
click node_errors "https://github.com/akfamily/akshare/blob/main/akshare/exceptions.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_exports,node_registry,node_user toneBlue
class node_stock,node_stock_history,node_futures,node_futures_quotes,node_options,node_indices toneAmber
class node_bonds,node_funds,node_fund_manager,node_macro,node_fx_rates,node_alternative toneMint
class node_research_api,node_indicators toneRose
class node_http,node_config,node_jsonish,node_datasets,node_errors,node_eastmoney,node_sina toneIndigo
```

## Components

### Public Interface

- [AKShare API](https://github.com/akfamily/akshare/blob/main/akshare/__init__.py): `akshare/__init__.py`
- [Interface Search](https://github.com/akfamily/akshare/blob/main/akshare/registry.py): `akshare/registry.py`

### Market Data

- [Stock Data](https://github.com/akfamily/akshare/tree/main/akshare/stock): `akshare/stock`
- [Stock History](https://github.com/akfamily/akshare/blob/main/akshare/stock/quote/stock_hist_em.py): `akshare/stock/quote/stock_hist_em.py`
- [Futures Data](https://github.com/akfamily/akshare/tree/main/akshare/futures): `akshare/futures`
- [Futures Quotes](https://github.com/akfamily/akshare/blob/main/akshare/futures/futures_zh_sina.py): `akshare/futures/futures_zh_sina.py`
- [Options Data](https://github.com/akfamily/akshare/tree/main/akshare/option): `akshare/option`
- [Index Data](https://github.com/akfamily/akshare/tree/main/akshare/index): `akshare/index`

### Financial Data

- [Bond Data](https://github.com/akfamily/akshare/tree/main/akshare/bond): `akshare/bond`
- [Fund Data](https://github.com/akfamily/akshare/tree/main/akshare/fund): `akshare/fund`
- [Fund Managers](https://github.com/akfamily/akshare/blob/main/akshare/fund/fund_manager.py): `akshare/fund/fund_manager.py`
- [Macro Data](https://github.com/akfamily/akshare/tree/main/akshare/macro): `akshare/macro`
- [FX And Rates](https://github.com/akfamily/akshare/tree/main/akshare/fx): `akshare/fx`
- [Alternative Data](https://github.com/akfamily/akshare/tree/main/akshare/alternative): `akshare/alternative`

### Research Data

- [Research Data](https://github.com/akfamily/akshare/tree/main/akshare/research): `akshare/research`
- [Indicators](https://github.com/akfamily/akshare/tree/main/akshare/indicator): `akshare/indicator`

### Request Infrastructure

- [HTTP Client](https://github.com/akfamily/akshare/blob/main/akshare/utils/http.py): `akshare/utils/http.py`
- [Network Config](https://github.com/akfamily/akshare/blob/main/akshare/utils/context.py): `akshare/utils/context.py`
- [Response Parser](https://github.com/akfamily/akshare/blob/main/akshare/utils/jsonish.py): `akshare/utils/jsonish.py`
- [Bundled Datasets](https://github.com/akfamily/akshare/blob/main/akshare/datasets.py): `akshare/datasets.py`
- [Error Types](https://github.com/akfamily/akshare/blob/main/akshare/exceptions.py): `akshare/exceptions.py`

### Other components

- **Python User**
- **Eastmoney**
- **Sina**

## Connections

- Python User → AKShare API: calls (evidence: `README.md`)
- AKShare API → Stock History: exports (evidence: `akshare/__init__.py`)
- AKShare API → Stock Data: exports (evidence: `akshare/__init__.py`)
- AKShare API → Futures Data: exports (evidence: `akshare/__init__.py`)
- AKShare API → Index Data: exports (evidence: `akshare/__init__.py`)
- AKShare API → Macro Data: exports (evidence: `akshare/__init__.py`)
- AKShare API → Research Data: exports (evidence: `akshare/__init__.py`)
- Python User → Interface Search: searches (evidence: `README.md`)
- Python User → Fund Managers: calls (evidence: `akshare/fund/fund_manager.py`)
- Fund Managers → Eastmoney: fetches (evidence: `akshare/fund/fund_manager.py`)
- Fund Managers → HTTP Client: requests via (evidence: `akshare/fund/fund_manager.py`)
- Fund Managers → Response Parser: parses with (evidence: `akshare/fund/fund_manager.py`)
- Python User → Stock Data: requests data
- Python User → Futures Data: requests data
- Python User → Options Data: requests data
- Python User → Bond Data: requests data
- Python User → Fund Data: requests data
- Python User → Macro Data: requests data
- Python User → FX And Rates: requests data
- Python User → Alternative Data: requests data
- Python User → Indicators: requests data
- Stock History → HTTP Client: requests via
- Futures Quotes → HTTP Client: requests via (evidence: `akshare/futures/futures_zh_sina.py`)
- Futures Quotes → Sina: fetches (evidence: `akshare/futures/futures_zh_sina.py`)
- HTTP Client → Network Config: reads settings (evidence: `akshare/utils/http.py`)
- Response Parser → Error Types: raises (evidence: `akshare/utils/jsonish.py`)
- Stock Data → Eastmoney: fetches from
- Macro Data → Eastmoney: fetches from
