# DopamineDesk Token Metadata Bulk Lookup

> DopamineDesk Token Metadata Bulk Lookup is a paid API for AI agents from ai-data-marketplace-1042299154756.us-central1.run.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Fetches metadata (name, symbol, logo, decimals) for multiple ERC-20/token contract addresses in a single call on a specified blockchain network.

## Facts

- Endpoint: GET https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/token_metadata_bulk
- 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/dopaminedesk-token-metadata-bulk-lookup-16344ce6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7mE98w_ekI-WeWcGp2EId

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 dopaminedesk-token-metadata-bulk-lookup-16344ce6
```

Example prompt: Look up the token metadata — name, symbol, logo, and decimals — for these Ethereum contract addresses: 0xabc123..., 0xdef456..., and 0x789xyz... all at once.

## When to prefer this

Use this endpoint when you need to resolve multiple token contract addresses to human-readable metadata in a single API call, especially in DeFi, portfolio, or security workflows on Ethereum or other supported chains. It is more cost-efficient than making individual token metadata lookups when processing lists of 2+ contracts.

## Known failure modes

- Invalid or non-existent contract address returns missing or null fields for that entry
- Unsupported blockchain network returns an error or empty results
- Malformed address array causes a 400 bad request
- Network or upstream data source downtime returns 503 or timeout
- Payment failure via x402 returns 402 Payment Required

## How this service works

Read ERC-20 symbol, name, decimals, and raw total supply for up to ten contract addresses using live eth_call requests.

## Output

Returns an array of token metadata objects, each containing the token's logo URL, full name, ticker symbol, contract address, and decimal precision for the requested contracts on the specified chain.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "addresses"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network (default: ethereum)."
      },
      "addresses": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Array of contract addresses."
      }
     },
     "additionalProperties": true
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "success",
      "source",
      "fetched_at",
      "network",
      "count",
      "tokens",
      "marketplace_metadata"
     ],
     "properties": {
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "tokens": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "address",
         "symbol",
         "name",
         "decimals",
         "total_supply_raw"
        ],
        "properties": {
         "name": {
          "type": "string"
         },
         "symbol": {
          "type": "string"
         },
         "address": {
          "type": "string"
         },
         "decimals": {
          "type": "string"
         },
         "total_supply_raw": {
          "type": "string"
         }
        },
        "additionalProperties": true
       }
      },
      "network": {
       "type": "string"
      },
      "success": {
       "type": "boolean"
      },
      "fetched_at": {
       "type": "string"
      },
      "marketplace_metadata": {
       "type": "object",
       "required": [
        "data_mode",
        "billable",
        "availability",
        "source"
       ],
       "properties": {
        "source": {
         "type": "string"
        },
        "billable": {
         "type": "boolean"
        },
        "data_mode": {
         "type": "string"
        },
        "availability": {
         "type": "st
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 2,
  "source": "ethereum public JSON-RPC",
  "tokens": [
   "[nested detail omitted from the challenge header; see the full example in /openapi.json]"
  ],
  "network": "ethereum",
  "success": true,
  "fetched_at": "2026-08-07T07:32:33.479Z",
  "marketplace_metadata": {
   "source": "public EVM JSON-RPC",
   "billable": true,
   "data_mode": "live_source",
   "availability": "operational"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dopaminedesk-token-metadata-bulk-lookup-16344ce6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ai-data-marketplace-1042299154756.us-central1.run.app](https://www.zero.xyz/host/ai-data-marketplace-1042299154756.us-central1.run.app/llms.txt)