通过交易哈希获取交易详情
1. 概述与典型用途
根据交易哈希查询单笔交易的完整信息，包含合约数据、资源消耗、SR 确认列表等。
- 典型用途：交易详情页展示、交易状态追踪、资源消耗分析。
- 何时不要用：批量查询交易用「获取交易列表」；查转账记录用相应的转账列表接口。
2. 接口与鉴权
GET /api/transaction-info
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
hash | string | 是 | — | 交易哈希 |
source | string | 否 | — | 数据来源，传值后会在 Redis 中记录该哈希的查询次数 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
block | integer | 必返 | 区块高度 | — |
hash | string | 必返 | 交易哈希 | — |
timestamp | integer | 必返 | 区块时间 | 毫秒时间戳 ms |
ownerAddress | string | 必返 | 发起方地址（Base58，T 开头） | — |
toAddress | string | 必返 | 接收方地址 | — |
contractType | integer | 必返 | 合约类型编号 | — |
contract_type | string | 必返 | 合约类型描述（如 trc20） | — |
confirmed | boolean | 必返 | 是否已确认 | — |
revert | boolean | 必返 | 是否已回退 | — |
confirmations | integer | 必返 | 已确认区块数 | — |
contractRet | string | 必返 | 合约执行结果（如 SUCCESS） | — |
contractData | object | 必返 | 合约调用数据，子字段见下方 contractData 对象表 | — |
cost | object | 必返 | 资源消耗详情，见下 | — |
data | string | 必返 | 原始交易数据（非合约调用时为空字符串） | — |
riskTransaction | boolean | 必返 | 风险交易标记 | — |
noteLevel | integer | 必返 | 风险级别标注 | — |
info | object | 必返 | 附加信息（通常为空对象） | — |
contract_map | object | 必返 | 地址 → 是否为合约的映射（注意：键名为 contract_map，非 contractMap） | — |
normalAddressInfo | object | 必返 | 地址 → 风险信息 | — |
addressTag | object | 必返 | 地址标签映射（可为空对象） | — |
hashTag | array | 必返 | 交易哈希标签列表（可为空数组） | — |
signature_addresses | array | 必返 | 签名地址列表（可为空数组） | — |
trigger_info | object | 可选 | 合约调用方法与入参（仅智能合约调用时出现），子字段见下方 trigger_info 对象表 | — |
trc20TransferInfo | array | 可选 | TRC20 转账信息列表（仅含 TRC20 转账时出现），元素 schema 见下方 trc20TransferInfo[] 元素表 | — |
transfersAllList | array | 可选 | 所有代币转账的统一列表（含 TRC20/TRC10 等），元素 schema 同 trc20TransferInfo[] | — |
tokenTransferInfo | object | 可选 | 主要代币转账信息（单笔转账时出现），schema 同 trc20TransferInfo[] 元素 | — |
internal_transactions | object | 必返 | 内部交易；无内部调用时为空对象 {}，有时为含内部交易数据的对象 | — |
event_count | integer | 可选 | 事件数量（智能合约调用时出现） | — |
triggerContractType | integer | 可选 | 触发合约子类型编号 | — |
project | string | 可选 | 关联项目名称（合约属于已知项目时出现） | — |
srConfirmList | array | 可选 | SR 确认列表，元素 schema 见下方 srConfirmList[] 元素表 | — |
contractInfo | object | 可选 | 合约地址 → 标签信息映射；value schema 见下 | — |
toAddressTag | string | 可选 | 接收方地址标签 | — |
cheat_status | integer | 可选 | 欺诈状态标记（实测值 0） | — |
fee_limit | integer | 可选 | 手续费上限（智能合约调用时出现） | sun |
revertReason | string | 可选 | 合约回退原因（仅 contractRet == "REVERT" 时出现） | — |
trc20ApprovalInfo | array | 可选 | TRC20 授权信息列表（仅授权类事件时出现） | — |
contractInfo[<addr>] 对象 schema（8 字段）：
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
tag1 | string | 必返 | 主标签（项目名 / 合约名 / 交易所名） |
tag1Url | string | 必返 | 主标签链接 URL（可为空字符串） |
name | string | 必返 | 合约 / 项目正式名称 |
isToken | boolean | 必返 | 是否代币合约（true / false） |
vip | boolean | 必返 | 是否 VIP 实体（true / false） |
risk | boolean | string | 必返 | 风险标签；多数 endpoint 返回 boolean，部分返回字符串风险类型（blacklist / fraud 等） |
publicTagDesc | string | 必返 | 公开标签描述；多数账户为空字符串 |
publicTag | string | 可选 | 公开标签（如 "USDT Token" / "Binance"）；仅知名实体或部分接口返回 |
cost 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
fee | integer | 必返 | 总手续费 | sun |
net_fee | integer | 必返 | 带宽手续费 | sun |
net_usage | integer | 必返 | 带宽消耗 | bytes |
energy_fee | integer | 必返 | 能量手续费 | sun |
energy_usage | integer | 必返 | 调用者能量消耗 | — |
energy_usage_total | integer | 必返 | 总能量消耗 | — |
origin_energy_usage | integer | 必返 | 合约拥有者能量消耗 | — |
energy_penalty_total | integer | 必返 | 能量惩罚总量 | — |
net_fee_cost | integer | 必返 | 带宽单价（sun/byte） | sun/byte |
energy_fee_cost | integer | 必返 | 能量单价（sun/能量） | sun/能量 |
date_created | integer | 必返 | 交易创建时间 | 秒时间戳 s |
multi_sign_fee | integer | 必返 | 多签手续费 | sun |
memoFee | integer | 必返 | 备注手续费 | sun |
account_create_fee | integer | 可选 | 账户创建手续费（创建新账户交易时出现） | sun |
contractData 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
owner_address | string | 必返 | 调用方地址（Base58 / Hex，视合约类型） | — |
contract_address | string | 可选 | 被调用合约地址（智能合约调用时出现） | — |
data | string | 可选 | 调用数据（智能合约调用时出现） | hex |
amount | integer | 可选 | 调用附带金额；contractType=1（TRX 转账）→ SUN；contractType=2（TRC10 转账）→ token-smallest-unit，配合 tokenInfo.tokenDecimal 换算 | sun |
trigger_info 对象（智能合约调用时出现）
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
method | string | 必返 | 方法签名（如 transfer(address _to,uint256 _value)） | — |
methodId | string | 必返 | 方法 ID（4 字节 hex，如 a9059cbb） | — |
parameter | object | 必返 | 入参对象，键为参数名（如 _to、_value），值为字符串/数字（视参数类型） | — |
contract_address | string | 必返 | 被调用合约地址 | — |
call_value | integer | 必返 | 调用附带 TRX 金额 | sun |
trc20TransferInfo[] / transfersAllList[] / tokenTransferInfo 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
from_address | string | 必返 | 转出地址（Base58） | — |
to_address | string | 必返 | 转入地址（Base58） | — |
contract_address | string | 必返 | 代币合约地址（TRC10 为 token id） | — |
amount_str | string | 必返 | 转账金额（未除以 decimals 的原始值） | — |
decimals | integer | 必返 | 代币精度 | — |
name | string | 必返 | 代币全名（如 Tether USD） | — |
symbol | string | 必返 | 代币缩写（如 USDT） | — |
type | string | 必返 | 转账类型（如 Transfer、Approval） | — |
status | integer | 必返 | 状态码（0 成功） | — |
tokenType | string | 必返 | 代币类型（trc20/trc10/trc721/trc1155） | — |
tokenType2 | string | 必返 | 代币类型（兼容字段，值同 tokenType） | — |
level | string | 必返 | 代币等级：0（UNKNOWN，未知）、1（NEUTRAL，中性）、2（OK，正常）、3（SUSPICIOUS，可疑）、4（UNSAFE，不安全） | — |
icon_url | string | 必返 | 代币 logo URL | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
srConfirmList[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
address | string | 必返 | SR 地址（Base58） | — |
name | string | 必返 | SR 名称 | — |
block | integer | 必返 | 确认该交易的区块高度 | — |
url | string | 必返 | SR 官网 URL | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 无效哈希：传入不存在的哈希返回
200+ 空对象{}，不会报 4xx。
最后更新于: