搜索代币/合约/账户信息
1. 概述与典型用途
按关键词搜索代币、合约、账户信息，支持分页和类型过滤，返回匹配结果。
- 典型用途：实现全站搜索功能、按关键词查找代币或合约、搜索账户信息。
- 何时不要用：查热门代币推荐用「获取热门搜索信息」；查热搜排行用「获取热搜信息」。
term为必填参数；start必须小于 50；limit最大值为 50。
2. 接口与鉴权
GET /api/search/v2
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
term | string | 是 | — | 搜索关键词，缺失返回参数缺失错误 |
start | integer | 否 | 0 | 起始编号，必须小于 50 |
limit | integer | 否 | 10 | 每页数量，最大 50 |
type | string | 否 | — | 搜索类型：token、address、contract、transaction、block |
address | string | 否 | — | 直接按地址搜索，与 term 结合使用 |
detail | boolean | 否 | false | 是否返回详细信息 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
address | array | 可选 | 地址匹配结果，见下 |
token | array | 可选 | 代币匹配结果，见下 |
contract | array | 可选 | 合约匹配结果，见下 |
token[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
token_id | string | 必返 | 代币合约地址或 ID | — |
token_type | string | 必返 | 代币类型：trc20、trc10 | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
name | string | 必返 | 代币名称 | — |
abbr | string | 必返 | 代币简称 | — |
description | string | 必返 | 代币描述 | — |
img_url | string | 必返 | 代币图标 URL | — |
url | string | 必返 | 代币官网 URL | — |
holders | integer | 必返 | 持有者数量 | — |
level | string | 必返 | 代币等级 | — |
market_cap | number | 必返 | 市值（TRX） | TRX |
market_cap_usd | number | 必返 | 市值（USD） | USD |
market_cap_trx | number | 必返 | 市值（TRX，同 market_cap） | TRX |
is_certificates | boolean | 必返 | 是否持有认证 | — |
market_info | object | 必返 | 市场行情信息，子字段：fPrecision（整数，代币精度）/fShortName（代币缩写）/fTokenAddr（代币合约地址）/filter（boolean，是否过滤）/gain（24h 价格涨跌幅）/liquidity（流动性 USD）/pairUrl（交易对链接）/priceFrom（定价来源，如 "SUNSWAPV2"）/priceInTrx（TRX 计价）/priceInUsd（USD 计价）/sPrecision（计价代币精度）/sShortName（计价代币缩写）/volume24hGain（24h 成交量环比变化率）/volume24hInTrx（24h 成交量 TRX） | — |
volume24h | number | 必返 | 24 小时成交量 | USD |
contract[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 合约名称 | — |
balance | integer | 必返 | 合约 TRX 余额 | sun |
contract_address | string | 必返 | 合约地址 | — |
description | string | 必返 | 合约描述 | — |
date_created | integer | 必返 | 合约创建时间戳 | 秒时间戳 |
verify_status | integer | 必返 | 合约验证状态：0=未验证 / 1=部分验证 / 2=完全验证 | — |
total_transactions | integer | 必返 | 总调用次数 | — |
official | boolean | 必返 | 是否为官方合约 | — |
frozen | integer | 必返 | 冻结数量 | sun |
tag | string | 必返 | 合约标签（如 "USDT Token"） | — |
address[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
name | string | 必返 | 地址名称或标签 | — |
address | string | 必返 | 账户地址 | — |
date_created | integer | 必返 | 创建时间 | 秒时间戳 |
balance | integer | 必返 | TRX 余额 | sun |
totalBalance | number | 必返 | 总余额 | sun |
total_transactions | integer | 必返 | 总交易数 | — |
frozen | integer | 必返 | 冻结数量 | — |
address_tag | string | 必返 | 地址标签文字（无标签时为 ""） | — |
address_tag_logo | string | 必返 | 地址标签图标 URL（无时为 ""） | — |
witness_url | string | 必返 | 超级代表官网 URL（非 SR 时为 ""） | — |
activated | boolean | 必返 | 账户是否已激活 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
term必填：缺少时返回参数缺失错误。- 空结果 ≠ 错误：无匹配结果时对应数组为
[]，属于正常响应。
最后更新于: