跳到主要内容

身份验证

每个 TRONAgg API 请求都必须在 X-API-Key 请求头中携带 API 密钥：

X-API-Key: ta_your_key_here

API 密钥与你的 TRONAgg 账户绑定。所有购买都从该密钥所属账户的余额中扣款。

创建 API 密钥​

  1. 登录 TRONAgg 工作台
  2. 在侧边栏点击 API 密钥
  3. 点击 新建密钥
  4. 输入一个便于识别的名称（例如 "Production Bot"、"Testing"）
  5. 可选：展开 仅允许指定 IP，填入将使用该密钥的公网 IP 地址或 CIDR 网段。留空则不限制 IP。
  6. 点击 创建密钥
  7. 立即复制密钥——它只显示一次
危险

完整的 API 密钥只在创建时显示。如果丢失，请撤销该密钥并重新创建一个。

数量限制​

  • 每个账户最多 5 个 API 密钥
  • 每个密钥都可以动用你账户的全部余额
  • 撤销其中一个密钥不影响其他密钥

密钥格式​

  • 前缀： ta_（一眼即可认出是 TRONAgg 的密钥）
  • 主体： 43 个 URL 安全的随机字符
  • 总长度： 46 个字符

示例：ta_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789-_abcde

我们的服务器只保存密钥的 SHA-256 哈希值。完整密钥只掌握在你自己手中。

密钥管理​

可选的 IP 白名单​

IP 限制默认关闭。已有的 API 密钥可以从任意 IP 使用，直到你为该密钥明确保存一个非空的白名单为止。

在 API 密钥 页面，点击密钥旁的 IP 访问权限 即可编辑它的白名单，无需更换密钥。最多可填写 50 个 IPv4 地址、IPv6 地址或 CIDR 网段：

203.0.113.7
2001:db8::1
198.51.100.0/24

每行填写一条，或用逗号、分号、空格分隔。重复的条目会被去除。CIDR 必须使用网络地址：应填写 198.51.100.0/24，而不是 198.51.100.7/24。不接受主机名和端口号。

添加我当前的 IP 会填入你浏览器使用的地址。你的服务器、机器人、VPN 或托管的 MCP 连接器可能使用不同的公网 IP；请放行实际发出 API 请求的那台系统的出口地址。

保存后，来自白名单之外的请求会收到 403 ip_not_allowed。你的工作台登录不受影响。要取消限制，请清空列表并点击 取消限制。API 密钥本身保持不变。

撤销密钥​

如果某个密钥已泄露或不再需要：

  1. 在工作台中打开 API 密钥
  2. 找到要撤销的密钥
  3. 点击 撤销 按钮
  4. 确认操作

被撤销的密钥立即失效。撤销操作无法撤回。

最佳实践​

  • 为密钥起描述性的名称——"Prod Trading Bot" 比 "Key 1" 更好
  • 为不同的应用或环境使用不同的密钥
  • 及时撤销不再使用的密钥
  • 定期轮换密钥，作为一项安全措施

安全地存储密钥​

切勿在源代码中硬编码 API 密钥。请改用环境变量：

export TRONAGG_API_KEY="ta_your_key_here"

或使用 .env 文件（需从 git 中排除）：

.env
TRONAGG_API_KEY=ta_your_key_here
app.py
from dotenv import load_dotenv
import os

load_dotenv()
API_KEY = os.environ["TRONAGG_API_KEY"]

错误响应​

状态码含义
401 UnauthorizedAPI 密钥缺失、无效或已撤销（detail 为纯字符串，例如 "Invalid API key"）
403 Forbidden账户已被封禁（detail 为纯字符串："Account is blocked"），或请求的来源 IP 不在该密钥的白名单内（detail.error: "ip_not_allowed"）
429 Too Many Requests你的账户每分钟请求超过 1,000 次（该账户的所有密钥与工作台会话合计）。请等待 Retry-After 响应头给出的秒数

完整说明：错误与约定。

如果密钥泄露​

  1. 立即在工作台中撤销该密钥
  2. 创建一个新密钥
  3. 在你的应用中换用新密钥
  4. 审查近期订单，排查是否存在未经授权的操作