{
  "$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": "axiom-stakers-leaderboard",
  "description": "Top xAXIOM (StakedAxiom ERC-4626) holders ranked by share balance. Returns vault summary stats (total shares in circulation, total AXIOM staked, price-per-share) and a ranked leaderboard of up to 50 stakers with address, share balance, and percent of total supply. Sourced live from Blockscout token-holders API + Base RPC ERC-4626 reads. 60s cache. Requires $0.01 USDC per call (x402) or AXIOM Tool Pass.",
  "endpoint": "https://www.clawbots.org/api/tools/axiom-stakers-leaderboard",
  "inputs": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "description": "Number of top stakers to return (1-50, default 20)",
        "minimum": 1,
        "maximum": 50,
        "default": 20
      }
    },
    "additionalProperties": false
  },
  "outputs": {
    "type": "object",
    "properties": {
      "vault": {
        "type": "string",
        "description": "xAXIOM vault contract address on Base (StakedAxiom ERC-4626)"
      },
      "token": {
        "type": "string",
        "description": "Underlying AXIOM ERC-20 address"
      },
      "fetchedAt": {
        "type": "string",
        "format": "date-time"
      },
      "totalStakers": {
        "type": "integer",
        "description": "Number of unique stakers returned in this window"
      },
      "totalSupply": {
        "type": "string",
        "description": "Total xAXIOM shares in circulation (formatted, 18 decimals)"
      },
      "totalSupplyRaw": {
        "type": "string",
        "description": "Raw totalSupply in wei"
      },
      "totalAssets": {
        "type": "string",
        "description": "Total AXIOM deposited in the vault (formatted, 18 decimals)"
      },
      "totalAssetsRaw": {
        "type": "string"
      },
      "pricePerShare": {
        "type": "string",
        "description": "AXIOM redeemable per 1 xAXIOM share — convertToAssets(1e18) formatted"
      },
      "pricePerShareRaw": {
        "type": "string",
        "description": "Raw pricePerShare in AXIOM wei"
      },
      "leaderboard": {
        "type": "array",
        "description": "Stakers sorted descending by xAXIOM share balance",
        "items": {
          "type": "object",
          "properties": {
            "rank": {
              "type": "integer"
            },
            "address": {
              "type": "string",
              "description": "Staker wallet address"
            },
            "shares": {
              "type": "string",
              "description": "xAXIOM balance (formatted)"
            },
            "sharesRaw": {
              "type": "string",
              "description": "Raw xAXIOM balance in wei"
            },
            "percentOfTotal": {
              "type": "string",
              "description": "Percent of total xAXIOM supply held by this staker"
            }
          },
          "required": [
            "rank",
            "address",
            "shares",
            "sharesRaw",
            "percentOfTotal"
          ]
        }
      }
    },
    "required": [
      "vault",
      "token",
      "fetchedAt",
      "totalStakers",
      "totalSupply",
      "totalSupplyRaw",
      "totalAssets",
      "totalAssetsRaw",
      "pricePerShare",
      "pricePerShareRaw",
      "leaderboard"
    ]
  },
  "creatorAddress": "0xef2cc7d15d3421629f93ffa39727f14179f31c75",
  "tags": [
    "axiom",
    "base",
    "staking",
    "xaxiom",
    "leaderboard",
    "erc4626"
  ],
  "pricing": [
    {
      "amount": "0.01",
      "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": 17
  }
}