Skip to main content

ShareTop Python SDK

Python Version PyPI Package PyPI Downloads Docs GitHub Stars License

凡是数据皆有价值,前提是要放到正确位置,同时在正确的时间被使用。

ShareTop 是一个开源数据社区,主要为个人及科研团队在金融、宏观、汽车、石油等领域的科学研究提供数据清洗、结构化的API接口服务,它不以盈利为主要目的,不做任何荐股或者提供投资方向。

ShareTop Python SDK 是 ShareTop 数据长期维护的 Python 客户端,提供 金融、宏观、汽车等相关行业存量和增量数据。

“数据仅供参考,不构成投资建议”

完整文档:https://sharetop.top


安装

使用 pip 安装 ShareTop Python SDK:

pip install sharetop --upgrade

SDK 支持 Python 3.9+,推荐使用 Python 3.10 或更高版本。


获取token

关注公众号“浔溯de小仓鼠”并点击获取token

微信公众号二维码

初始化客户端

数据完全开源免费使用

获取日K线数据和股票基础信息样例代码:

from sharetop import ShareTop

# 从微信公众号里面获取token
token = ""

client = ShareTop(token=token)

# 查询日K线数据
symbol = "601717.SH"

df = client.klines.get_history_data(symbol=symbol, count=500000, period="d", adjust="before", as_df=True)
print(df)

如何使用sharetop的数据:

  • ✅ 关注微信公众号,获取token
  • ✅ 下载最新的python SDK包 sharetop,pip install sharetop --upgrade
  • ✅ 根据 文档来使用python SDK

sharetop数据包括实时行情、盘中实时更新的K线或更高频率访问等功能。


使用样例

from sharetop import ShareTop

# 从微信公众号里面获取token
token = ""

client = ShareTop(token=token)

# 获取沪深 A 股实时行情
df = client.quotes.get(symbols="600000.SH,002522.SZ,000006.SZ,688003.SH,002534.SZ", as_df=True)

print(df)

如果看到股票价格输出,说明 SDK 已配置成功!

sharetop部分功能列表:

  • ✅ 实时行情数据
  • ✅ 分钟级K线(5m、15m、30m、60m、120m)
  • ✅ 日内分时数据
  • ✅ 财报数据
  • ✅ 更高的调用频率
  • ✅ 打板专题数据

标的代码格式与支持市场

所有按标的查询的接口(行情、K 线等)均使用统一标的代码,格式为:代码.市场后缀(中间为英文点号)。

标的代码格式

  • 格式:代码.市场后缀
  • 示例:
    • 股票:600000.SH(浦发银行)、000001.SZ(平安银行)、920662.BJ(方盛股份)

代码部分使用交易所官方代码(如 6 位 A 股代码、合约代码等),市场后缀见下表。

支持的市场(后缀)

后缀 市场 说明
SH 上海证券交易所 沪市 A 股、ETF、债券等
SZ 深圳证券交易所 深市 A 股、创业板、ETF 等
BJ 北京证券交易所 北交所股票

目前支持状态

  • A 股(SH / SZ / BJ):已支持。可查实时行情、日 K、分钟 K、日内分时、财务数据等。

按标的查询时传入上述格式的字符串或列表即可:

from sharetop import ShareTop

token = ""

client = ShareTop(token=token)

# 上交所整体实时数据
df = client.quotes.get(exchange=["SSE"], as_df=True)

print(df)

基础用法

K 线获取

单个或者批量获取分钟k线:

from sharetop import ShareTop

token = ""

client = ShareTop(token=token)

symbols = ["601717.SH", "601928.SH"]

# 获取分钟 K 线,返回原始数据
kline_data = client.klines.get_batch_real_time(symbols=symbols, period="1m", count=5, adjust="before", as_df=True)
print(f"601717.SH最新的1min k线数据: {kline_data['601717.SH']}")

获取实时行情

按标的代码查询

from sharetop import ShareTop

token = ""

client = ShareTop(token=token)

symbols = ["600000.SH", "002534.SZ", "688003.SH"]

df = client.quotes.get(symbols=symbols, as_df=True)

print(df)

按标的池查询

# 获取全部 上交所 A 股行情
quotes_a = client.quotes.get(exchange=["SSE"], as_df=True)

print(quotes_a)


# 获取全部 上交所 深交所 A 股行情
quotes = client.quotes.get(exchange=["SSE", "SZSE"], as_df=True)

print(quotes)

获取打板数据

炸板池查询

from sharetop import ShareTop

token = ""

client = ShareTop(token=token)

# 获取实时炸板池数据
df = client.limit_up.limit_up_down_pool.broken_limit(as_df=True)

print(df)

强势股池查询

from sharetop import ShareTop

token = ""

client = ShareTop(token=token)

# 获取实时强势股池数据
df = client.limit_up.limit_up_down_pool.strong(as_df=True)

print(df)

加入技术分享交流群

qq群二维码

License

MIT

Metadata

Release files for sharetop 0.1.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sharetop 0.1.8
File Size Uploaded
sharetop-0.1.8.tar.gz 36.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sharetop 0.1.8
File Interpreter ABI Platform
sharetop-0.1.8-py3-none-any.whl Python 3 none any Details

Total release size: 81.9 kB

Release files / sharetop-0.1.8.tar.gz

Download URL sharetop-0.1.8.tar.gz
Size 36.6 kB
Tags Source
SHA-256 checksum
How to use checksums
eea77fb8f7cd9889cb865e2bcd0dcd04ca7219523dea7a4d7575a01e94d21e44
BLAKE2b-256 checksum
How to use checksums
33eb7d15c875dce78783030795e1b1482c1f3424070655ff693461bb98b55567
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.20

Release files / sharetop-0.1.8-py3-none-any.whl

Download URL sharetop-0.1.8-py3-none-any.whl
Size 45.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b49a8914a77ed85a0cd024e450a8230c4b158b006cc55b450002d046dd4db1f7
BLAKE2b-256 checksum
How to use checksums
3a7baf219e03009b07eb2a21fa1f0e95a0226b3284f008f1020e6c6e69169ad7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.10.20

Release history Release notifications | RSS feed

This release

0.1.8 This release

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page