OpenSource-Hub
F

free-stockdb

SHA-256
1.4k stars·Developer Tools·SHA-256 checksum verified

A local quantitative data engine for A-share stocks and ETFs, offering daily/minute K-line data, incremental sync, 39 built-in technical indicators, and multi-interface access (Python/HTTP/Excel/MCP).

A local quantitative data engine for A-shares and ETFs with incremental sync, 39 indicators, and multi-interface access.

Core Features

  • Incremental sync with resume support; data stored in Zstd compression (3x smaller than CSV/MySQL)
  • 39 built-in technical indicators + 5 index calculation methods, Rust-powered (3x faster than pandas)
  • Five calling methods: Python SDK, HTTP API, Excel/WPS macro, HTML page, AI MCP (Claude, Cursor, etc.)
  • Full forward/backward/unadjusted price support with built-in adjustment factors
  • Industry and concept sector mapping (Shenwan 3-level + 1200+ concepts) with millisecond bidirectional query

What It Can't Do

  • Currently Windows-only (v0.2.1); Mac and Linux versions coming soon.
  • Data source is configured via sync_url.txt; default uses a public node; you can switch to a local or offline source.
  • Adjustment factors come from the data source; verify prices/volumes for correctness.
  • Service listens on 127.0.0.1:7899 by default; not exposed to the internet unless you configure LAN sharing.
  • Full minute-line sync requires ~20GB disk space; ensure sufficient storage.

Use Cases

  • Full-market minute-level backtesting: locally compute indicators for 7000+ stocks without remote API constraints
  • AI-powered stock research: let AI tools (Claude, Cursor) query local market data and calculate technical indicators via MCP

Detailed Introduction

free-stockdb is a local-first quantitative data engine designed for China A-share stocks and ETFs. It eliminates the complex data engineering usually required for backtesting and research by providing an all-in-one local solution: incremental data synchronization, auto-cleaning, forward/backward adjustment, 39 technical indicators (MA, MACD, KDJ, etc.), 5 index calculation methods, and 5 calling approaches (Python SDK, HTTP API, Excel/WPS macro, HTML page, AI MCP). Data is stored locally in Zstd-compressed format, enabling offline query, batch calculation, and backtesting without relying on remote APIs. Compared to traditional online data services that require 10-15 workdays to set up full-market minute-level backtesting, free-stockdb reduces the process to under 30 minutes. It is ideal for quantitative developers, financial analysts, and AI-assisted stock research.

Tags

量化交易A股数据引擎本地数据库技术指标PythonHTTPExcelMCP

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Download the Windows release package and extract to any directory

4

Run the data update tool (double-click update.exe) and wait for sync to complete (data goes to ./data)

5

Start the stockdb service (double-click stockdb.exe, only 2.2MB)

Install Guide
  1. Download the Windows release package and extract to any directory
  2. Run the data update tool (double-click update.exe) and wait for sync to complete (data goes to ./data)
  3. Start the stockdb service (double-click stockdb.exe, only 2.2MB)
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

ae34269354186c612e8678aa7bdeab0fcff58785ac11bb5259ec5b5b91cb2f16

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Delete the extracted folder to completely uninstall. Local data remains in ./data (delete manually if needed).

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-07-29T05:28:13Z
GitHub RepositoryOfficial Website

Similar Projects