Search Tokens/Contracts/Accounts

1. Overview & Typical Use

Search for tokens, contracts, and accounts by keyword. Supports pagination and type filtering, returning matching results.

Typical use: site-wide search, find tokens or contracts by keyword, search for accounts.
When not to use: for popular search-bar suggestions use “Get Search Bar Data” (/api/search/bar); for hot-search rankings use “Get Hot Search Data” (/api/search/hot).
term is required; start must be less than 50; limit maximum is 50.

GET /api/search/v2

For Base URL and authentication, see Common Network & Authentication.

Parameter	Type	Required	Default	Description
`term`	string	Yes	—	Search keyword; returns a missing-parameter error if omitted
`start`	integer	No	`0`	Start offset; must be less than 50
`limit`	integer	No	`10`	Page size; maximum 50
`type`	string	No	—	Search type: `token`, `address`, `contract`, `transaction`, `block`
`address`	string	No	—	Search directly by address; used in combination with `term`
`detail`	boolean	No	`false`	Whether to return detailed information

Top-level

Field	Type	Required	Description
`address`	array	Optional	Address match results; see below
`token`	array	Optional	Token match results; see below
`contract`	array	Optional	Contract match results; see below

token[] elements

Field	Type	Required	Description	Unit/Precision
`token_id`	string	Required	Token contract address or ID	—
`token_type`	string	Required	Token type: `trc20`, `trc10`	—
`vip`	boolean	Required	Whether this is a VIP token	—
`name`	string	Required	Token name	—
`abbr`	string	Required	Token abbreviation	—
`description`	string	Required	Token description	—
`img_url`	string	Required	Token icon URL	—
`url`	string	Required	Token official website URL	—
`holders`	integer	Required	Number of holders	—
`level`	string	Required	Token level	—
`market_cap`	number	Required	Market cap (TRX)	TRX
`market_cap_usd`	number	Required	Market cap (USD)	USD
`market_cap_trx`	number	Required	Market cap (TRX, same as `market_cap`)	TRX
`is_certificates`	boolean	Required	Whether the token holds certifications	—
`market_info`	object	Required	Market data; sub-fields: `fPrecision` (integer, token precision) / `fShortName` (token abbreviation) / `fTokenAddr` (contract address) / `filter` (boolean) / `gain` (24h price change) / `liquidity` (USD) / `pairUrl` (pair link) / `priceFrom` (price source, e.g. `"SUNSWAPV2"`) / `priceInTrx` / `priceInUsd` / `sPrecision` / `sShortName` / `volume24hGain` / `volume24hInTrx`	—
`volume24h`	number	Required	24-hour trading volume	USD

contract[] elements

Field	Type	Required	Description	Unit/Precision
`name`	string	Required	Contract name	—
`balance`	integer	Required	Contract TRX balance	sun
`contract_address`	string	Required	Contract address	—
`description`	string	Required	Contract description	—
`date_created`	integer	Required	Contract creation timestamp	Unix seconds
`verify_status`	integer	Required	Contract verification status: `0`=unverified / `1`=partial / `2`=full	—
`total_transactions`	integer	Required	Total call count	—
`official`	boolean	Required	Whether this is an official contract	—
`frozen`	integer	Required	Frozen amount	sun
`tag`	string	Required	Contract tag (e.g. `"USDT Token"`)	—

address[] elements

Field	Type	Required	Description	Unit/Precision
`name`	string	Required	Address name or label	—
`address`	string	Required	Account address	—
`date_created`	integer	Required	Creation time	Unix seconds
`balance`	integer	Required	TRX balance	sun
`totalBalance`	number	Required	Total balance	sun
`total_transactions`	integer	Required	Total transaction count	—
`frozen`	integer	Required	Frozen amount	—
`address_tag`	string	Required	Address tag text (empty string if none)	—
`address_tag_logo`	string	Required	Address tag icon URL (empty string if none)	—
`witness_url`	string	Required	Super Representative website URL (empty string if not SR)	—
`activated`	boolean	Required	Whether the account is activated	—

For HTTP status codes, see Common Errors. Key points for this endpoint:

term is required: missing term returns a missing-parameter error.
Empty result is not an error: no matches returns 200 with the corresponding array as [].