Token info lookup from CoinGecko via x402-paid API on Base (USDC), $0.05 per call.
What it does
The `/api/data/token-list` endpoint is part of DeFi Shield, a suite of 69 paid API endpoints providing security intelligence and data infrastructure for autonomous AI agents. This specific endpoint returns token information sourced from CoinGecko. It accepts POST requests and charges $0.05 per call, settled in USDC on Base via the x402 payment protocol.
DeFi Shield covers 11 categories including DeFi intelligence, wallet profiling, MEV/trading analysis, NFT intelligence, cross-chain data, safety/compliance checks, and data infrastructure. The `/api/data/token-list` endpoint falls under the Data Infrastructure category, alongside related endpoints for ABI decoding, contract ABI fetching, address labeling, event log decoding, transaction tracing, and block data retrieval. Each endpoint supports free GET-based discovery (returning schema and usage prompts) and paid POST requests requiring an x402 payment header.
The platform advertises agent-to-agent discovery via `/.well-known/agent-card.json`, a health/pricing endpoint at `/api/health`, and analytics at `/api/analytics`. Payment settles only on successful response. The x402 challenge was confirmed live during probing (HTTP 402 returned on POST), though the challenge body was empty, which may indicate a minimal or non-standard x402 implementation. No OpenAPI schema or detailed docs page was found; the `/docs` path returns 404.
Capabilities
Use cases
- —Retrieving token metadata (name, symbol, market data) for portfolio dashboards or agent workflows
- —Enriching on-chain addresses with human-readable token information
- —Feeding token data into DeFi risk analysis or trading pipelines
- —Autonomous agents looking up token details before executing trades or assessments
Fit
Best for
- —AI agents needing on-demand token metadata without managing API keys to CoinGecko directly
- —Developers building DeFi tools that need quick token lookups paid per call
- —Autonomous workflows requiring x402-compatible, pay-per-request data endpoints
Not for
- —High-volume bulk token data ingestion (per-call pricing at $0.05 adds up)
- —Users who already have direct CoinGecko API access and don't need x402 settlement
- —Non-crypto use cases with no need for token metadata
Quick start
# Free discovery (schema + usage prompt)
curl https://defi-shield-hazel.vercel.app/api/data/token-list
# Paid request (requires x402 payment header)
curl -X POST https://defi-shield-hazel.vercel.app/api/data/token-list \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402-payment-token>" \
-d '{"symbol": "ETH"}'Example
Request
{
"symbol": "ETH"
}Endpoint
Quality
The endpoint is confirmed live (402 on POST), and the landing page provides pricing and a general description. However, the x402 challenge body was empty, no OpenAPI schema exists, /docs returns 404, and no response examples or detailed request schema are available. The request body shown is inferred from context, not documented.
Warnings
- —x402 challenge body was empty — may indicate non-standard or minimal x402 implementation
- —No OpenAPI or detailed API documentation found (/docs returns 404)
- —Request and response schemas are not documented; example_request_json is inferred
- —Exact CoinGecko data fields returned are unknown
Citations
- —DeFi Shield offers 69 paid API endpoints for security intelligence, paid via USDC on Base with x402https://defi-shield-hazel.vercel.app
- —/api/data/token-list provides token info from CoinGecko at $0.05 per callhttps://defi-shield-hazel.vercel.app
- —Free endpoint discovery is available via GET on each endpoint pathhttps://defi-shield-hazel.vercel.app
- —Agent discovery card available at /.well-known/agent-card.jsonhttps://defi-shield-hazel.vercel.app