获取合约列表

1. 概述与典型用途

分页查询链上智能合约列表，支持按调用量、余额、创建时间排序，支持按验证状态和开源状态过滤。

典型用途：合约排行榜展示、合约搜索、按部署者查询名下合约。
何时不要用：查询单个合约详情用「获取合约详细信息」；查询合约触发交易用「获取触发交易列表」。

2. 接口与鉴权

GET /api/contracts

Base URL 与鉴权见公共网络与鉴权说明。

3. 请求

字段

参数	类型	必填	默认	说明
`start`	integer	否	`0`	起始编号（偏移量）；`start + limit ≤ 10000`
`limit`	integer	否	`10`	每页数量，最大 50
`sort`	string	否	`-trxCount`	排序字段：`-trxCount`、`-balance`、`-timestamp`，`-` 前缀表示降序
`search`	string	否	—	按合约名称或合约地址搜索
`open-source-only`	boolean	否	`false`	是否只显示开源合约
`verified-only`	boolean	否	`false`	是否只显示已验证合约
`owner`	string	否	—	按部署者地址筛选
`start_timestamp`	integer	否	—	创建时间起始，毫秒时间戳
`end_timestamp`	integer	否	—	创建时间结束，毫秒时间戳
`confirm`	integer	否	`0`	确认状态过滤：`0` 全部、`1` 已确认

4. 响应

字段

顶层

字段	类型	是否必返	说明	单位/精度
`code`	integer	必返	HTTP 状态码（正常为 200）	—
`message`	string	必返	响应消息（正常为 `"request ok"`）	—
`total`	integer	必返	命中总数（上限 10000）	—
`rangeTotal`	integer	必返	过滤条件范围内的合约总数	—
`data`	array	必返	合约列表	—
`triggerTop7`	array	必返	近期调用量 Top 合约列表（实际不限 7 个）	—
`contractCount`	integer	必返	全网合约总数	—
`contractCount24h`	integer	必返	近 24 小时新增合约数	—
`verifyContractCount`	integer	必返	已验证合约总数	—
`verifyContractCount24h`	integer	必返	近 24 小时新增已验证合约数	—
`totalTrigger`	integer	必返	近期触发交易总数	—
`updateTime`	integer	必返	数据更新时间	毫秒时间戳
`lastUpdateSeconds`	integer	必返	数据最后更新时间	秒时间戳（10 位）
`status`	object	必返	状态码与消息	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`address`	string	必返	合约地址	—
`name`	string	必返	合约名称	—
`verify_status`	integer	必返	验证状态：0 未验证、1 部分验证、2 完全验证	—
`balance`	integer	必返	TRX 余额	sun（1 TRX = 10^6 sun）
`trxCount`	integer	必返	累计交易数	—
`date_created`	integer	必返	合约创建时间	毫秒时间戳
`tag1`	string	可选	合约主标签	—
`tag1Url`	string	可选	主标签链接	—
`vip`	boolean	必返	是否为 VIP 合约	—
`risk`	boolean	必返	风险标记	—
`publicTagDesc`	string	必返	公开标签描述（可为空字符串）	—
`license`	string	必返	开源许可证标识（如 `"0"` 表示无）	—
`compile_version`	string	可选	编译器版本（已验证合约）	—
`compile_settings`	string	必返	编译设置 JSON 字符串；未验证合约为空字符串 `""`	—
`verify_time`	integer	必返	验证时间；未验证合约为 `0`	毫秒时间戳
`trc20token`	object	可选	TRC20 代币信息（仅 TRC20 合约）	—

trc20token 子字段

字段	类型	是否必返	说明	单位/精度
`symbol`	string	必返	代币符号	—
`total_supply`	string	必返	总供应量	—
`contract_address`	string	必返	合约地址	—
`decimals`	string	必返	精度位数	—
`name`	string	必返	代币名称	—
`icon_url`	string	必返	代币 Logo URL（可为空字符串）	—
`issuer_addr`	string	必返	发行方地址	—
`holders_count`	string	必返	持有者总数（字符串）	—
`token_type`	string	必返	代币类型（`trc20` / `trc721` / `trc1155`）	—
`level`	string	必返	代币等级：`0`（UNKNOWN，未知）、`1`（NEUTRAL，中性）、`2`（OK，正常）、`3`（SUSPICIOUS，可疑）、`4`（UNSAFE，不安全）	—
`token_desc`	string	可选	代币描述	—
`home_page`	string	可选	项目主页 URL	—
`git_hub`	string	可选	GitHub 链接	—
`white_paper`	string	可选	白皮书链接	—
`email`	string	可选	联系邮箱	—
`social_media`	string	可选	社交媒体链接	—
`issue_time`	string	可选	发行时间	—
`status`	string	可选	代币状态标识	—

triggerTop7[] 元素

字段	类型	是否必返	说明	单位/精度
`contract`	string	必返	合约地址	—
`name`	string	必返	合约名称	—
`percentage`	number	必返	在近期触发中的占比	—
`triggers`	integer	必返	近期触发次数	—
`tag1`	string	必返	合约标签（可为空字符串）	—
`tag1Url`	string	必返	标签链接（可为空字符串）	—
`blueTagUrl`	string	必返	蓝色标签链接（可为空字符串）	—
`risk`	boolean	必返	风险标记	—
`publicTagDesc`	string	必返	公开标签描述（可为空字符串）	—

5. 错误

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

start + limit 超过 10000：超出后被静默截断并返回 200，不会报错。
limit 超过 50：被静默限制为 50。
空结果 ≠ 错误：无命中返回 200 + data: []，属于正常响应。

最后更新于: 2026年3月23日

查询地址是否存在于其他链获取合约详细信息