Skip to main content
GET
/
tokens
/
{query}
curl https://api.useknot.xyz/tokens/USDC \
  -H "Authorization: Bearer <token>"
{
  "status": true,
  "data": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "verified": true,
    "source": "local"
  }
}
Resolves a token symbol or mint address to its full metadata. Use this endpoint to verify a token before including it in a transfer or trade request.
Requires authentication via Bearer token.

Path parameters

query
string
required
Token symbol (e.g., USDC) or full mint address (e.g., EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v).

Response

status
boolean
true when the token is found.
data
object

Source values

SourceDescription
localToken from the built-in verified directory
jupiterToken resolved via the Jupiter API
heliusToken metadata resolved via the Helius DAS API

Errors

StatusDescription
401Missing or invalid Bearer token
404Token not found
429Rate limit exceeded
curl https://api.useknot.xyz/tokens/USDC \
  -H "Authorization: Bearer <token>"
{
  "status": true,
  "data": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "verified": true,
    "source": "local"
  }
}