iTick API SDK for PHP

安装

使用 Composer 安装：

composer require itick/sdk

使用示例

<?php

require_once 'vendor/autoload.php';

use io\github\itick\sdk\Client;

// 初始化客户端
$client = new Client('YOUR_API_KEY');

// 示例：获取股票信息
try {
    $stockInfo = $client->getStockInfo('us', 'AAPL');
    print_r($stockInfo);
} catch (Exception $e) {
    echo 'Error: ' . $e->getMessage();
}

// 示例：获取股票K线数据
try {
    $kline = $client->getStockKline('us', 'AAPL', '1d', 30);
    print_r($kline);
} catch (Exception $e) {
    echo 'Error: ' . $e->getMessage();
}

// 示例：WebSocket连接（模拟）
$client->setOpenHandler(function() {
    echo 'WebSocket connected\n';
});

$client->setMessageHandler(function($message) {
    echo 'Received message: ' . $message . '\n';
});

$client->setErrorHandler(function($error) {
    echo 'Error: ' . $error . '\n';
});

$client->setCloseHandler(function() {
    echo 'WebSocket closed\n';
});

// 连接股票WebSocket
$client->connectStockWebSocket();

// 发送消息
$client->sendWebSocketMessage('test message');

// 关闭连接
$client->closeWebSocket();

API 方法

基础模块

• getSymbolList() - 获取符号列表
• getSymbolHolidays() - 获取节假日信息

股票模块

• getStockInfo($region, $code) - 获取股票信息
• getStockIPO($region, $code) - 获取股票IPO信息
• getStockSplit($region, $code) - 获取股票分拆信息
• getStockTick($region, $code) - 获取股票tick数据
• getStockQuote($region, $code) - 获取股票报价
• getStockDepth($region, $code) - 获取股票深度
• getStockKline($region, $code, $period, $limit, $end = null) - 获取股票K线
• getStockTicks($region, $codes) - 批量获取股票tick数据
• getStockQuotes($region, $codes) - 批量获取股票报价
• getStockDepths($region, $codes) - 批量获取股票深度
• getStockKlines($region, $codes, $period, $limit, $end = null) - 批量获取股票K线
• connectStockWebSocket() - 连接股票WebSocket

指数模块

• getIndicesTick($region, $code) - 获取指数tick数据
• getIndicesQuote($region, $code) - 获取指数报价
• getIndicesDepth($region, $code) - 获取指数深度
• getIndicesKline($region, $code, $period, $limit, $end = null) - 获取指数K线
• getIndicesTicks($region, $codes) - 批量获取指数tick数据
• getIndicesQuotes($region, $codes) - 批量获取指数报价
• getIndicesDepths($region, $codes) - 批量获取指数深度
• getIndicesKlines($region, $codes, $period, $limit, $end = null) - 批量获取指数K线
• connectIndicesWebSocket() - 连接指数WebSocket

期货模块

• getFutureTick($region, $code) - 获取期货tick数据
• getFutureQuote($region, $code) - 获取期货报价
• getFutureDepth($region, $code) - 获取期货深度
• getFutureKline($region, $code, $period, $limit, $end = null) - 获取期货K线
• getFutureTicks($region, $codes) - 批量获取期货tick数据
• getFutureQuotes($region, $codes) - 批量获取期货报价
• getFutureDepths($region, $codes) - 批量获取期货深度
• getFutureKlines($region, $codes, $period, $limit, $end = null) - 批量获取期货K线
• connectFutureWebSocket() - 连接期货WebSocket

基金模块

• getFundTick($region, $code) - 获取基金tick数据
• getFundQuote($region, $code) - 获取基金报价
• getFundDepth($region, $code) - 获取基金深度
• getFundKline($region, $code, $period, $limit, $end = null) - 获取基金K线
• getFundTicks($region, $codes) - 批量获取基金tick数据
• getFundQuotes($region, $codes) - 批量获取基金报价
• getFundDepths($region, $codes) - 批量获取基金深度
• getFundKlines($region, $codes, $period, $limit, $end = null) - 批量获取基金K线
• connectFundWebSocket() - 连接基金WebSocket

外汇模块

• getForexTick($region, $code) - 获取外汇tick数据
• getForexQuote($region, $code) - 获取外汇报价
• getForexDepth($region, $code) - 获取外汇深度
• getForexKline($region, $code, $period, $limit, $end = null) - 获取外汇K线
• getForexTicks($region, $codes) - 批量获取外汇tick数据
• getForexQuotes($region, $codes) - 批量获取外汇报价
• getForexDepths($region, $codes) - 批量获取外汇深度
• getForexKlines($region, $codes, $period, $limit, $end = null) - 批量获取外汇K线
• connectForexWebSocket() - 连接外汇WebSocket

加密货币模块

• getCryptoTick($region, $code) - 获取加密货币tick数据
• getCryptoQuote($region, $code) - 获取加密货币报价
• getCryptoDepth($region, $code) - 获取加密货币深度
• getCryptoKline($region, $code, $period, $limit, $end = null) - 获取加密货币K线
• getCryptoTicks($region, $codes) - 批量获取加密货币tick数据
• getCryptoQuotes($region, $codes) - 批量获取加密货币报价
• getCryptoDepths($region, $codes) - 批量获取加密货币深度
• getCryptoKlines($region, $codes, $period, $limit, $end = null) - 批量获取加密货币K线
• connectCryptoWebSocket() - 连接加密货币WebSocket

注意事项

• PHP SDK中的WebSocket功能是模拟实现，因为PHP没有内置的WebSocket客户端。在实际生产环境中，建议使用Swoole等扩展来实现真正的WebSocket客户端。
• 所有API方法都可能抛出异常，请确保在使用时进行适当的错误处理。