# SiteCheck Token Metadata

> SiteCheck Token Metadata is a paid API for AI agents from api.sitecheck-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-16).

Fetches on-chain token metadata (name, symbol, decimals, supply, logo, proxy) for ERC-20 tokens and Solana SPL tokens across 20+ chains

## Facts

- Endpoint: GET https://api.sitecheck-api.workers.dev/api/token/metadata?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-token-metadata-6bbdb711
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__9c7wR-sMd0KrbVm-FKb6

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 sitecheck-token-metadata-6bbdb711
```

Example prompt: What token is at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — give me its name, symbol, decimals, and total supply.

## When to prefer this

Use this endpoint when you need standardized on-chain token metadata (name, symbol, decimals, supply, logo) for a known contract address across EVM chains or Solana. It is especially useful for resolving an unknown address to a human-readable token identity, checking Uniswap list membership, or fetching decimals before executing a swap or displaying a balance. Prefer it over general blockchain explorers when you need a structured JSON response suitable for agent pipelines without scraping.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Unsupported chain name causes a validation error
- Unverified or non-standard token contracts may return incomplete metadata
- Solana mint addresses not found on-chain return null fields
- Network RPC timeouts may cause transient failures
- Token not listed on DexScreener returns null market data

## How this service works

Token facts read on chain: for an ERC-20 on 22 EVM chains the name, symbol, decimals, total supply and EIP-1967 proxy implementation; for a Solana SPL mint the decimals, supply, mint and freeze authority. Adds price and liquidity from the token's deepest DexScreener pool on that chain, its logo and websites, and whether the Uniswap default list carries it (EVM). Information only, not financial advice.

## Output

A JSON object containing the token's name, symbol, chain, contract address, decimals, total supply (raw and human-readable), logo URL, proxy implementation address (if applicable), whether it appears on the Uniswap default token list, DexScreener market data, the data sources used, and a timestamp of when the data was checked.

## 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": [
      "chain",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "solana, or an EVM chain: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, zksync, mantle, blast, celo, fantom, sonic, unichain, opbnb, zora, mode, metis, cronos"
      },
      "address": {
       "type": "string",
       "description": "Token contract address (0x...) or Solana mint address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "chain": "ethereum",
  "market": null,
  "source": "Ethereum Mainnet RPC (eth_call); DexScreener pools; Uniswap default token list (tokens.uniswap.org)",
  "symbol": "USDC",
  "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "logoUrl": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
  "decimals": 6,
  "websites": [],
  "checkedAt": "2026-10-15T18:25:21.197Z",
  "disclaimer": "Information only, not financial advice.",
  "totalSupply": 48061017627.46436,
  "totalSupplyRaw": "48061017627464348",
  "proxyImplementation": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
  "onUniswapDefaultList": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-token-metadata-6bbdb711/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.sitecheck-api.workers.dev](https://www.zero.xyz/host/api.sitecheck-api.workers.dev/llms.txt)