🪙Token List

Returns tracked tokens and metadata for a chain.

Endpoint: GET https://api.liqd.ag/tokens

Authentication: None required — publicly accessible

Rate Limits: No rate limits

Required Parameters

Name	Type	Description	Required	Example
chainId	number	Chain to query (999 = HyperEVM, 4663 = Robinhood Chain)	Yes	999

Optional Parameters

Name	Type	Description	Default
search	string	Filter tokens by address, name, or symbol	none
limit	number	Maximum number of tokens to return	none
offset	number	Pagination offset	0
metadata	boolean	When "false", returns only addresses	true

Note: Tokens are sorted by 24-hour transfer count in descending order.

Example Requests:

GET https://api.liqd.ag/tokens?chainId=999
GET https://api.liqd.ag/tokens?chainId=4663
GET https://api.liqd.ag/tokens?chainId=999&limit=10
GET https://api.liqd.ag/tokens?chainId=999&offset=10&limit=10
GET https://api.liqd.ag/tokens?chainId=999&search=HYPE
GET https://api.liqd.ag/tokens?chainId=4663&search=WETH
GET https://api.liqd.ag/tokens?chainId=999&metadata=false

Response Fields

Field	Description
success	Whether the request succeeded
data.chainId	Chain that was queried
data.tokens	Token list when metadata is not false
data.tokens[].address	Token contract address
data.tokens[].name / symbol / decimals	Token metadata
data.tokens[].isERC20Verified	Whether the token passed ERC20 verification
data.tokens[].transfers24h / totalTransfers	Transfer activity
data.addresses	Address-only list when metadata=false
data.count	Total matching tokens
data.limitedCount	Number returned in this page
data.offset / nextOffset / hasMore	Pagination
data.searchApplied / limitApplied	Whether filters were applied
data.serviceStatus	Indexer status