# AgenticFi Token Metadata by CoinGecko ID

> AgenticFi Token Metadata by CoinGecko ID 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-13).

Returns metadata for a cryptocurrency token given its CoinGecko ID, including name, symbol, logo, website, Twitter, decimals, and supported chains.

## Facts

- Endpoint: GET https://defi-api.agenticfi.wtf/api/token/metadata/%7Bid%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticfi-token-metadata-by-coingecko-id-21f870a8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TlXcYu9YxJ1sT87IfVIrD

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-by-coingecko-id-21f870a8
```

Example prompt: Can you pull up the token metadata for 'uniswap' from the CoinGecko registry — I need the symbol, logo, decimals, website, Twitter, and which chains it's on.

## When to prefer this

Use this endpoint when you need structured token metadata (logo, socials, decimals, chains) keyed by CoinGecko ID and are operating in an agentic DeFi context on Base with x402 micropayment support. Prefer this over direct CoinGecko API calls when you want pay-per-call simplicity without managing API keys.

## Known failure modes

- Invalid or unknown CoinGecko ID returns an error or empty response
- Token exists on CoinGecko but has missing fields (e.g. no Twitter or website)
- Payment failure via x402 if USDC balance is insufficient
- Rate limiting or network timeout from upstream CoinGecko data source

## How this service works

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

## Output

A JSON object containing the token's logo URL, name, ticker symbol, array of supported chains, Twitter profile URL, official website URL, decimal precision, and CoinGecko ID.

## 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-by-coingecko-id-21f870a8/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)