获取内部交易列表

1. 概述与典型用途

按地址 / 合约 / 区块等条件查询智能合约内部交易记录，支持分页。

GET /api/internal-transaction

参数	类型	必填	默认	说明
`start`	integer	否	`0`	起始编号（偏移量）；`start + limit ≤ 10000`，超出被静默处理
`limit`	integer	否	`10`	每页数量，最大 50（超出被静默截断）
`address`	string	否	—	指定地址；`address`、`block`、`contract` 三者中至少需指定一个
`contract`	string	否	—	按合约地址过滤
`block`	integer	否	—	按区块号过滤
`start_timestamp`	integer	否	—	起始时间，毫秒时间戳
`end_timestamp`	integer	否	—	结束时间，毫秒时间戳
`confirm`	string	否	—	确认状态：`0` 已确认 / `1` 未确认 / 空全部
`noteType`	string	否	—	按调用类型过滤（如 `call`、`create`）
`ret`	string	否	`all`	按结果状态过滤（如 `SUCCESS`、`REVERT`）
`tokens`	string	否	—	按代币 ID 过滤，多个以逗号分隔

顶层

字段	类型	是否必返	说明	单位/精度
`total`	integer	必返	命中总数	—
`rangeTotal`	integer	必返	过滤范围内总数	—
`data`	array	必返	内部交易记录数组，见下	—
`contractMap`	object	可选	地址 → 是否为合约的映射	—
`contractInfo`	object	可选	合约地址 → 标签信息映射；value schema 见下	—
`normalAddressInfo`	object	可选	非合约地址 → 风险信息映射；每地址 value 实测仅含 `risk`（boolean），无其他子字段	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`hash`	string	必返	触发内部交易的外部交易哈希	—
`internal_hash`	string	必返	内部交易哈希	—
`block`	integer	必返	区块高度	—
`timestamp`	integer	必返	区块时间	毫秒时间戳 ms
`from`	string	必返	发送方地址	—
`to`	string	必返	接收方地址	—
`call_value`	integer	必返	调用值	sun
`token_id`	string	必返	代币 ID（`_` 代表 TRX）	—
`note`	string	必返	调用类型（如 `call`、`create`）	—
`confirmed`	boolean	必返	是否已确认	—
`rejected`	boolean	必返	是否被拒绝	—
`result`	string	必返	执行结果	—
`revert`	boolean	必返	是否已回退	—
`token_list`	object	必返	代币信息，子字段见下方 `token_list` 对象表	—
`valueInfoList`	array	必返	转账值信息列表，元素 schema 见下方 `valueInfoList[]` 元素表	—
`toAddressTag`	string	可选	接收方地址标签（仅接收方有标签时出现）	—
`fromAddressTag`	string	可选	发送方地址标签（仅发送方有标签时出现）	—
`voteToAddress`	array	必返	投票目标地址列表（非投票类型时为空数组）	—
`voteCount`	integer	必返	投票数量（非投票类型时为 0）	—
`voteDetail`	array	必返	投票详情（非投票类型时为空数组）	—

token_list 对象

字段	类型	是否必返	说明	单位/精度
`token_id`	string	必返	代币 ID（`_` 代表 TRX）	—
`call_value`	integer	必返	调用值；TRX 时单位为 sun，非 TRX 资产为代币原始精度（需配合 `tokenInfo.tokenDecimal` 换算）	—
`tokenInfo`	object	必返	代币元信息；子字段 schema 见下	—

valueInfoList[] 元素

字段	类型	是否必返	说明	单位/精度
`callValue`	integer	必返	调用值；TRX 时单位为 sun，非 TRX 资产为代币原始精度（需配合 `tokenInfo.tokenDecimal` 换算）	—
`tokenInfo`	object	必返	代币元信息；子字段 schema 见下	—

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"`）；仅知名实体或部分接口返回

token_list.tokenInfo / valueInfoList[].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"` / `"1"` / `"2"` / `"4"`，具体语义以后端定义为准）	—
`vip`	boolean	必返	是否为 VIP 代币	—

HTTP 状态码见公共错误说明。本接口要点：