数字货币
get_symbols 获取所有代码列表
value QuoteClient::get_symbols(utility::string_t sec_type)
说明
获取所有数字货币的代码列表。
请求频率
频率限制请参考：接口请求限制
参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| sec_type | utility::string_t | Yes | 固定为 U("CC") |
返回
web::json::value JSON 对象
示例
#include "tigerapi/quote_client.h"
#include "tigerapi/client_config.h"
using namespace TIGER_API;
ClientConfig config(false, U("/path/to/your/properties/"));
QuoteClient quote_client(config);
value result = quote_client.get_symbols(U("CC"));
ucout << result.serialize() << std::endl;返回示例
['APT.USD', 'IOTX.USD', 'USDT.USD', 'DYDX.USD', 'DOGE.USD', 'KAIA.USD', 'ATOM.USD', 'COMP.USD', 'UNI.USD', 'AAVE.USD', 'LDO.USD', 'LINK.USD', 'SNX.USD', 'OP.USD', 'DOT.USD', 'POL.USD', 'BTC.USD', 'SOL.USD', 'ARB.USD', 'TON.USD', 'AVAX.USD', 'MKR.USD', 'IMX.USD', 'ETH.USD', 'LTC.USD']
get_cc_briefs 获取实时行情
value QuoteClient::get_cc_briefs(const value &symbols, utility::string_t sec_type, utility::string_t lang)
说明
获取数字货币实时行情。
请求频率
频率限制请参考：接口请求限制
参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbols | value | Yes | 代码数组，最多50只，如 value::array({value::string(U("BTC")), value::string(U("ETH"))}) |
| sec_type | utility::string_t | Yes | 固定为 U("CC") |
| lang | utility::string_t | No | 支持的语言，如 U("zh_CN")，默认英文 |
返回
web::json::value JSON 对象
结构如下：
| COLUMN | 类型 | 描述 |
|---|---|---|
| symbol | str | 证券代码 |
| pre_close | float | 前收价 |
| latest_price | float | 最新价 |
| latest_time | int | 最新成交时间，毫秒单位数字时间戳 |
| volume_decimal | float | 成交量 |
| open | float | 开盘价 |
| high | float | 最高价 |
| low | float | 最低价 |
| change | double | 涨跌额 |
| changeRate | double | 涨跌幅 |
示例
#include "tigerapi/quote_client.h"
#include "tigerapi/client_config.h"
using namespace TIGER_API;
ClientConfig config(false, U("/path/to/your/properties/"));
QuoteClient quote_client(config);
value symbols = value::array();
symbols[0] = value::string(U("BTC"));
symbols[1] = value::string(U("ETH"));
value result = quote_client.get_cc_briefs(symbols, U("CC"));
ucout << result.serialize() << std::endl;返回示例
symbol open high low close pre_close latest_price latest_time \
0 BTC 71127.62 72200.0 69955.91 70932.55 71061.02 70932.55 1770608250067 \
1 ETH 2107.21 2148.9 2054.05 2089.56 2106.26 2089.56 1770608250068 \
change change_rate volume_decimal
-128.47 -0.001808 135.82381
-16.70 -0.007929 2815.58590get_bars 获取K线数据
value QuoteClient::get_kline(const value &symbols, BarPeriod period, time_t begin_time, time_t end_time, QuoteRight right, int limit, utility::string_t page_token)
说明
获取数字货币K线数据，包括：1分、60分、天、周、月级别。每次请求最多返回 1200 条记录，建议通过循环调用实现更长时间范围的历史数据获取，以保障接口性能和稳定性。接口支持按照日期区间或指定日期查询。
分钟级别K：BTC 支持最早2024年3月27日开始的数据 日K及以上（日/周/月/年）：BTC 支持最早2010年7月13日开始的数据
请求频率
频率限制请参考：接口请求限制
参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbols | value | Yes | 证券代码数组，单次上限：50，如 value::array({value::string(U("ETH"))}) |
| period | BarPeriod 或 utility::string_t | No | 获取的K线周期。默认 BarPeriod::DAY，可选值：day/week/month/year/1min/3min/5min/10min/15min/30min/60min |
| begin_time | time_t | No | 区间查询的开始时间，建议使用时间戳，避免不同市场的时区问题，默认 -1 |
| end_time | time_t | No | 区间查询的截止时间，默认 -1 |
| right | QuoteRight 或 utility::string_t | No | 复权类型，默认 QuoteRight::br 或 U("br") |
| limit | int | No | 限制数据的条数。默认 251，最大1200 |
| page_token | utility::string_t | No | 翻页标记，默认空 |
返回
web::json::value JSON 对象
结构如下：
| 参数名 | 类型 | 描述 |
|---|---|---|
| time | int | 毫秒时间戳，如 1639371600000 |
| open | float | Bar 的开盘价 |
| close | float | Bar 的收盘价 |
| high | float | Bar 的最高价 |
| low | float | Bar 的最低价 |
| volume_decimal | float | Bar 的成交量 |
示例
#include "tigerapi/quote_client.h"
#include "tigerapi/client_config.h"
using namespace TIGER_API;
ClientConfig config(false, U("/path/to/your/properties/"));
QuoteClient quote_client(config);
value symbols = value::array();
symbols[0] = value::string(U("ETH"));
value result = quote_client.get_kline(symbols, BarPeriod::DAY);
ucout << result.serialize() << std::endl;返回示例
symbol open close high low volume_decimal time
0 ETH 2107.21 2082.07 2148.90 2054.05 4408.5683 1770566400000
1 ETH 2052.48 2106.26 2143.31 2007.04 11426.7385 1770480000000
2 ETH 1980.74 2049.89 2118.52 1971.49 17089.0071 1770393600000
3 ETH 1957.51 1980.75 2014.57 1747.67 26795.9965 1770307200000
4 ETH 2148.31 1957.20 2189.48 1922.60 31535.3994 1770220800000
get_timeline 获取最近一个交易日的分时数据
value QuoteClient::get_timeline(const value &symbols, bool include_hour_trading, time_t begin_time)
说明
获取最近一个交易日的分时数据。分时数据类似于分钟 K 线，每分钟生成一条记录。仅支持查询最新交易日的数据。
请求频率
频率限制请参考：接口请求限制
参数
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| symbols | value | Yes | 代码数组，单次上限10只 |
| include_hour_trading | bool | No | 是否包含盘前盘后数据，默认 false |
| begin_time | time_t | No | 获取分时数据的起始时间，支持毫秒级别的时间戳，如 1639386000000，默认返回当天数据，默认 -1 |
返回
web::json::value JSON 对象
结构如下：
| COLUMN | 类型 | 描述 |
|---|---|---|
| symbol | str | 证券代码，如 AAPL |
| time | int | 精确到毫秒的时间戳，如 1639386000000 |
| price | float | 当前分钟的收盘价 |
| avg_price | float | 截至到当前时间的成交量加权均价 |
| volume_decimal | int | 这一分钟的成交量 |
示例
#include "tigerapi/quote_client.h"
#include "tigerapi/client_config.h"
using namespace TIGER_API;
ClientConfig config(false, U("/path/to/your/properties/"));
QuoteClient quote_client(config);
value symbols = value::array();
symbols[0] = value::string(U("ETH"));
value result = quote_client.get_timeline(symbols);
ucout << result.serialize() << std::endl;返回示例
symbol pre_close trade_session time price volume_decimal
0 ETH 2106.26 Regular 1770566400000 2106.19 0.1676
1 ETH 2106.26 Regular 1770566460000 2104.82 55.0534
2 ETH 2106.26 Regular 1770566520000 2110.71 1.7288
3 ETH 2106.26 Regular 1770566580000 2111.03 0.9551
4 ETH 2106.26 Regular 1770566640000 2112.00 1.1343
5Updated 14 days ago