tgtc-sdk (Python)

TGTC 数据 API 的 Python 客户端。一行代码接入 BSC 代币数据：基本行情、持仓结构、安全审计、持有人、社交信息、聪明钱动向。

计费透明：每次调用都会返回剩余次数与本次扣次明细，余额一眼可见。

安装

pip install tgtc-sdk

需要先创建 API Key（TGTC Bot 个人中心 → 我的 API）。

快速开始

from tgtc import TGTC

client = TGTC(api_key="你的 API Key")

# 代币聚合查询（默认返回完整产品类别）
res = client.token("0x...合约地址")

print(res.symbol)          # 代币符号
print(res.price)           # 当前价格
print(res.remaining)       # 剩余调用次数
print(res.used)            # 本次扣次

按类别/字段查询

# 只要行情 + 安全审计，扣次更少
res = client.token(ca, categories=["basic", "security"])

# 精确字段裁剪（与 categories 二选一）
res = client.token(ca, fields=["symbol", "price", "honeypot", "buy_tax"])

可选类别：basic（基本行情）/ structure（持仓结构）/ holders（持有人）/ security（安全审计）/ social（社交信息）/ traders（聪明钱动向）。

计费明细

错误处理

from tgtc import TGTCError, TGTCQuotaError, TGTCAuthError

try:
    res = client.token(ca)
except TGTCAuthError:
    print("API Key 无效")
except TGTCQuotaError:
    print("调用次数不足，请充值")
except TGTCError as e:
    print("请求失败：", e)

路线图

• token：代币聚合查询
• token/trending + token/hot：榜单
• twitter：推特检测/舆情
• track：交易流
• market：信号流
• wallet：钱包分析
• translate：翻译

文档

完整接口文档见 TGTC API Docs。