{
  "$comment": "GENERATED FROM api/_tools/<slug>/route.mjs — do not edit by hand",
  "type": "https://eips.ethereum.org/EIPS/eip-8257#tool-manifest-v1",
  "name": "token-info",
  "description": "Raw ERC-20 token facts for any Base token. Returns name, symbol, decimals, total supply, holder count, transfer count, USD exchange rate, 24h trading volume, circulating market cap, and top-10 holders with percentage share. Powered by Blockscout. 5min cache. $0.02 USDC per call; AXIOM Tool Pass holders get free access.",
  "endpoint": "https://www.clawbots.org/api/tools/token-info",
  "image": "https://www.clawbots.org/tools/icons/token-info.png",
  "featuredImage": "https://www.clawbots.org/tools/featured/token-info.png",
  "inputs": {
    "type": "object",
    "properties": {
      "token": {
        "type": "string",
        "description": "ERC-20 contract address on Base (0x...)",
        "pattern": "^0x[a-fA-F0-9]{40}$"
      }
    },
    "required": [
      "token"
    ],
    "additionalProperties": false
  },
  "outputs": {
    "type": "object",
    "properties": {
      "token": {
        "type": "string",
        "description": "Normalized token address"
      },
      "chain": {
        "type": "string",
        "description": "Always 'base'"
      },
      "fetchedAt": {
        "type": "string",
        "format": "date-time"
      },
      "name": {
        "type": [
          "string",
          "null"
        ],
        "description": "Token name, or null"
      },
      "symbol": {
        "type": [
          "string",
          "null"
        ],
        "description": "Token symbol, or null"
      },
      "decimals": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Decimal precision"
      },
      "type": {
        "type": "string",
        "description": "Token standard (ERC-20 / ERC-721 / ERC-1155)"
      },
      "totalSupply": {
        "type": [
          "string",
          "null"
        ],
        "description": "Raw total supply in smallest units"
      },
      "holderCount": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Number of distinct holders"
      },
      "transferCount": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Lifetime transfer event count"
      },
      "priceUsd": {
        "type": [
          "number",
          "null"
        ],
        "description": "USD exchange rate from Blockscout, or null"
      },
      "volume24hUsd": {
        "type": [
          "number",
          "null"
        ],
        "description": "24h trading volume in USD, or null"
      },
      "circulatingMarketCapUsd": {
        "type": [
          "number",
          "null"
        ],
        "description": "Circulating market cap in USD, or null"
      },
      "topHolders": {
        "type": "array",
        "description": "Top-10 holders by balance",
        "items": {
          "type": "object",
          "properties": {
            "address": {
              "type": [
                "string",
                "null"
              ],
              "description": "Holder wallet address"
            },
            "ens": {
              "type": [
                "string",
                "null"
              ],
              "description": "ENS/Basenames name, or null"
            },
            "rawBalance": {
              "type": "string",
              "description": "Raw token balance in smallest units"
            },
            "share": {
              "type": [
                "number",
                "null"
              ],
              "description": "Percentage of total supply (0–100)"
            }
          }
        }
      }
    },
    "required": [
      "token",
      "chain",
      "fetchedAt",
      "name",
      "symbol",
      "decimals",
      "type",
      "totalSupply",
      "holderCount",
      "transferCount",
      "priceUsd",
      "volume24hUsd",
      "circulatingMarketCapUsd",
      "topHolders"
    ]
  },
  "creatorAddress": "0xef2cc7d15d3421629f93ffa39727f14179f31c75",
  "tags": [
    "token",
    "erc20",
    "base",
    "metadata",
    "holders",
    "supply",
    "price"
  ],
  "pricing": [
    {
      "amount": "0.02",
      "asset": "USDC",
      "recipient": "0xef2cc7d15d3421629f93ffa39727f14179f31c75",
      "protocol": "x402"
    }
  ],
  "authentication": [
    {
      "type": "siwe",
      "description": "Sign In With Ethereum. Holders of the Axiom Tool Pass NFT get free unlimited access. Sign a SIWE message proving wallet ownership; the server verifies your wallet holds the pass on-chain.",
      "header": "Authorization: SIWE <base64url(message)>.<0xsignature>",
      "passContract": "0xfc9ce3990f85fA1A3a0eE51a710642396a6Cad82",
      "chain": "base",
      "chainId": 8453,
      "collection": "https://opensea.io/collection/axiom-tool-pass"
    },
    {
      "type": "x402",
      "description": "Pay per call in USDC on Base via the x402 protocol. No account or API key needed.",
      "header": "x-payment: <x402 authorization>"
    }
  ],
  "onChain": {
    "registry": "0x265BB2DBFC0A8165C9A1941Eb1372F349baD2cf1",
    "chainId": 8453,
    "toolId": 104
  }
}