# X Data Gateway — Token Metadata Lookup (Base)

> X Data Gateway — Token Metadata Lookup (Base) is a paid API for AI agents from x-data-gateway.annushka1190.workers.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Fetches on-chain metadata for a Base network token contract address, including name, symbol, decimals, and related market data.

## Facts

- Endpoint: GET https://x-data-gateway.annushka1190.workers.dev/v1/token/meta
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-data-gateway-token-metadata-lookup-base-2b1c656b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cUrhfakhEbArb5lCblQwb

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 x-data-gateway-token-metadata-lookup-base-2b1c656b
```

Example prompt: Can you look up the token metadata for the Base contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to know the name, symbol, and decimals?

## When to prefer this

Use this endpoint when you need to identify or enrich a specific Base network ERC-20 token by its contract address, especially when you want name, symbol, and decimals without needing full market pricing data. Prefer this over spot price endpoints when the primary goal is token identification rather than pricing.

## Known failure modes

- Invalid or malformed contract address returns an error
- Contract address not found on Base network returns empty or error response
- Non-Base chain addresses may return no results
- Network or upstream provider outage causes timeout
- Missing required 'address' query parameter returns validation error

## How this service works

Metadata for a token contract (prefers Base). name/symbol/priceUsd always refer to the *requested* address — not the other side of a DEX pair. Stables fall back to registry if Dex is rate-limited. e.g. GET /v1/token/meta?address=0x8335...USDC

## Output

Returns a JSON object with token metadata for the given Base contract address, including fields such as token name, symbol, decimals, and potentially additional on-chain or market-related attributes. Response is wrapped in a 'data' key.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Token contract 0x..."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-data-gateway-token-metadata-lookup-base-2b1c656b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x-data-gateway.annushka1190.workers.dev](https://www.zero.xyz/host/x-data-gateway.annushka1190.workers.dev/llms.txt)