# MairuiSdk (.NET)

完整接口字段说明见 [API.md](./API.md)（含沪深数据中心 / 基金 / 量化因子）。方法对照见 [API_METHOD_MAP.md](./API_METHOD_MAP.md)。


麦蕊行情 API .NET SDK（NuGet: `MairuiSdk`）。

## 支持的目标框架

| TFM | 适用场景 |
|-----|----------|
| **net462** | .NET Framework 4.6.2 / 4.7 / 4.8 桌面与服务端 |
| **netstandard2.0** | .NET Core 2.1+、.NET 5/6/7、Xamarin 等 |
| **net8.0** | .NET 8 及更高 |

> 不支持 .NET Framework 4.5 / 3.5（无完整 `HttpClient` + `async`/`Task` 栈；若需要请单独说明）。

## 安装

```bash
dotnet add package MairuiSdk
# 或 Package Manager：
# Install-Package MairuiSdk
```

## 快速开始

```csharp
using (var api = new MairuiClient(Environment.GetEnvironmentVariable("MAIRUI_LICENCE")))
{
    var list = await api.StockListAsync();
    var q = new TimeRangeQuery { St = "20240101", Et = "20241231", Lt = 5 };
    var bars = await api.StockHistoryAsync("000001.SZ", "d", "n", q);
    var rt = await api.StockRealTimeAsync("000001");
}
```

## 批量并发

```csharp
var batch = await api.MapAsync(
    async code => await api.StockLatestAsync((string)code, lt: 1),
    new List<object> { "000001.SZ", "600519.SH" },
    maxWorkers: 3
);
```

## License

MIT