获取合约列表
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 | 必返 | 代币等级 | — |
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: []，属于正常响应。
最后更新于: