Scan a token
get_token_scanRun a full DeFade scan on one token contract. On Solana: token metadata, holder distribution, creator history (wallet age, previous token launches) and the headline risk verdict. On an EVM chain: the contract and market read only (token metadata with the owner and the mint, blacklist, whitelist and proxy flags, market, pairs and warnings), with no holders, creator or score; call get_rug_score there for the verdict. Start here for any "is this token safe", "is this a rug pull" or "should I buy this" question, then call get_rug_score for the verdict: the safety score here weighs only holders, creator and authorities. On Solana returns risk.score as a SAFETY score where 100 is clean and low numbers are dangerous, with a rating label. For the inverse — a rug pull probability where high means dangerous — call get_rug_score. Not for a single module in isolation (call that module's tool directly), price or market-cap questions (get_token_price), or checking the caller's own quota (get_usage). Arguments: address and chain; one API unit on any chain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chain | No | Chain the token is deployed on: solana (default), ethereum, base, bsc, robinhood, arc, hyperevm, monad. Required for any 0x address, because the same contract address can exist on several EVM chains. Omit it for Solana. An unsupported value is rejected before any request is spent; EVM chains need a key on an All-Chains plan. | solana |
| address | Yes | The token's own contract address, exactly as an explorer shows it. Solana: the base58 mint, 32-44 characters (e.g. 6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN). EVM: 0x followed by 40 hex characters, case-insensitive (e.g. 0x6982508145454ce325ddbe47a25d4ec3d2311933). Never a pool, pair, wallet or deployer address — those come back as not found. Set `chain` to match the address: a 0x address alone cannot say which EVM chain it lives on, and a Solana mint sent with an EVM chain is rejected. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| risk | No | Solana only. The SAFETY score: score (0-100, 100 is clean), rating, color, flags. Opposite direction from get_rug_score. Absent on EVM chains, where get_rug_score is the score. | |
| token | No | Token metadata. Solana: name, symbol, mint, supply, decimals, creator, mintAuthority, freezeAuthority, marketCap, liquidity, and timeline, whose launchPlatform names the launchpad (pump.fun, bonk.fun, Jupiter Studio, boop.fun, MetaDAO, Pangea, based.bid …; DEX or Unknown when none) and whose mayhem is set on a pump.fun coin launched in Mayhem mode (agent, program, mintedToAgent, endsAt; null on any other coin and once 26 hours old, absent when the curve could not be read). EVM: name, symbol, decimals, totalSupply, owner, ownerRenounced, ownerLaunchpad (the owner by name when it is a launch protocol's contract that owns the token only to launch it, such as Doppler's Airlock, flap.sh's Portal or four.meme's TokenManager, or a label the contract gives no powers: the owners the rug score does not count), ownerLaunchpadKind (protocol, curve, controller or label), mintable, hasBlacklist, hasWhitelist, isProxy, dexPaid. | |
| market | No | EVM only: the main pair — priceUsd, marketCap, fdv, liquidityUsd, volume24h, priceChange, pairCreatedAt, dex. A nad.fun token still on its curve is priced from the curve: source "curve" and curve. Null when no pair was found. | |
| creator | No | Solana only. Deployer wallet: address, walletAgeDays, solBalance, totalTransactions, tokenCreations, recentTokens, riskLevel. | |
| holders | No | Solana only. Same body as get_holders: totalHolderCount, holderCountCapped, totalHolders, topHolders, concentration, protocolHoldings, lockedSupply, deferredUnlock, vesting, leftover, mayhemAgent, bundles. | |
| success | No | Solana: whether the scan completed. | |
| warnings | No | EVM only: what the contract and market read flagged, each level (critical, warning or info), code and message. | |
| launchpad | No | EVM only: the launchpad the token launched on, as the DeFade page names it: name (four.meme, flap.sh, Genius, Clanker, Zora, Virtuals, Pangea, Stockereum.fun, Pons, nad.fun, LiquidLaunch …), curve (its bonding curve, null when the launchpad has none), protocol, and onCurve and bondingProgress (0-100) for a token still on its curve. Null when no launchpad DeFade names, or the lookup did not answer in time. | |
| poweredBy | No | Always "DeFade.org". | |
| scanCount | No | How many times this token was scanned in the last 24 hours, on every DeFade surface (web, app, extension, Telegram, API) by every user, including this scan (scanWindow "24h"). | |
| timestamp | No | ISO time the response was assembled. | |
| analyzedAt | No | Solana: ISO time of the scan itself. | |
| scanWindow | No | The window scanCount covers: "24h". |