agentsvc.io

services / token-verdict

financeoperational · 474 ms

Token Verdict (grade A to F)

Instant buy-or-avoid verdict for a token, with a shareable result page and preview card (share_url): send a contract address (Base, Ethereum, BSC, Arbitrum, Polygon, Avalanche, Optimism) or a Solana mint, get a grade A to F, a label (SAFE, CAUTION, RISKY, DANGER), a 0 to 100 score and a one-line reason, built from real checks: honeypot sell simulation, buy and sell tax, mint, freeze and owner powers, owner powers in the contract code, DEX liquidity and token age, all computed by us on the blockchain. Young or illiquid tokens can never grade above C. Also returns key facts and a share_text. Params: token (address; tokenAddress also accepted), chain (default base; solana auto-detected).

Run free trial ↗3 free calls per day with the example input. Paid: $0.009 USDC, no limit.

Call it

import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agentsvc.io/api/v1/proxy/token-verdict", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({"token":"0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed","chain":"base"}),
});
const { data, payment } = await res.json();  // payment.status "settling"; header X-Payment-Settle: sync returns payment.transaction

Input

FieldTypeDescription
tokenstringToken contract address (0x...) or Solana mint address. Alias: tokenAddress
chainbase | ethereum | bsc | arbitrum | polygon | avalanche | optimism | solana = "base"
tokenAddressstringAlias of token

Output

FieldTypeDescription
tokenstring
chainstring
namestring,null
symbolstring,null
gradestring
labelstring
scoreinteger
one_linerstring
reasonsarray
key_factsarray
checksobject
price_usdnumber,null
market_cap_usdnumber,null
share_textstring
share_urlstring,null
linksobject
full_reportstring
disclaimerstring
checked_atstring

Example response (data)

{
  "token": "0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
  "chain": "base",
  "name": "Degen",
  "symbol": "DEGEN",
  "grade": "D",
  "label": "RISKY",
  "score": 49,
  "one_liner": "Risky: owner can pause transfers, $549K liquidity, 1005 days old.",
  "reasons": [
    "Owner can pause transfers"
  ],
  "key_facts": [
    "Liquidity $549K across 16 pool(s)",
    "Token 1005 days old",
    "Sell simulation passed",
    "Tax 0% buy / 0% sell"
  ],
  "checks": {
    "honeypot": false,
    "buy_tax": 0,
    "sell_tax": 0,
    "mintable": false,
    "freezable": null,
    "owner_renounced": false,
    "liquidity_usd": 548560,
    "age_days": 1004.7,
    "holder_count": null,
    "top10_holders_pct": null,
    "lp_locked_pct": null
  },
  "price_usd": 0.0010027750338190767,
  "market_cap_usd": 36143133,
  "share_text": "DEGEN (base): grade D, RISKY, 49/100. Risky: owner can pause transfers, $549K liquidity, 1005 days old. Checked by agentsvc.io",
  "share_url": "https://agentsvc.io/v/4VWZj3b2",
  "links": {
    "explorer": "https://basescan.org/token/0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed",
    "chart": "https://basescan.org/address/0x0ca6485b7e9cf814a3fd09d81672b07323535b64"
  },
  "full_report": "Call token-security with the same input for every flag, holder and market detail.",
  "disclaimer": "Automated risk check from on-chain data (contract code, pools, trade simulation). Not financial advice; a good grade does not guarantee safety.",
  "checked_at": "2026-10-08T07:29:46.040Z"
}