TRONQUIRY 提供 REST API 和 WebSocket 两种接入方式，帮助你以程序化的方式查询 Tron 链上的 TRC20 授权记录和 USDT 余额数据。

Base URL：

https://troncha.yytg.me/api/v1

所有 API 请求需要通过 API Key 认证。在 API Keys 页面 生成你的专属密钥，通过以下方式传入：

方式一：请求头（推荐）

X-API-Key: ts_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式二：POST Body 参数

api_key=ts_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式三：Query 参数

https://troncha.yytg.me/api/v1/query?api_key=ts_xxx...

{
  "success": false,
  "error":   "错误描述信息",
  "code":    "INVALID_ADDRESS"
}

通过 WebSocket 建立持久连接，实时接收订阅地址的 USDT 余额变动推送。后端每秒批量查询所有订阅地址，余额发生变动时立即推送通知。每个连接最多订阅 200 个地址。

复制// WebSocket 端点
wss://troncha.yytg.me/ws/balance

// 方式一：网页端已登录，连接后直接可用
// 方式二：API 接入，连接后发送认证消息
{
  "action":  "auth",
  "api_key": "ts_xxxxxxxxxxxxxxxx"
}

// 认证成功响应
{
  "type": "auth_ok",
  "user": "your_username"
}

复制// 订阅地址（最多200个）
{
  "action":    "subscribe",
  "addresses": ["TXxxx...", "TYxxx..."]
}

// 取消订阅
{
  "action":    "unsubscribe",
  "addresses": ["TXxxx..."]
}

// 查看当前订阅列表
{ "action": "list" }

复制// 余额变动推送（仅在余额变化时发送）
{
  "type":      "balance_change",
  "timestamp": 1720000000000,
  "changes": {
    "TXxxx...": {
      "old": 100.00,
      "new": 1234.56
    }
  }
}

// 订阅确认
{
  "type":      "subscribed",
  "addresses": ["TXxxx..."],
  "total":     1
}

// 错误消息
{
  "type":  "error",
  "error": "超出最大订阅数量 200"
}

复制import requests

API_KEY  = "ts_xxxxxxxxxxxxxxxx"
BASE_URL = "https://troncha.yytg.me/api/v1"
HEADERS  = {"X-API-Key": API_KEY}

# 查询授权记录
def query_approvals(address):
    resp = requests.post(
        f"{BASE_URL}/query_transactions",
        headers=HEADERS,
        data={"tronAddress": address}
    )
    return resp.json()

# 批量查询余额
def batch_balances(addresses):
    resp = requests.post(
        f"{BASE_URL}/balances/batch",
        headers={"X-API-Key": API_KEY, "Content-Type": "application/json"},
        json={"addresses": addresses}
    )
    return resp.json()

# WebSocket 余额监控
import websocket, json

def on_message(ws, message):
    data = json.loads(message)
    if data['type'] == 'balance_change':
        for addr, change in data['changes'].items():
            print(f"{addr}: {change['old']} → {change['new']} USDT")

def on_open(ws):
    ws.send(json.dumps({"action": "auth", "api_key": API_KEY}))
    ws.send(json.dumps({
        "action":    "subscribe",
        "addresses": ["TX...", "TY..."]
    }))

ws = websocket.WebSocketApp(
    "wss://troncha.yytg.me/ws/balance",
    on_open=on_open,
    on_message=on_message
)
ws.run_forever()

复制const API_KEY  = 'ts_xxxxxxxxxxxxxxxx';
const BASE_URL = 'https://troncha.yytg.me/api/v1';

// REST API
async function batchBalances(addresses) {
  const res = await fetch(`${BASE_URL}/balances/batch`, {
    method: 'POST',
    headers: { 'X-API-Key': API_KEY, 'Content-Type': 'application/json' },
    body: JSON.stringify({ addresses })
  });
  return res.json();
}

// WebSocket 余额监控
const ws = new WebSocket('wss://troncha.yytg.me/ws/balance');

ws.onopen = () => {
  ws.send(JSON.stringify({ action: 'auth', api_key: API_KEY }));
  ws.send(JSON.stringify({
    action: 'subscribe',
    addresses: ['TX...', 'TY...']
  }));
};

ws.onmessage = (e) => {
  const data = JSON.parse(e.data);
  if (data.type === 'balance_change') {
    Object.entries(data.changes).forEach(([addr, change]) => {
      console.log(`${addr}: ${change.old} → ${change.new} USDT`);
    });
  }
};