获取合约详细信息
1. 概述与典型用途
根据合约地址查询合约的完整详细信息，包含验证状态、创建者、方法签名映射、标签信息、代币信息等。
- 典型用途：合约详情页展示、合约安全审计信息查询、方法签名反查。
- 何时不要用：批量查询合约列表用「获取合约列表」；查询合约调用统计用「获取合约调用统计数据」。
2. 接口与鉴权
GET /api/contract
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract | string | 是 | — | 合约地址（Base58，T 开头） |
source | string | 否 | — | 数据来源标识 |
session-id | string | 否 | — | 会话 ID |
word | string | 否 | — | 关键词搜索 |
type | string | 否 | — | 合约类型过滤 |
address | string | 否 | — | 按发行方地址过滤 |
direction | string | 否 | — | 过滤方向 |
issueName | string | 否 | — | TRC10 发行方地址或名称 |
order | integer | 否 | -1 | 排序方向：1 升序 / -1 降序 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
type | string | 必返 | 响应类型 | — |
count | integer | 必返 | 返回的数据条数；此字段在 detail 接口固定返回 0，实际条数以 data[] 长度为准 | — |
status | object | 必返 | 状态码与消息 | — |
data | array | 必返 | 合约数据数组 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 合约地址 | — |
balance | integer | 必返 | TRX 余额 | sun（1 TRX = 10^6 sun） |
balanceInUsd | number | 必返 | TRX 余额折合 USD | — |
verify_status | integer | 必返 | 验证状态：0 未验证、1 部分验证、2 完全验证 | — |
is_proxy | boolean | 必返 | 是否为代理合约 | — |
proxy_implementation | string | 必返 | 代理合约的实现地址（非代理时为空字符串） | — |
old_proxy_implementation | string | 必返 | 旧代理实现地址（非代理时为空字符串） | — |
trxCount | integer | 必返 | 累计交易数 | — |
date_created | integer | 必返 | 创建时间 | 毫秒时间戳 |
call_value | integer | 必返 | 合约创建时附带的 TRX 值 | sun |
call_token_value | integer | 必返 | 合约创建时附带的 TRC10 代币值 | — |
call_token_id | integer | 必返 | 合约创建时附带的 TRC10 代币 ID | — |
call_token_info | object | 必返 | 合约创建时附带代币的详细信息；对象包含单一 tokenInfo 键，子字段 schema 见下 | — |
name | string | 必返 | 合约名称 | — |
description | string | 必返 | 合约描述（可为空字符串） | — |
tag1 | string | 可选 | 合约主标签 | — |
tag1Url | string | 可选 | 主标签链接 | — |
vip | boolean | 必返 | 是否为 VIP 合约 | — |
feedbackRisk | boolean | 必返 | 是否有风险反馈 | — |
announcement | string | 必返 | 公告内容（可为空字符串） | — |
license | string | 必返 | 开源许可证标识（如 "0" 表示无） | — |
blueTag | string | 可选 | 蓝色标签（官方认证标识） | — |
blueTagUrl | string | 可选 | 蓝色标签链接 | — |
greyTag | string | 必返 | 灰色标签（可为空字符串） | — |
redTag | string | 必返 | 红色标签（风险标记，可为空字符串） | — |
publicTag | string | 可选 | 公开标签 | — |
publicTagDesc | string | 必返 | 公开标签描述（可为空字符串） | — |
activeDay | integer | 必返 | 活跃天数 | 天 |
creator | object | 必返 | 创建者信息（见下表） | — |
auditReportUrl | string | 必返 | 审计报告 URL（可为空字符串） | — |
auditDep | string | 必返 | 审计机构（可为空字符串） | — |
auditDate | string | 必返 | 审计日期（可为空字符串） | — |
destroyed | integer | 可选 | 仅在已销毁合约上返回；值固定为 1（销毁标记，注意类型为 integer 不是 boolean——严格类型环境下 1 === true 不成立）；活跃合约不返回此字段。实测样本：TCySpKjSp8SGW7g6eVnzVYtbY2WeC5MBZF 返回 destroyed: 1 | — |
destroyed_hash | string | 可选 | 销毁交易哈希；与 destroyed 成对出现，仅销毁合约返回；活跃合约不返回 | — |
methodMap | object | 必返 | 方法选择器 → 方法签名映射 | — |
energy_factor | number | 必返 | 能量因子 | — |
tokenInfo | object | 必返 | 代币元信息（通用 9 字段 + issuerAddr）；非代币合约也返回该对象，内容反映合约所属代币（如 TRX 占位）；子字段 schema 见下 | — |
balanceWithTokens | number | 必返 | 含代币资产的总余额 | TRX |
balanceWithTokensInUsd | number | 必返 | 含代币资产的总余额折合 USD | USD |
call_token_info.tokenInfo 対象 schema（通用 9 字段）：
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址（Base58）；TRX 占位符为 _ | — |
tokenAbbr | string | 必返 | 代币缩写（如 USDT / TRX） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 精度位数（amount 字段换算所需） | — |
tokenCanShow | integer | 必返 | 是否可展示（1 是 / 0 否） | — |
tokenType | string | 必返 | 代币类型（trc10 / trc20 / trc721 / trc1155） | — |
tokenLogo | string | 必返 | 代币 logo URL | — |
tokenLevel | string | 必返 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
tokenInfo 对象 schema（通用 9 字段 + 本接口扩展字段）：
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币合约地址（Base58）；TRX 占位符为 _ | — |
tokenAbbr | string | 必返 | 代币缩写（如 USDT / TRX） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenDecimal | integer | 必返 | 精度位数（amount 字段换算所需） | — |
tokenCanShow | integer | 必返 | 是否可展示（1 是 / 0 否） | — |
tokenType | string | 必返 | 代币类型（trc10 / trc20 / trc721 / trc1155） | — |
tokenLogo | string | 必返 | 代币 logo URL | — |
tokenLevel | string | 必返 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
issuerAddr | string | 可选 | 发行方地址（TRC20 代币有） | — |
creator 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | 创建者地址 | — |
address_is_contract | boolean | 必返 | 创建者是否为合约 | — |
txHash | string | 必返 | 创建交易哈希 | — |
token_balance | integer | 必返 | 创建者代币余额 | — |
consume_user_resource_percent | integer | 必返 | 用户资源消耗比例 | % |
energy_remaining | integer | 必返 | 剩余能量 | — |
energy_limit | integer | 必返 | 能量上限 | — |
energy_ratio | number | 必返 | 能量比例 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 合约地址不存在：返回
200+data: []，count: 0，不会报 4xx。 - 空结果 ≠ 错误：地址无效或合约不存在时返回空数组，属于正常响应。
最后更新于: