# AgenticFi Token Metadata API

> AgenticFi Token Metadata API is a paid API for AI agents from defi-api.agenticfi.wtf, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Retrieves token metadata including name, symbol, decimals, logo, supported chains, and links for a given CoinGecko token ID

## Facts

- Endpoint: GET https://defi-api.agenticfi.wtf/api/token/metadata/ethereum
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticfi-token-metadata-api-7e37fe23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e0V9rJuVlY7IEgWvMKFtL

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 agenticfi-token-metadata-api-7e37fe23
```

Example prompt: What's the full token metadata for Uniswap — give me its symbol, decimals, logo, and which chains it's on, using its CoinGecko ID 'uniswap'.

## When to prefer this

Use this endpoint when you need comprehensive token metadata (name, symbol, decimals, logo, chains, links) for a specific cryptocurrency identified by its CoinGecko ID. Prefer this over price endpoints when you need structural token info rather than market data, and over generic blockchain explorers when you need cross-chain metadata in a single call.

## Known failure modes

- Invalid or unknown CoinGecko token ID returns 404 or empty result
- Misspelled token ID (e.g. 'etherum' instead of 'ethereum') returns no data
- Token not indexed by CoinGecko returns an error
- Payment failure (402) if x402 payment not properly attached
- Rate limiting or service unavailability returns 5xx error

## How this service works

Token metadata - name, symbol, decimals, logo, chains, links

## Output

Returns structured token metadata including the token's official name, ticker symbol, decimal precision, logo image URL, list of supported blockchain networks, and external links (website, social, explorer) sourced from CoinGecko.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "id": "ethereum"
  },
  "queryParams": {
   "id": "ethereum"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "pathParams",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "title": "id (required)",
       "description": "Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "title": "id (required)",
       "description": "Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenticfi-token-metadata-api-7e37fe23/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-api.agenticfi.wtf](https://www.zero.xyz/host/defi-api.agenticfi.wtf/llms.txt)