C# SDK

老虎证券 OpenAPI C# SDK，提供行情查询、交易下单、账户管理和实时推送。本文档以 SDK 1.2.3 源码为准。

目标框架：.NET 10.0
推荐使用 Visual Studio 2022
源码仓库：openapi-cs-sdk
NuGet 包：TigerBrokers.OpenAPI

文档导航

调用模型

QuoteApiService 和 TradeApiService 中的大写成员是服务端操作名常量，并不是可调用方法。除五个期权行权便捷方法外，HTTP API 都使用 TigerRequest<TResponse> 指定操作、请求模型和精确响应类型，再调用 QuoteClient.ExecuteAsync 或 TradeClient.ExecuteAsync。

安装

dotnet add package TigerBrokers.OpenAPI

或在 Visual Studio 中通过 NuGet 包管理器搜索 TigerBrokers.OpenAPI 安装。

配置

方式一：从 properties 配置文件加载

TigerConfig config = new TigerConfig()
{
    ConfigFilePath = "your_config_directory_path"
};

配置文件格式：

tiger_id=你的开发者ID
private_key=你的RSA私钥
default_account=你的交易账户

方式二：代码直接设置

TigerConfig config = new TigerConfig()
{
    TigerId = "你的 tiger_id",
    PrivateKey = "你的 RSA 私钥",
    DefaultAccount = "你的交易账户",
    Language = Language.zh_CN,
    TimeZone = CustomTimeZone.HK_ZONE
};

配置项说明

配置项	说明	必填	默认值
TigerId	开发者 ID	是	-
PrivateKey	RSA 私钥	是	-
DefaultAccount	交易账户	否	-
Language	语言（zh_CN/en_US）	否	zh_CN
TimeZone	时区	否	HK_ZONE
ConfigFilePath	配置文件路径	否	-

快速开始

using TigerOpenAPI.Common;
using TigerOpenAPI.Common.Enum;
using TigerOpenAPI.Config;
using TigerOpenAPI.Model;
using TigerOpenAPI.Quote;
using TigerOpenAPI.Quote.Response;
using TigerOpenAPI.Quote.Model;

// 创建配置
TigerConfig config = new TigerConfig()
{
    ConfigFilePath = "your_config_directory_path",
    Language = Language.zh_CN,
    TimeZone = CustomTimeZone.HK_ZONE
};

// 创建行情客户端
QuoteClient quoteClient = new QuoteClient(config);

// 查询市场状态
TigerRequest<MarketStateResponse> request = new TigerRequest<MarketStateResponse>()
{
    ApiMethodName = QuoteApiService.MARKET_STATE,
    ModelValue = new QuoteMarketModel() { Market = Market.US }
};
MarketStateResponse? response = await quoteClient.ExecuteAsync(request);
Console.WriteLine(response?.Data);