{"uid":"cap_VQMZhBn-HSSjppS_SNkaY","slug":"speraxos-token-holders-api-aa04215d","name":"SperaxOS Token Holders API","description":"AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.","url":"https://chat.sperax.io/api/x402/v1/data/token-holders?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"anyOf":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_qFwkjJ6lFyqCJV6AKFcHo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of token holders for a given DeFi token, payable per-request via x402/USDC on Base","exampleAgentPrompt":"Show me the current token holders for the USDC contract on Base — I want to see who the top wallets are and how concentrated the ownership is.","exampleUseCases":[{"title":"Whale concentration check for new token","prompt":"Look up the token holders for this contract address on Base and tell me if ownership is concentrated among a few whales or spread across many wallets."},{"title":"Due diligence before investing in DeFi project","prompt":"Before I put money into this DeFi project, can you pull the holder list for their token and show me how many unique addresses hold it and what the top 10 holders each own?"},{"title":"Monitor holder growth for a portfolio token","prompt":"Fetch the current holder count and top holder breakdown for this token address so I can track how the community has grown since last month."}],"resultDescription":"Returns a list of wallet addresses holding the specified token, along with their balances and share of total supply, enabling analysis of holder count, distribution, and whale concentration.","failureModes":["Invalid or unrecognized token contract address returns an error or empty result","Payment not included or insufficient USDC via x402 returns a 402 Payment Required response","Token exists on a different chain than expected, resulting in no holders found","Rate limiting or upstream data unavailability may return a timeout or 503 error","Malformed request parameters return a 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need on-chain token holder data for a specific DeFi token on Base without managing API keys — ideal for agents that can pay per-request in USDC via x402. Prefer this over general blockchain explorers when you need structured, AI-ready holder data integrated into a DeFi intelligence workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T00:52:40.540Z","isFirstParty":false,"canonicalSlug":"speraxos-token-holders-api-aa04215d"}