Token Search

searchTokensGET

Full-text search over token name, symbol and mint address. Results come back ranked, with legitimate tokens ahead of the impersonators that copy their name, so the array order can be rendered as-is. Passing no query returns trending tokens.

Endpoint

GEThttps://api.rugcheck.xyz/v1/search

Parameters

qstring optional query

Search query - a token name, symbol, or mint address. Partial names and symbols match. Omit it entirely to get the list of trending tokens.

limitinteger optional query

Maximum results to return (default: 20, capped at 50)

pageinteger optional query

Zero-based page number, applied against limit (default: 0)

maxScoreinteger optional query

Drop results whose raw RugCheck risk score is above this value. Default 0 means unfiltered - it is not a 'score must be 0' filter. Use e.g. maxScore=2000 to hide the riskiest tokens. These are the raw RugCheck scores before normalization from 1-100.

Result

array

Ranked search results, best match first. The array order is the ranking - do not re-sort it client side.

mintstring

The token mint address

namestring

Token name.

symbolstring

Token symbol.

verifiedboolean

Whether the token is verified on RugCheck or carries Jupiter verification

scoreinteger

The raw RugCheck risk score - higher is riskier. This is the raw value (e.g. 11400), not a 0-100 percentage.

mcapnumber

Last known market cap in USD.

holdersinteger

Last known holder count.

Code Examples

Request

Shell

curl -X GET "https://api.rugcheck.xyz/v1/search?q=bonk&limit=10"

Response

JSON

[

{

"mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",

"name": "Bonk",

"symbol": "Bonk",

"verified": true,

"score": 1,

"mcap": 1284310000,

"holders": 942117

{

"mint": "8vBMibwpn8wpfYKbQ9xqzodymg3LjmYec2tSNGRy23K8",

"name": "Bonk Inu",

"symbol": "BONKINU",

"verified": false,

"score": 11400,

"mcap": 48200,

"holders": 613

}

]

getMaintenance

getTokenReport