> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 更新日志

> ChainStream API 和 SDK 的版本更新记录

## 2026

### 2026-02-04

<Note>
  **SDK v0.2.6 / v0.1.3** - 多语言 SDK 同步更新
</Note>

**SDK 更新**

* TypeScript SDK v0.2.6
  * WebSocket 连接稳定性优化
  * 修复订阅重连问题
* Python SDK v0.1.3
  * 异步客户端性能优化
  * 新增类型提示完善
* Go SDK v0.1.3
  * 错误处理改进
  * 内存使用优化
* Rust SDK v0.1.3
  * 首个稳定版本
  * 完整 API 覆盖

***

### 2026-02-03

<Note>
  **SDK v0.2.0** - 多语言 SDK 正式发布
</Note>

**重大更新**

* 🎉 Python SDK v0.1.0 正式发布
* 🎉 Go SDK v0.1.0 正式发布
* 🎉 Rust SDK v0.1.0 正式发布
* TypeScript SDK 升级至 v0.2.x 系列

**新功能**

* 统一的多语言 SDK 架构
* 完整的 OpenAPI 客户端支持
* WebSocket 实时数据订阅

**SDK 版本**

| 语言         | 版本     | 状态 |
| ---------- | ------ | -- |
| TypeScript | v0.2.4 | 稳定 |
| Python     | v0.1.1 | 稳定 |
| Go         | v0.1.1 | 稳定 |
| Rust       | v0.1.1 | 稳定 |

***

### 2026-01-29

**SDK 更新**

* TypeScript SDK v0.1.26
  * 新增 KYT API 完整支持
  * Webhook 端点管理 API

**改进**

* KYT 交易风险评估响应速度提升
* Webhook 签名验证文档更新

***

### 2026-01-20

**新功能**

* 新增代币流动性快照 API (`/v1/token/{chain}/{address}/liquiditysnapshots`)
* 新增代币交易者标签 API (`/v1/token/{chain}/{address}/traders/tag`)

**SDK 更新**

* TypeScript SDK v0.1.22
  * 新增流动性快照方法
  * 类型定义优化

***

### 2026-01-15

**新功能**

* Webhook 系统正式发布
  * 支持代币创建通知 (`sol.token.created`)
  * 支持代币毕业通知 (`sol.token.migrated`)
* 新增 Webhook 密钥轮换 API

**SDK 更新**

* TypeScript SDK v0.1.20
  * 新增 Webhook 端点管理
  * 新增密钥轮换方法

***

### 2026-01-04

<Note>
  **API v1.4.0** - 新年更新
</Note>

**新功能**

* 新增 KYA (Know Your Address) API
* 新增地址风险评估端点
* 支持批量地址查询

**SDK 更新**

* TypeScript SDK v0.1.19
  * 完整 KYA API 支持
  * 批量查询优化

**改进**

* API 响应时间平均降低 30%
* 错误信息更加详细

***

## 2025

### 2025-12-23

**改进**

* 优化 Solana 数据覆盖范围
* WebSocket 心跳机制优化
* 代币元数据缓存策略改进

**SDK 更新**

* TypeScript SDK v0.1.15
  * WebSocket 重连逻辑优化
  * 新增心跳超时配置

***

### 2025-12-01

<Note>
  **API v1.3.0** - KYT 正式发布
</Note>

**新功能**

* 🎉 KYT (Know Your Transaction) API 正式发布
  * 交易风险评估
  * 资金来源追溯
  * 风险告警生成
* 新增代币开发者信息 API (`/v1/token/{chain}/dev/{devAddress}/tokens`)

**SDK 更新**

* TypeScript SDK v0.1.14
  * 完整 KYT API 支持
  * 新增风险评估方法

**改进**

* DEX 报价聚合支持更多协议
* 优化大额交易的路由算法

***

### 2025-10-15

**新功能**

* 新增代币安全检查 API (`/v1/token/{chain}/{address}/security`)
* 新增代币 mint/burn 历史 API (`/v1/token/{chain}/{address}/mintandburn`)
* 支持代币创建信息查询 (`/v1/token/{chain}/{address}/creation`)

**SDK 更新**

* TypeScript SDK v0.1.11
  * 新增安全检查方法
  * 新增代币历史查询

**改进**

* 价格数据延迟降低至 50ms 以内
* K 线数据增加更多时间周期支持

***

### 2025-09-27

<Note>
  **SDK v0.1.0** - TypeScript SDK 正式发布
</Note>

**重大更新**

* 🎉 TypeScript SDK v0.1.0 正式发布
* 完整的 REST API 客户端
* WebSocket 实时数据订阅支持

**功能特性**

* Token API 完整支持
* Wallet API 完整支持
* DEX API 完整支持
* Ranking API 完整支持
* WebSocket 订阅方法

***

### 2025-09-18

**新功能**

* 新增钱包余额更新历史 API
* 新增钱包 PnL 计算 API
* 支持批量代币查询

**SDK 更新**

* TypeScript SDK v0.0.12
  * 新增钱包相关方法
  * 批量查询支持

***

### 2025-09-08

**新功能**

* WebSocket 实时数据推送正式发布
* 支持以下订阅类型：
  * 代币 K 线 (`dex-token-candles`)
  * 代币统计 (`dex-token-stats`)
  * 代币持有者 (`token-holders`)
  * 新代币 (`dex-new-token`)
  * 钱包余额 (`wallet-balance`)
  * 钱包交易 (`wallet-trade`)

**SDK 更新**

* TypeScript SDK v0.0.7
  * 新增 WebSocket 客户端
  * 支持自动重连

***

### 2025-09-03

**新功能**

* DEX 报价和路由 API
* 代币 K 线数据 API
* 代币市场数据 API

**SDK 更新**

* TypeScript SDK v0.0.4
  * 新增 DEX 交易方法
  * 新增 K 线查询

***

### 2025-09-01

<Note>
  **API v1.0.0** - ChainStream API 正式发布
</Note>

**初始功能**

* 🎉 ChainStream API 正式发布
* Solana 链完整支持
* 核心功能：
  * 代币信息和价格查询
  * 代币持有者分析
  * DEX 交易数据
  * 钱包余额和统计
  * 排行榜 API

**SDK 更新**

* TypeScript SDK v0.0.2
  * 首个可用版本
  * 基础 API 支持

***

### 2025-08-31

<Note>
  **TypeScript SDK v0.0.1** - 首次发布
</Note>

* TypeScript SDK 首次发布到 npm
* 包名：`@chainstream-io/sdk`

***

## SDK 版本概览

### 当前最新版本

| SDK        | 版本     | 发布日期       | 包管理器                                                                          |
| ---------- | ------ | ---------- | ----------------------------------------------------------------------------- |
| TypeScript | v0.2.6 | 2026-02-04 | [npm](https://www.npmjs.com/package/@chainstream-io/sdk)                      |
| Python     | v0.1.3 | 2026-02-04 | [PyPI](https://pypi.org/project/chainstream/)                                 |
| Go         | v0.1.3 | 2026-02-04 | [pkg.go.dev](https://pkg.go.dev/github.com/chainstream-io/chainstream-sdk/go) |
| Rust       | v0.1.3 | 2026-02-04 | [crates.io](https://crates.io/crates/chainstream)                             |

### TypeScript SDK 版本历史

| 版本系列   | 版本范围           | 发布时间               | 说明           |
| ------ | -------------- | ------------------ | ------------ |
| v0.2.x | 0.2.1 - 0.2.6  | 2026-02            | 多语言 SDK 统一架构 |
| v0.1.x | 0.1.4 - 0.1.26 | 2025-09 \~ 2026-01 | 功能稳定版本       |
| v0.0.x | 0.0.1 - 0.0.12 | 2025-08 \~ 2025-09 | 早期测试版本       |

***

## 版本策略

### API 版本

* **主版本** (v1, v2)：包含破坏性变更
* **次版本** (v1.1, v1.2)：新功能，向后兼容
* **补丁** (v1.1.1)：Bug 修复

### SDK 版本

SDK 遵循语义化版本 (SemVer)：

* **Major**：破坏性变更
* **Minor**：新功能
* **Patch**：Bug 修复

### 废弃策略

* 废弃的端点至少保留 6 个月
* 废弃前会在响应头中添加警告
* 重大变更会提前 30 天通知

***

## 订阅更新

<CardGroup cols={2}>
  <Card title="邮件订阅" icon="envelope" href="mailto:support@chainstream.io?subject=Subscribe Updates">
    订阅版本更新通知
  </Card>

  <Card title="Discord" icon="discord" href="https://discord.gg/quhPXEkJ">
    加入社区获取最新动态
  </Card>
</CardGroup>