iTick C++ SDK

C++ 语言版本的 iTick API SDK，提供基础、股票、指数、期货、基金、外汇、加密货币数据的 REST API 查询和 WebSocket 实时数据订阅功能。

功能特性

• 支持 REST API 查询基础、股票、指数、期货、基金、外汇、加密货币数据
• 支持 WebSocket 实时数据订阅
• 自动重连机制
• 心跳保持连接
• 回调式事件处理

系统要求

• C++17 或更高版本
• CMake 3.10 或更高版本
• libcurl 7.x 或更高版本

安装

从源码构建

cd cpp
mkdir build
cd build
cmake ..
make

集成到您的项目

使用 CMake

将 SDK 目录复制到您的项目中，并在您的 CMakeLists.txt 中添加：

add_subdirectory(path/to/github-sdk)
target_link_libraries(your_target PRIVATE github-sdk)
target_include_directories(your_target PRIVATE path/to/github-sdk/src)

手动集成

将 src/ 目录下的头文件和源文件添加到您的项目中，并链接 libcurl。

快速开始

初始化客户端

#include "client.h"

using namespace io::github::itick::sdk;

int main() {
    std::string token = "your_api_token";
    Client client(token);
    
    return 0;
}

REST API 使用

外汇数据查询

// 获取外汇实时成交
std::string tick = client.getForexTick("GB", "EURUSD");
std::cout << tick << std::endl;

// 获取外汇实时报价
std::string quote = client.getForexQuote("GB", "EURUSD");
std::cout << quote << std::endl;

// 获取外汇实时盘口
std::string depth = client.getForexDepth("GB", "EURUSD");
std::cout << depth << std::endl;

// 获取外汇历史K线
std::string kline = client.getForexKline("GB", "EURUSD", 2, 10);
std::cout << kline << std::endl;

股票数据查询

// 获取股票实时成交
std::string tick = client.getStockTick("US", "AAPL");
std::cout << tick << std::endl;

// 获取股票实时报价
std::string quote = client.getStockQuote("US", "AAPL");
std::cout << quote << std::endl;

// 获取股票实时盘口
std::string depth = client.getStockDepth("US", "AAPL");
std::cout << depth << std::endl;

// 获取股票历史K线
std::string kline = client.getStockKline("US", "AAPL", 2, 10);
std::cout << kline << std::endl;

加密货币数据查询

// 获取加密货币实时成交
std::string tick = client.getCryptoTick("BA", "BTCUSDT");
std::cout << tick << std::endl;

// 获取加密货币实时报价
std::string quote = client.getCryptoQuote("BA", "BTCUSDT");
std::cout << quote << std::endl;

// 获取加密货币实时盘口
std::string depth = client.getCryptoDepth("BA", "BTCUSDT");
std::cout << depth << std::endl;

// 获取加密货币历史K线
std::string kline = client.getCryptoKline("BA", "BTCUSDT", 2, 10);
std::cout << kline << std::endl;

WebSocket 使用

SDK 提供了增强的 WebSocket 功能，包括自动重连和心跳保持，用户无需手动管理连接状态。

设置回调函数

// 设置消息处理器
client.setMessageHandler([](const std::string& message) {
    std::cout << "Received WebSocket message: " << message << std::endl;
});

// 设置错误处理器
client.setErrorHandler([](const std::string& error) {
    std::cerr << "WebSocket error: " << error << std::endl;
});

// 设置打开处理器
client.setOpenHandler([]() {
    std::cout << "WebSocket connected" << std::endl;
});

// 设置关闭处理器
client.setCloseHandler([]() {
    std::cout << "WebSocket closed" << std::endl;
});

连接和订阅

// 连接外汇 WebSocket
client.connectForexWebSocket();

// 发送订阅消息
client.sendWebSocketMessage("{\"action\": \"subscribe\", \"codes\": [\"EURUSD\"]}");

// 等待一段时间
std::this_thread::sleep_for(std::chrono::seconds(5));

// 检查连接状态
std::cout << "WebSocket connected: " 
          << (client.isWebSocketConnected() ? "true" : "false") 
          << std::endl;

// 关闭 WebSocket
client.closeWebSocket();

其他 WebSocket 连接

// 连接股票 WebSocket
client.connectStockWebSocket();

// 连接加密货币 WebSocket
client.connectCryptoWebSocket();

API 接口列表

基础 (Basics)

方法	说明
getSymbolList	获取符号列表
getSymbolHolidays	获取节假日信息

股票 (Stock)

方法	说明
getStockInfo	获取股票信息
getStockIPO	获取股票IPO信息
getStockSplit	获取股票分拆信息
getStockTick	获取股票实时成交
getStockQuote	获取股票实时报价
getStockDepth	获取股票实时盘口
getStockKline	获取股票历史K线
getStockTicks	获取股票批量实时成交
getStockQuotes	获取股票批量实时报价
getStockDepths	获取股票批量实时盘口
getStockKlines	获取股票批量历史K线
connectStockWebSocket	连接股票 WebSocket

指数 (Indices)

方法	说明
getIndicesTick	获取指数实时成交
getIndicesQuote	获取指数实时报价
getIndicesDepth	获取指数实时盘口
getIndicesKline	获取指数历史K线
getIndicesTicks	获取指数批量实时成交
getIndicesQuotes	获取指数批量实时报价
getIndicesDepths	获取指数批量实时盘口
getIndicesKlines	获取指数批量历史K线
connectIndicesWebSocket	连接指数 WebSocket

期货 (Futures)

方法	说明
getFutureTick	获取期货实时成交
getFutureQuote	获取期货实时报价
getFutureDepth	获取期货实时盘口
getFutureKline	获取期货历史K线
getFutureTicks	获取期货批量实时成交
getFutureQuotes	获取期货批量实时报价
getFutureDepths	获取期货批量实时盘口
getFutureKlines	获取期货批量历史K线
connectFutureWebSocket	连接期货 WebSocket

基金 (Funds)

方法	说明
getFundTick	获取基金实时成交
getFundQuote	获取基金实时报价
getFundDepth	获取基金实时盘口
getFundKline	获取基金历史K线
getFundTicks	获取基金批量实时成交
getFundQuotes	获取基金批量实时报价
getFundDepths	获取基金批量实时盘口
getFundKlines	获取基金批量历史K线
connectFundWebSocket	连接基金 WebSocket

外汇 (Forex)

方法	说明
getForexTick	获取外汇实时成交
getForexQuote	获取外汇实时报价
getForexDepth	获取外汇实时盘口
getForexKline	获取外汇历史K线
getForexTicks	获取外汇批量实时成交
getForexQuotes	获取外汇批量实时报价
getForexDepths	获取外汇批量实时盘口
getForexKlines	获取外汇批量历史K线
connectForexWebSocket	连接外汇 WebSocket

加密货币 (Crypto)

方法	说明
getCryptoTick	获取加密货币实时成交
getCryptoQuote	获取加密货币实时报价
getCryptoDepth	获取加密货币实时盘口
getCryptoKline	获取加密货币历史K线
getCryptoTicks	获取加密货币批量实时成交
getCryptoQuotes	获取加密货币批量实时报价
getCryptoDepths	获取加密货币批量实时盘口
getCryptoKlines	获取加密货币批量历史K线
connectCryptoWebSocket	连接加密货币 WebSocket

WebSocket 功能说明

自动重连

SDK 内置自动重连机制，当网络异常或连接断开时，会自动尝试重新连接：

• 重连间隔：5 秒
• 最大重连次数：10 次
• 重连成功后自动恢复订阅

心跳保持

SDK 自动维护 WebSocket 连接的心跳：

• 心跳间隔：30 秒
• 自动发送 ping 消息保持连接活跃

连接状态检查

// 检查 WebSocket 是否连接
bool connected = client.isWebSocketConnected();

完整示例

#include <iostream>
#include "client.h"
#include <thread>
#include <chrono>

using namespace io::github::itick::sdk;

int main() {
    try {
        // 初始化客户端
        std::string token = "your_api_token";
        Client client(token);

        // 设置 WebSocket 消息处理器
        client.setMessageHandler([](const std::string& message) {
            std::cout << "Received WebSocket message: " << message << std::endl;
        });

        // 设置 WebSocket 错误处理器
        client.setErrorHandler([](const std::string& error) {
            std::cerr << "WebSocket error: " << error << std::endl;
        });

        // 设置 WebSocket 打开处理器
        client.setOpenHandler([]() {
            std::cout << "WebSocket connected" << std::endl;
        });

        // 设置 WebSocket 关闭处理器
        client.setCloseHandler([]() {
            std::cout << "WebSocket closed" << std::endl;
        });

        // 测试 REST API
        std::cout << "Testing forex tick..." << std::endl;
        std::string tick = client.getForexTick("GB", "EURUSD");
        std::cout << tick << std::endl;

        // 测试 WebSocket
        std::cout << "\nTesting WebSocket..." << std::endl;
        client.connectForexWebSocket();

        // 发送订阅消息
        client.sendWebSocketMessage("{\"action\": \"subscribe\", \"codes\": [\"EURUSD\"]}");

        // 等待一段时间
        std::cout << "Waiting for WebSocket messages..." << std::endl;
        std::this_thread::sleep_for(std::chrono::seconds(5));

        // 检查连接状态
        std::cout << "WebSocket connected: " 
                  << (client.isWebSocketConnected() ? "true" : "false") 
                  << std::endl;

        // 关闭 WebSocket
        client.closeWebSocket();

    } catch (const std::exception& e) {
        std::cerr << "Error: " << e.what() << std::endl;
    }

    return 0;
}

依赖项

• libcurl - HTTP 客户端库

文档

详细 API 文档请参考：https://docs.itick.org

许可证

MIT License