Token lookup

GET

tokens

{query}

curl https://api.useknot.xyz/tokens/USDC \
  -H "Authorization: Bearer <token>"

curl https://api.useknot.xyz/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  -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

string

required

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

Response

boolean

true when the token is found.

object

Show properties

string

Token mint address.

string

Token symbol.

string

Full token name.

number

Number of decimal places for this token.

boolean

true if the token is from a verified source.

string

Data source used to resolve the token metadata. See the source table below.

Source values

Source	Description
`local`	Token from the built-in verified directory
`jupiter`	Token resolved via the Jupiter API
`helius`	Token metadata resolved via the Helius DAS API

Errors

Status	Description
`401`	Missing or invalid Bearer token
`404`	Token not found
`429`	Rate limit exceeded

curl https://api.useknot.xyz/tokens/USDC \
  -H "Authorization: Bearer <token>"

curl https://api.useknot.xyz/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  -H "Authorization: Bearer <token>"

{
  "status": true,
  "data": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "verified": true,
    "source": "local"
  }
}

curl https://api.useknot.xyz/tokens/USDC \
  -H "Authorization: Bearer <token>"

curl https://api.useknot.xyz/tokens/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v \
  -H "Authorization: Bearer <token>"

{
  "status": true,
  "data": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "verified": true,
    "source": "local"
  }
}

Overview

Authentication

Wallet

Policy

Utility

Path parameters

Response

Source values

Errors

​Path parameters

​Response

​Source values

​Errors

Path parameters

Response

Source values

Errors