{"uid":"cap_YGMmu9K7vQtWtqul6OS0J","slug":"jarvisclaw-surf-token-holders-lookup-920e06d1","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://uat.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.00825","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.00825/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_Xz_Op9_RSDsQ_vauJT-EN","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 token holders for a specified token on the Surf platform via the JarvisClaw AI API Gateway.","exampleAgentPrompt":"Can you look up who holds the token with address 0xABC123 on Surf and give me the list of wallet holders?","exampleUseCases":[{"title":"Token holder distribution analysis","prompt":"I need to see who's holding the SURF token right now — can you pull the full list of token holders and their balances for contract address 0xSURF123?"},{"title":"Whale wallet identification","prompt":"Find me the top holders for the token at address 0xDEADBEEF on Surf so I can identify any whale wallets holding large positions."},{"title":"Community size verification","prompt":"How many unique wallets are currently holding the token 0xTOKEN456 on Surf? I want to verify the size of the holder base before investing."}],"resultDescription":"Returns a list of token holders for the specified token, including wallet addresses, token balances held, and potentially aggregate holder statistics such as total holder count and distribution data.","failureModes":["Invalid or unrecognized token identifier returns empty or error response","Token not listed on Surf platform results in not-found error","Malformed query parameter causes 400 bad request","Payment failure via x402 protocol results in 402 Payment Required","Rate limiting or quota exhaustion returns 429 error","UAT environment instability may cause intermittent 500 errors"],"whenToPreferThis":"Choose this endpoint when you need on-chain token holder data specifically from the Surf platform, paid per-call via x402 USDC micropayments on Base or Solana. Prefer this over generic blockchain explorers when you want a simple API call with pay-per-use pricing and no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:47:53.458Z","isFirstParty":false}