$PRIVY is live -

Skip to content
Docs

API reference

Token search

Find tokens by name, symbol or mint.

Search tokens

GET/api/v1/tokens/searchPublic

Searches by name, symbol or exact mint address. Results are cached briefly per query.

Parameters

  • querystring · queryrequired

    Name, symbol or mint, up to 64 characters.

  • limitinteger · queryoptional

    Number of results, 1 to 50. Defaults to 20.

Response (array of)

  • mintstring

    Token mint address (base58).

  • namestring

    Token name.

  • symbolstring

    Ticker symbol.

  • decimalsinteger

    Decimal places of the raw amount.

  • usdPricenumbernullable

    Latest USD price, or null when unpriced.

  • verifiedboolean

    Whether the token passes Jupiter verification.

  • imageUrlstring · uri

    Proxied, cached token logo URL.

curl "https://privy.ac/api/v1/tokens/search?query=bonk"

Try it

Sends a real request
Example response
{
  "data": [
    {
      "mint": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
      "name": "Bonk",
      "symbol": "Bonk",
      "decimals": 5,
      "usdPrice": 0.00000337,
      "verified": true,
      "imageUrl": "https://privy.ac/api/token-image/DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"
    }
  ],
  "requestId": "req_8f3a2c91d4e6b07f"
}