{"uid":"cap_kH8ODcRjWW7fBw1kWYVFL","slug":"jarvisclaw-surf-token-holders-lookup-ab5dd5ea","name":"JarvisClaw Surf Token Holders Lookup","description":"AI API Gateway with smart routing, pay per call via x402. OpenAI-compatible. Settled in USDC on Base & Solana.","url":"https://api.jarvisclaw.ai/v1/marketplace/surf/token/holders","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"query":{"type":"string","description":"Request parameters"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.045","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00825","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00825","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Pa3oP5BGGzyNWP3gza8VC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00825","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the list of holders for a specific token on the Surf platform via the JarvisClaw AI API Gateway","exampleAgentPrompt":"Can you pull up all the holders for the token at address 0xABC123 on Surf and show me the wallet addresses and their balances?","exampleUseCases":[{"title":"Monitor whale concentration for risk management","prompt":"I need to check who's holding the largest amounts of our token on Surf right now. Can you grab the full holder list and flag any addresses with unusually large balances?"},{"title":"Analyze token distribution for governance decisions","prompt":"Pull the holder data for our token on Surf and give me a breakdown of how many unique wallets own it and what the balance distribution looks like across the top holders."},{"title":"Identify community members for airdrop campaigns","prompt":"Can you fetch all the wallet addresses currently holding our token on Surf? I want to see the complete list so we can target them for our upcoming community rewards program."}],"resultDescription":"A list of wallet addresses holding the specified token on the Surf platform, along with associated balances or holdings data for each holder, potentially including total holder count and distribution metrics.","failureModes":["Invalid or non-existent token address returns 404 or empty result","Payment failure via x402 returns 402 Payment Required","Malformed request body returns 400 Bad Request","Token not found on Surf platform returns empty holders list","Network congestion or upstream data unavailability returns 503","Rate limiting or exceeded quota returns 429"],"whenToPreferThis":"Use this endpoint when you need to retrieve on-chain token holder data specifically from the Surf platform via the JarvisClaw gateway, and you want pay-per-call pricing settled in USDC without a subscription. Prefer this over other holder lookup services when you need micropayment-based access or are working within an x402-enabled agent workflow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:03:16.864Z","isFirstParty":false}