Skip to main content
POST
/
v1
/
token
Scan Token
curl --request POST \
  --url https://api.novashield.so/v1/token \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "solana",
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
}
'
{
  "mint": "<string>",
  "symbol": "USDC",
  "name": "USD Coin",
  "verdict": "safe",
  "score": 0.5,
  "flags": [
    "MINT_AUTHORITY_RENOUNCED",
    "LP_LOCKED",
    "FREEZE_AUTHORITY_RENOUNCED"
  ],
  "metadata": {
    "decimals": 123,
    "supply": "<string>",
    "mint_authority": "<string>",
    "freeze_authority": "<string>",
    "update_authority": "<string>",
    "top_holders": [
      {
        "address": "<string>",
        "percentage": 123
      }
    ],
    "lp_info": [
      {
        "dex": "<string>",
        "pool": "<string>",
        "liquidity_usd": 123,
        "locked": true
      }
    ],
    "impersonation": {
      "is_impersonation": true,
      "similarity_score": 123
    }
  }
}
Returns verdict, risk score, flags, and rich metadata for informed decisions.

Body

application/json
​
chain
enum<string>
required
Available options:
solana
​
mint
string
required

Token mint address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Response

Token analysis complete

​
mint
string
​
symbol
string
Example:

"USDC"

​
name
string
Example:

"USD Coin"

​
verdict
enum<string>
Available options:
safe,
suspicious,
malicious
​
score
number

Risk score (higher = more risky)

Required range: 0 <= x <= 1
​
flags
string[]

Security flags

Example:
[
  "MINT_AUTHORITY_RENOUNCED",
  "LP_LOCKED",
  "FREEZE_AUTHORITY_RENOUNCED"
]
​
metadata
object