# Token Supply & Market Data Lookup

> Token Supply & Market Data Lookup is a paid API for AI agents from store.agentexchange.work, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns total supply, holder count, price, market cap, and metadata for a given ERC-20 token contract address on a specified blockchain.

## Facts

- Endpoint: GET https://store.agentexchange.work/chain/supply
- 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/token-supply-market-data-lookup-d1495df3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dMo2PihiDfuDr3---bp0P

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 token-supply-market-data-lookup-d1495df3
```

Example prompt: What's the total supply, holder count, and current USD price for USDC at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Use this endpoint when you need on-chain token supply, holder count, price, and market cap data for a specific ERC-20 contract across major EVM chains (Ethereum, Base, Optimism, Arbitrum, Polygon, Gnosis) without requiring API key signup — paying only $0.001 USDC per call via x402.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty response
- Unsupported chain value causes a 400 or validation error
- Token exists on chain but has no indexed holder data, resulting in null holders field
- Network timeout or RPC unavailability causes a 500-level error
- Non-ERC-20 contract address may return malformed or incomplete data

## How this service works

Total supply, holder count, decimals, and live USD price / market cap for any ERC-20/721 token contract, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The supply read trading, valuation, and risk agents make to size circulating supply, dilution, and holder distribution before pricing or trading a token. Free upstream (Blockscout); one paid call instead of running your own RPC.

## Output

A JSON object containing the token's name, symbol, contract address, chain, total supply (in token units), number of holders, current USD price, market cap in USD, and decimal precision — sourced from on-chain reads.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "chain": "ethereum",
   "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
 }
}
```

## 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": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "base|ethereum|optimism|arbitrum|polygon|gnosis (default ethereum)"
      },
      "address": {
       "type": "string",
       "description": "Token contract address (0x...)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "holders": {
       "type": "number"
      },
      "usd_price": {
       "type": "number"
      },
      "total_supply": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-supply-market-data-lookup-d1495df3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from store.agentexchange.work](https://www.zero.xyz/host/store.agentexchange.work/llms.txt)