Skip to main content
GET
/
api
/
analyze-token
/
:address
Analyze Token
curl --request GET \
  --url https://api.example.com/api/analyze-token/:address \
  --header 'x-payment-signature: <x-payment-signature>' \
  --header 'x-payment-wallet: <x-payment-wallet>'
{
  "risk_score": 123,
  "authorities": {
    "mint_authority_disabled": true,
    "freeze_authority_disabled": true
  },
  "summary": "<string>"
}
Provides a security assessment of an SPL token — checking mint authority status, freeze authority, and generating a risk score.

​
Authentication

This endpoint requires an x402 payment. A 402 Payment Required response is returned if the payment signature is missing or invalid. Cost: 0.1 USDC per request.

​
Header Parameters

​
x-payment-signature
string
required
A valid Solana transaction signature proving the USDC transfer to the merchant’s vault address.
​
x-payment-wallet
string
required
The public key of the wallet that made the payment.

​
Path Parameters

​
address
string
required
The public address of the SPL token mint to analyze.

​
Response

​
risk_score
number
Scale of 1-100 indicating token risk (100 = highest risk).
​
authorities
object
​
summary
string
Human-readable summary of the token’s safety profile.

​
Example

# First call returns 402
curl -i http://localhost:3000/api/analyze-token/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

# After payment
curl -H "x-payment-signature: <TX_SIGNATURE>" \
     -H "x-payment-wallet: <YOUR_PUBKEY>" \
     http://localhost:3000/api/analyze-token/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v