Solana token safety check
POST /api/sol-token-safetySafety headline for any Solana SPL token mint: RugCheck risk score (raw + 0-100 normalised), the named risks with level (danger/warn/info), LP locked percentage, and Jupiter's audit facts - mint authority and freeze authority revoked or live, top-holder share, dev mints, holder count, verified flag and organic score. Send POST /api/sol-token-safety with the required field mint and pay $0.005 per call over x402 or MPP (there is no free tier). It returns a JSON object with mint, score, scoreNormalised, lpLockedPct, risks and 7 more.
Two keyless public sources read in parallel; one compact verdict for pre-trade screening of memecoins and new launches.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
mint | string | yes | Base58 SPL token mint address. Also accepted as token, mintAddress, address, contract, tokenAddress. |
Example request
curl -i -X POST https://agent402.tools/api/sol-token-safety \
-H "Content-Type: application/json" \
-d '{"mint":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"}'
Without payment this returns HTTP 402 Payment Required with the exact price for sol-token-safety; any x402 v2 or MPP client pays it and retries.
Example response
{
"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
"score": 3550201,
"scoreNormalised": 97,
"lpLockedPct": 8.98,
"risks": [
{
"name": "Mutable metadata",
"level": "warn",
"score": 100,
"value": null,
"description": "Token metadata can be changed by the update authority"
}
],
"riskCounts": {
"danger": 0,
"warn": 1,
"info": 0
},
"token": {
"name": "Jupiter",
"symbol": "JUP",
"decimals": 6,
"holderCount": 835540,
"isVerified": true,
"organicScore": 99.3,
"organicScoreLabel": "high",
"launchpad": null
},
"authorities": {
"mintAuthorityDisabled": true,
"freezeAuthorityDisabled": true,
"mintAuthority": null,
"freezeAuthority": null
},
"holders": {
"topHoldersPct": 15.28,
"devBalancePct": null,
"devMints": 1
},
"riskLevel": "good",
"source": [
"rugcheck",
"jupiter"
],
"fetchedAt": "2026-08-22T12:00:00.000Z"
}
| Field | Type | Always present | In the example |
|---|---|---|---|
mint | string | yes | JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN |
score | number | yes | 3550201 |
scoreNormalised | number | yes | 97 |
lpLockedPct | number | yes | 8.98 |
risks | array of objects | yes | 1 item in the example |
riskCounts | object | yes | 3 fields: danger, warn, info |
token | object | yes | 8 fields: name, symbol, decimals, holderCount, isVerified, organicScore |
authorities | object | yes | 4 fields: mintAuthorityDisabled, freezeAuthorityDisabled, mintAuthority, free... |
holders | object | yes | 3 fields: topHoldersPct, devBalancePct, devMints |
riskLevel | string | yes | good |
source | array of string | yes | 2 items in the example |
fetchedAt | string | yes | 2026-08-22T12:00:00.000Z |
From an MCP client
catalog.call {
"slug": "sol-token-safety",
"params": {
"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
}
}
The hosted connector at https://agent402.tools/mcp needs a payment for sol-token-safety; the stdio package pays it from a wallet or from AGENT402_CREDITS_KEY. Local install: npx -y agent402-mcp.
Errors and behavior
mintis required. An input the tool rejects returns an HTTP 4xx whose body carrieserror,tool,expected,requiredandexample, so the caller can correct it.- A paid call that ends in any status of 400 or above is not charged over x402, MPP or a prepaid credits key: settlement is cancelled when the tool fails. The exception is a Tempo push credential, a transfer the buyer sent before the call: it settles before the tool runs, so if the tool then fails the payment is recorded as a refund owed to the paying wallet.
- Wallet-only: this tool reaches the network or stored state, so it has no proof-of-work tier. A prepaid card-credits key (
Authorization: Bearer a402_...) also pays it. - A
GETorHEADto /api/sol-token-safety returns the same 402 quote, so the price can be read without a body. - An
Idempotency-Keyheader makes a retried paid call replay the first 200 instead of charging again (an answer larger than 1 MB is not replayed).
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
client.setSpendControls?.(false); // keep your own spending ceiling in code
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/sol-token-safety", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"mint": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
}),
});
Related tools
Solana token risk report (full)
POST /api/sol-token-reportFull RugCheck report for a Solana token mint, trimmed to what an agent acts on: score and risks, mint/freeze authority s…
Solana token holder concentration
POST /api/sol-token-holdersTop-holder concentration for a Solana token mint: the 20 largest holders with token account, owner wallet, balance, perc…
Search Solana tokens and pairs
POST /api/sol-token-searchFind Solana tokens and pairs by name, ticker or address across every DEX DexScreener indexes, filtered to Solana only, i…
Solana token due-diligence brief
POST /v1/token-briefHand over a Solana SPL mint address and get one cited due-diligence brief: what the token is, whether the mint and freez…
Solana token prices (Jupiter)
POST /api/sol-priceUSD price for up to 50 Solana token mints in one call from Jupiter's price API v3: price, 24h change, liquidity, decimal…
Solana token lookup (Jupiter)
POST /api/sol-token-lookupResolve a Solana token by mint, ticker or name through Jupiter's token index and get its profile in one read: name, symb…