数字货币行情

数字货币 HTTP 行情支持实时行情、K 线和当日分时。请求代码使用 BTC.USD 等格式，并在请求模型中设置 SecType = SecType.CC。当前不支持数字货币历史分时。

获取数字货币实时行情

使用 TigerRequest<QuoteRealTimeQuoteResponse>、QuoteApiService.QUOTE_REAL_TIME 和 QuoteSymbolModel。设置 SecType = SecType.CC。

RealTimeQuoteItem.Amount 对应 JSON 字段 amount，表示成交额。

TigerRequest<QuoteRealTimeQuoteResponse> request = new()
{
    ApiMethodName = QuoteApiService.QUOTE_REAL_TIME,
    ModelValue = new QuoteSymbolModel
    {
        Symbols = new List<string> { "BTC.USD" },
        SecType = SecType.CC
    }
};
QuoteRealTimeQuoteResponse? response = await quoteClient.ExecuteAsync(request);
double amount = response?.Data is { Count: > 0 } data ? data[0].Amount : 0;

获取数字货币 K 线

使用 TigerRequest<QuoteKlineResponse>、QuoteApiService.KLINE 和 QuoteKlineModel。数字货币请求将 QuoteKlineModel.SecType 设为 SecType.CC。

分页时读取 KlineItem.NextPageToken，并在下一次请求中设置 QuoteKlineModel.PageToken；同时保留 SecType.CC。

KlinePoint.VolumeDecimal 是可空的 double?，对应 JSON 字段 volumeDecimal。设置 SecType.CC 的数字货币 K 线使用该字段保留小数成交量；任何响应都可能缺失或为 null，此时使用整数 KlinePoint.Volume。

响应数据结构：List<KlineItem>，每项的 Items 为 List<KlinePoint>。

KlineItem 字段

字段	C# 类型	说明
`Symbol`	`string`	数字货币代码
`Period`	`string`	K 线周期
`NextPageToken`	`string`	下一页标记
`Items`	`List<KlinePoint>`	K 线数据点列表

KlinePoint 字段

字段	C# 类型	说明
`Time`	`long`	K 线时间戳
`Open`	`double`	开盘价
`High`	`double`	最高价
`Low`	`double`	最低价
`Close`	`double`	收盘价
`Amount`	`double`	成交额
`Volume`	`long`	整数成交量
`VolumeDecimal`	`double?`	小数成交量

示例

TigerRequest<QuoteKlineResponse> request = new()
{
    ApiMethodName = QuoteApiService.KLINE,
    ModelValue = new QuoteKlineModel
    {
        Symbols = new List<string> { "BTC.USD" },
        Period = KLineType.day.Value,
        Limit = 300,
        SecType = SecType.CC
    }
};

QuoteKlineResponse? response = await quoteClient.ExecuteAsync(request);
double? volume = response?.Data?[0].Items?[0].VolumeDecimal;

获取数字货币当日分时

使用 TigerRequest<QuoteTimelineResponse>、QuoteApiService.TIMELINE 和 QuoteTimelineModel。数字货币请求将 QuoteTimelineModel.SecType 设为 SecType.CC。

TimelinePoint.VolumeDecimal 是可空的 double?，对应 JSON 字段 volumeDecimal。设置 SecType.CC 的数字货币当前分时使用该字段保留小数成交量；任何响应都可能缺失或为 null，此时使用整数 TimelinePoint.Volume。此支持仅适用于 timeline 当日分时请求，不适用于 history_timeline 历史分时请求。

响应数据结构：List<TimelineItem>，其中 Intraday、PreMarket 和 AfterHours 均为 TimelineRange，其 Items 为 List<TimelinePoint>。

TimelineItem 字段

字段	C# 类型	说明
`Symbol`	`string`	数字货币代码
`Period`	`string`	分时周期
`PreClose`	`double`	昨收价
`Intraday`	`TimelineRange`	盘中分时数据
`PreMarket`	`TimelineRange`	盘前分时数据
`AfterHours`	`TimelineRange`	盘后分时数据

TimelineRange 字段

字段	C# 类型	说明
`BeginTime`	`long`	时段开始时间戳
`EndTime`	`long`	时段结束时间戳
`Items`	`List<TimelinePoint>`	分时数据点列表

TimelinePoint 字段

字段	C# 类型	说明
`Time`	`long`	分时点时间戳
`Price`	`double`	最新价
`AvgPrice`	`double`	均价
`Volume`	`long`	整数成交量
`VolumeDecimal`	`double?`	小数成交量

示例

TigerRequest<QuoteTimelineResponse> request = new()
{
    ApiMethodName = QuoteApiService.TIMELINE,
    ModelValue = new QuoteTimelineModel
    {
        Symbols = new List<string> { "BTC.USD" },
        SecType = SecType.CC
    }
};

QuoteTimelineResponse? response = await quoteClient.ExecuteAsync(request);
double? volume = response?.Data?[0].Intraday?.Items?[0].VolumeDecimal;