Baostock.NET 1.2.0

Baostock.NET

纯 .NET 9 客户端，对接 baostock 中国 A 股市场数据服务。 完整复刻 baostock Python 客户端的全部公开 API。

快速开始

dotnet add package Baostock.NET

using Baostock.NET;

await using var client = await BaostockClient.CreateAndLoginAsync();

// K 线数据（v1.2.0 BREAKING：证券代码默认东方财富风格 SH600000 / SZ000001 / BJ430047，亦兼容 sh.600000、sh600000、600000.SH等格式）
await foreach (var row in client.QueryHistoryKDataPlusAsync("SH600000",
    startDate: "2024-01-01", endDate: "2024-01-31"))
{
    Console.WriteLine($"{row.Date} {row.Close}");
}

// 财务指标
await foreach (var row in client.QueryProfitDataAsync("SH600000", 2023, 2))
{
    Console.WriteLine($"{row.RoeAvg}");
}

API 对照表

会话管理

K 线 / 行情

财务指标（季频）

估值 / 分红 / 复权

公司公告

宏观经济

基础信息 / 日历

板块 / 指数成分

.NET 扩展（Python 包未导出）

// 实时行情：三源对冲（v1.2.0 Sprint 2）
await using var client = await BaostockClient.CreateAndLoginAsync();
var quote = await client.GetRealtimeQuoteAsync("SH600519");
Console.WriteLine($"{quote.Code} {quote.Name} 现价={quote.Last} 昨收={quote.PreClose} 来源={quote.Source}");

// 批量
var quotes = await client.GetRealtimeQuotesAsync(new[] { "SH600519", "SZ000001", "BJ430047" });

// 历史 K 线：双源对冲（v1.2.0 Sprint 2 Phase 2）
// 默认 PreAdjust 前复权；500ms hedge 间隔；EM 不响应或失败时自动切到 Tencent
var rows = await client.GetHistoryKLineAsync(
    "SH600519",
    KLineFrequency.Day,
    DateTime.Today.AddDays(-30),
    DateTime.Today);
foreach (var r in rows.Take(3))
    Console.WriteLine($"{r.Date:yyyy-MM-dd} O={r.Open} C={r.Close} H={r.High} L={r.Low} 来源={r.Source}");

// 注意：北交所（BJ*）历史 K 线在当前 EM/Tencent 公网端点均不可用，会抛 AllSourcesFailedException；
// Sprint 3 计划接入替代源补齐。详见 CHANGELOG v1.2.0-preview2 Notes。

特性

• 纯 .NET — 无 Python 依赖、无 IPC、无嵌入解释器
• async/await — 全异步，IAsyncEnumerable<T> 流式返回大结果集
• 强类型 — 每个 query 有独立 record（KLineRow, ProfitRow, ...），字段类型推断为 DateOnly / decimal / long
• 自动登录 — CreateAndLoginAsync() 一行搞定
• 可测试 — 协议层与传输层分离，ITransport 可替换

要求

• .NET 9 SDK
• 网络可达 public-api.baostock.com:10030（TCP）

构建与测试

dotnet build
dotnet test                                    # 离线单测
dotnet test --filter "Category=Live"           # 联网集成测试

License

MIT — see LICENSE.

致谢

• baostock — 免费数据服务
• baostock Python 包 — 协议参考实现