Composite rug pull risk score combining contract, holder, honeypot, deployer, and GoPlus analysis.
What it does
The `/api/defi/rug-score` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence for autonomous AI agents. This specific endpoint computes a composite rug pull score by aggregating signals from smart contract analysis, holder concentration, honeypot detection, deployer forensics, and GoPlus security data. It is designed for AI agents and automated systems that need to evaluate token safety before executing trades or recommending positions.
The endpoint accepts POST requests and is gated via the x402 payment protocol, settling in USDC on Base at $1.00 per call. Callers must include an x402 payment header; the payment settles only on a successful response. Free endpoint discovery is available via GET on the same path, which returns metadata including an `llm_usage_prompt` to help agents understand how to call the endpoint.
DeFi Shield offers related endpoints for deeper analysis: `/api/defi/contract-risk` for smart contract risk scoring, `/api/defi/simulate` for honeypot detection, `/api/defi/deployer-forensics` for deployment history and scam flags, and `/api/defi/full-scan` for a comprehensive token security scan combining all analyses in one call. Discovery of all endpoints and pricing is available at `/api/health`, and an A2A agent card is published at `/.well-known/agent-card.json`.
Capabilities
Use cases
- —AI trading agents evaluating token safety before executing a swap
- —Portfolio management bots screening new tokens for rug pull risk
- —DeFi aggregators flagging high-risk tokens in their UI
- —Security dashboards providing composite risk scores for listed tokens
- —Autonomous agents performing due diligence on newly launched tokens
Fit
Best for
- —AI agents needing automated rug pull risk assessment per token
- —DeFi security workflows requiring a single composite risk score
- —Autonomous trading systems that need pre-trade safety checks
Not for
- —Manual one-off token lookups where free block explorers suffice
- —Non-EVM chains or tokens not indexed by GoPlus
- —Users who need raw on-chain data rather than risk scoring
Quick start
# Discover endpoint metadata (free)
curl https://defi-shield-hazel.vercel.app/api/defi/rug-score
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/defi/rug-score \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x..."}'Example
Request
{
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
}Endpoint
Quality
The endpoint is live (402 challenge captured) and the landing page provides clear pricing ($1.00/call) and a high-level description. However, there is no OpenAPI schema, no response examples, no detailed documentation page, and the x402 challenge body was empty, so exact payment parameters (asset address, network, decimals) cannot be confirmed from the probe alone. The request schema is inferred from sibling endpoint examples.
Warnings
- —No OpenAPI or JSON schema available for request or response
- —x402 challenge body was empty — payment parameters not directly confirmed
- —No dedicated docs page (returns 404)
- —Response format is entirely inferred; no example response available
- —GoPlus integration claimed but not independently verifiable from crawl data
Citations
- —Composite rug pull score: contract + holders + honeypot + deployer + GoPlus, priced at $1.00 per callhttps://defi-shield-hazel.vercel.app
- —69 paid API endpoints selling security intelligence to autonomous AI agents, pay per request with USDC via x402 protocol on Basehttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery available via GET on each endpoint path with llm_usage_prompthttps://defi-shield-hazel.vercel.app
- —Payment settles only on successful responsehttps://defi-shield-hazel.vercel.app