← all AgentPay tools

token_security

Scan any token contract for honeypot, rug pull, and security risks.

When agents use this

You need to check if a token contract is safe before trading or investing.

Parameters

name	type	required	description
chain	string	no	Blockchain to query (default: ethereum)
contract_address	string	yes	Token contract address (0x...)

Returns

risk_level, is_honeypot, buy_tax, sell_tax, holder_count, owner_address, is_mintable, can_take_back_ownership

Example response

{
  "contract_address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "chain": "ethereum",
  "risk_level": "low",
  "is_honeypot": false,
  "buy_tax": 0.0,
  "sell_tax": 0.0,
  "holder_count": 842341,
  "is_mintable": false,
  "can_take_back_ownership": false,
  "source": "goplus"
}

Call it — HTTP (x402)

curl -X POST https://agentpay.tools/tools/token_security/call \
  -H 'Content-Type: application/json' \
  -d '{"parameters": {"contract_address": "Token contract address (0x...)"}, "agent_address": "<your wallet or any identifier>"}'

Call it — Python SDK

from agentpay import quickstart  # pip install agentpay-x402

s = quickstart(max_spend=0.10)   # hard budget cap; mints a wallet, no funding needed
r = s.call("token_security", {"contract_address": "Token contract address (0x...)"})
print(r.data)                    # + r.cost, r.tx, r.network — full receipt

Call it — MCP

npx -y @romudille/agentpay-mcp   # keyless; exposes token_security to any MCP agent runtime