{"uid":"cap_jmEG2P6MPclTokPXgRT8T","slug":"robinx-holder-structure-diff-8b19a7e5","name":"RobinX Holder Structure Diff","description":"Labeled holder-structure diff: who froze/added/trimmed/exited, with insider/deployer/identity labels","url":"https://api.robinx.io/structure/:token","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","properties":{"queryParams":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"token contract address 0x…"}}}}},"output":{"type":"object","properties":{"example":{"data":{"cohorts":{"added":5,"exited":3,"frozen":12},"structure_verdict":{"signal":"rotation"}},"signal":"rotation"}}}}},"responseSchema":{"data":{"cohorts":{"added":5,"exited":3,"frozen":12},"structure_verdict":{"signal":"rotation"}},"signal":"rotation"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h1kCI3afYC1cTukR918SH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a labeled diff of token holder cohorts showing who froze, added, trimmed, or exited positions, with insider/deployer/identity classification per cohort.","exampleAgentPrompt":"Pull the holder structure diff for token 0x4f3a...c8d2 and tell me whether insiders or deployers are rotating out — I want to see the cohort breakdown of who froze, added, trimmed, or exited.","exampleUseCases":[{"title":"Pre-trade insider exit check","prompt":"Before I ape into this token at 0x7b2e...a391, can you check if deployers or insiders are quietly exiting their positions? Give me the holder cohort diff."},{"title":"Rotation signal monitoring for risk management","prompt":"I'm holding 0xc4f1...9e22 — run a holder structure diff and tell me if the verdict signal is showing rotation or accumulation right now."},{"title":"Comparing frozen vs exiting whales","prompt":"For token contract 0x1a9d...f047, how many wallets have frozen their position vs fully exited? Are any of them labeled as insiders or deployers?"}],"resultDescription":"Returns a JSON object with cohort counts (how many wallets added, exited, or froze positions since last snapshot), a structure_verdict with a signal string (e.g. 'rotation'), and top-level signal label — all enriched with insider, deployer, and identity classifications per cohort.","failureModes":["Invalid or non-existent token contract address returns an error or empty cohorts","Token not tracked on Robinhood Chain (chain 4663) may return no data","Rate limiting or payment failure (x402) if USDC payment is not processed","Stale snapshot if no recent holder data has been indexed for the token","Malformed 0x address format causes request rejection"],"whenToPreferThis":"Use this endpoint when you need a structured, labeled breakdown of how token holder cohorts have shifted between snapshots — specifically when insider, deployer, or identity classification matters. It goes beyond raw holder counts by tagging known actors and providing a directional verdict (e.g. rotation), making it ideal for pre-trade due diligence or risk monitoring on Robinhood Chain tokens. Prefer sibling endpoints for raw on-chain stats, social sentiment, or individual wallet history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:50:39.668Z","isFirstParty":false}