# DeFi Shield Token List

> DeFi Shield Token List is a paid API for AI agents from defi-shield-hazel.vercel.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Retrieve detailed token metadata including name, symbol, decimals, price, and market data for DeFi tokens

## Facts

- Endpoint: POST https://defi-shield-hazel.vercel.app/api/data/token-list
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defi-shield-hazel-vercel-app-3837b42f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rnVlqlsa8hkNUQSBI0Axb

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability defi-shield-hazel-vercel-app-3837b42f -d '<json body>'
```

Example prompt: Can you look up the token details for USDC on Ethereum — I need the name, symbol, decimals, current price, and market cap?

## When to prefer this

Use this endpoint when you need structured token metadata (name, symbol, decimals, price, market data) for one or more DeFi tokens, especially when building DeFi tooling, swap calculators, or portfolio trackers that require on-chain token context. Prefer over generic crypto price APIs when you need decimals and full market context together in one call.

## Known failure modes

- Token address not found — returns empty result or 404
- Unsupported chain ID — endpoint may return error or empty list
- Invalid token identifier format — returns validation error
- Network or provider timeout — returns 5xx error
- Payment not processed — returns 402 payment required

## Output

Returns a list of token records including token name, symbol, decimal places, current price, and market data such as market cap and liquidity for the requested tokens.

## Example request

```json
{
 "input": {
  "body": {
   "symbol": "USDC"
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "properties": {
      "symbol": {
       "type": "string",
       "description": "Token symbol (alternative to address)"
      },
      "address": {
       "type": "string",
       "description": "Token contract address"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defi-shield-hazel-vercel-app-3837b42f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-shield-hazel.vercel.app](https://www.zero.xyz/host/defi-shield-hazel.vercel.app/llms.txt)