Deployer forensics: contract deployment history, scam flags, and reputation scoring via x402.
What it does
The `/api/defi/deployer-forensics` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence for autonomous AI agents. This specific endpoint analyzes smart contract deployers, returning deployment history, scam flags, and reputation data. It accepts POST requests and is priced at $0.75 per call, paid in USDC on Base via the x402 protocol.
DeFi Shield is hosted on Vercel and covers 11 categories including DeFi intelligence, wallet intelligence, MEV & trading, NFT intelligence, cross-chain analysis, safety & compliance, and more. Each endpoint supports free GET-based discovery (returning an `llm_usage_prompt`) and paid POST requests requiring an x402 payment header. Payment settles only on successful response. The platform provides discovery via `/.well-known/agent-card.json`, a health endpoint at `/api/health`, and analytics at `/api/analytics`.
The deployer-forensics endpoint is useful for AI agents evaluating whether to interact with a token or protocol by checking the track record of the contract deployer. It complements other DeFi Shield endpoints like `contract-risk`, `rug-score`, and `full-scan` for comprehensive due diligence. No OpenAPI schema or detailed request/response documentation was found, so the exact input parameters and response shape are inferred from the landing page description and quick-start examples.
Capabilities
Use cases
- —AI agent evaluating a new token by checking the deployer's history for prior scam deployments
- —Automated due diligence pipeline flagging contracts deployed by known bad actors
- —Portfolio management agent screening tokens before adding to a watchlist
- —Rug-pull detection workflow combining deployer forensics with contract risk and honeypot simulation
- —Agent-to-agent trust verification before interacting with a DeFi protocol
Fit
Best for
- —AI agents performing automated DeFi security checks
- —Autonomous trading bots needing deployer reputation data before entering positions
- —Security-focused workflows that need per-call pay-as-you-go forensics without subscriptions
Not for
- —Manual human-driven blockchain exploration (better served by Etherscan or similar)
- —High-volume bulk scanning where per-call pricing at $0.75 may be cost-prohibitive
- —Non-EVM chains or off-chain deployer analysis
Quick start
# Free discovery (GET returns llm_usage_prompt)
curl https://defi-shield-hazel.vercel.app/api/defi/deployer-forensics
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/defi/deployer-forensics \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"address": "0x..."}'Example
Request
{
"address": "0x1234567890abcdef1234567890abcdef12345678"
}Endpoint
Quality
The endpoint is live (402 challenge captured) and the landing page provides clear pricing and a brief description, but no OpenAPI schema, detailed docs, or example responses are available. Request/response shapes are inferred from the quick-start example and category description.
Warnings
- —No OpenAPI or JSON schema found for request or response payloads
- —No documentation page exists (/docs returns 404)
- —Example request body is inferred from the landing page quick-start; actual required fields may differ
- —x402 challenge object was empty — no payment details (amount, asset, network) were captured in the probe
Citations
- —Deployer-forensics endpoint is priced at $0.75 per call and provides contract deployment history, scam flags, and reputationhttps://defi-shield-hazel.vercel.app
- —DeFi Shield has 69 paid API endpoints across 11 categories, paid via USDC on Base using x402https://defi-shield-hazel.vercel.app
- —Each endpoint supports free GET discovery with llm_usage_prompt and paid POST with x402 payment headerhttps://defi-shield-hazel.vercel.app
- —Payment settles only on successful responsehttps://defi-shield-hazel.vercel.app