tinyshare 使用说明

代理接口说明

下载与安装

Python 侧 SDK 通过 PyPI 安装即可。

1. 环境：Python 3.8+
2. 安装 / 升级：pip install tinyshare --upgrade

Agent Skill 使用说明

若在 Cursor、Codex 等工具中为项目配置「技能」文档，可使用本仓库中的技能文件，便于助手自动选用正确的代理地址、凭证方式与三种接入路径。

1. 下载：点击上方按钮保存（默认文件名 tinyshare-tushare-proxy-SKILL.md，可改名为 SKILL.md）
2. 用法：按你所用客户端的要求，将该文件加入项目的技能目录，或作为规则 / 上下文引用（名称：tinyshare-tushare-proxy）
3. 适用场景：提到 tinyshare、自建 tushare 接口、tushare 代理、pro_api、daily/index_daily，或从官方 token 迁移到授权码时

快速开始（方式 A，推荐）

1. 安装：pip install tinyshare --upgrade
2. 将 import tushare as ts 改为：import tinyshare as ts
3. 用 tinyshare 授权码替代原 Tushare 官方 token

三种接入方式

任选其一即可；pro.xxx(...) 的方法名与参数以 Tushare Pro 文档 为准。

方式 A：tinyshare SDK

见上文「快速开始」与下方代码示例。

方式 B：HTTP POST（curl / 任意语言）

• URL：代理基址，例如 http://115.159.100.200:8080/api/tushare
• Header：Content-Type: application/json
• Body：JSON，含 api_name（接口名）、token（授权码）、params（该接口参数字典）

curl --location 'http://115.159.100.200:8080/api/tushare' \
  --header 'Content-Type: application/json' \
  --data-binary '{
    "api_name": "index_daily",
    "token": "YOUR_AUTH_CODE",
    "params": {
      "ts_code": "399300.SZ",
      "start_date": "20250721",
      "end_date": "20250729"
    }
  }'

脚本中可用 requests.post(url, json={...}) 发送相同结构。

方式 C：官方 tushare 包 + 覆盖 token 与基址

不安装 tinyshare、仍使用 import tushare as ts 时，可在创建 pro_api 后覆盖内部属性（依赖 tushare 内部实现，大版本升级后若失效请改用方式 A 或 B）。

import os
import tushare as ts

pro = ts.pro_api()
pro._DataApi__token = os.environ["TINYSHARE_TOKEN"]
pro._DataApi__http_url = "http://115.159.100.200:8080/api/tushare"

代码调用示例（方式 A）

import os
import tinyshare as ts

ts.set_token(os.environ["TINYSHARE_TOKEN"])  # 或从安全存储读取
pro = ts.pro_api()
df = pro.daily(
    ts_code="600519.SH",
    start_date="20260204",
    end_date="20260211",
)
print(df)

需求与方式对照