{"uid":"cap_e3uOjaY9opVJU6_7MRXVZ","slug":"pulsescanner-token-richlist-03251f16","name":"PulseScanner Token Richlist","description":"The largest holders of one token, ranked by balance. PulseChain (chain id 369). $0.007 USDC per call.","url":"https://x402.pulsescanner.io/v2/tokens/:addr/richlist?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"pathParams":{"type":"object","required":["addr"],"properties":{"addr":{"type":"string"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"string"},"cursor":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","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.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ECEJU96GK8LSotEMJDkXC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the largest holders of a given PulseChain token, ranked by balance descending.","exampleAgentPrompt":"Show me the top 50 largest holders of the token at address 0xA1077a294dDE1B09bB078844df40758a5D0f9a27 on PulseChain, sorted by balance.","exampleUseCases":[{"title":"Whale concentration analysis for a new token","prompt":"I'm looking at a new PulseChain token at address 0x2b591e99afE9f32eAA6214f7B7629768c40Eeb39 — can you pull the top 20 holders and tell me how concentrated the supply is among whales?"},{"title":"Monitoring insider wallets before investing","prompt":"Before I buy into this PulseChain project, can you get the richlist for token 0x95B303987A60C71504D99Aa1b13B4DA07b0790ab and show me the top 10 addresses holding the most tokens?"},{"title":"Paginating through all major holders for a report","prompt":"I need to compile a full list of the largest holders of the HEX token on PulseChain — start with the top 100 and then give me the next page after that using the cursor."}],"resultDescription":"Returns a paginated list of wallet addresses holding the specified PulseChain token, ranked from largest to smallest balance, along with each holder's token balance and a cursor for fetching additional pages.","failureModes":["Invalid or non-existent token contract address returns empty list or 404","Malformed address (not a valid checksummed ERC-20 address) results in a 400 error","Token exists on a different chain (not PulseChain chain id 369) returns no data","Payment not attached results in 402 Payment Required","Exceeding API rate limits or invalid cursor returns an error","Token with no holders or newly deployed contract may return an empty richlist"],"whenToPreferThis":"Use this endpoint when you need to identify the top holders of a specific token on PulseChain (chain id 369) ranked by balance — ideal for whale analysis, supply concentration checks, insider wallet identification, or on-chain governance research. Prefer this over generic blockchain explorers when you need structured, paginated richlist data via a simple API call with micropayment access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:41:17.769Z","isFirstParty":false,"canonicalSlug":"pulsescanner-token-richlist-03251f16"}