{"uid":"cap_V23CWxvsjA87Mx017Pjd5","slug":"api-hyperd-ai-b6e0b6bb","name":"HyperD Wallet Persona Classifier","description":"Retrieves a wallet’s persona profile from Hyperd AI.","url":"https://api.hyperd.ai/api/wallet/persona?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"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"enum":["base","ethereum","polygon","arbitrum","optimism","avalanche","bnb"],"type":"string"},"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}},"output":{"type":"object"}},"response":{"band":"low","chain":"ethereum","notes":[],"query":{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"scores":[{"label":"HODLer","score":0.2,"drivers":["low swap activity (0%)"]},{"label":"Compromised","score":0,"drivers":[]},{"label":"Inactive","score":0,"drivers":[]},{"label":"MEV-bot","score":0,"drivers":[]},{"label":"Trader","score":0,"drivers":[]},{"label":"Whale","score":0,"drivers":[]},{"label":"Smart-Money","score":0,"drivers":[]},{"label":"Airdrop-Farmer","score":0,"drivers":[]}],"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","signals":{"ageDays":48,"limited":false,"txCount7d":5,"ethBalance":5.690705707505023,"txCount30d":29,"uniqueDexes":0,"isSanctioned":false,"txCountTotal":5896,"failedTxRatio":0.04,"goPlusFlagged":false,"mevAssociation":false,"uniqueContracts":7,"swapToTotalRatio":0},"sources":["viem (RPC)","Etherscan v2","Chainalysis Sanctions Oracle","GoPlus address security"],"timestamp":"2026-06-19T04:34:08.500Z","confidence":0.2,"disclaimer":"Heuristic persona classification. Signals are derived from public on-chain activity. Not financial or compliance advice.","primaryPersona":"HODLer"}},"exampleRequest":{"chain":"ethereum","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Pkk2CVhMvfizq9fQbyYDG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies an on-chain wallet address into a behavioral persona (Trader, HODLer, MEV-bot, Whale, Smart-Money, Airdrop-Farmer, Compromised, or Inactive) with confidence score and supporting signals.","exampleAgentPrompt":"What kind of wallet is 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum — is it a trader, HODLer, whale, MEV bot, or something else, and how confident are you?","exampleUseCases":[{"title":"Screen counterparty before large trade","prompt":"Before I execute this large OTC swap with 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE, can you check what kind of wallet it is and whether there's any risk I should know about — like if it's an MEV bot or a compromised address?"},{"title":"Filter airdrop recipients for bots","prompt":"I'm about to distribute tokens to a list of wallets and I want to remove any airdrop farmers or bots before I send. Can you profile 0x1f9090aaE28b8a3dCeaDf281B0F12828e676c326 and tell me how likely it is to be a genuine holder versus someone just farming the drop?"},{"title":"Identify whale wallets in protocol","prompt":"We're analyzing governance participation in our DAO and I want to know if 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8 is a whale or smart money address — can you pull its on-chain persona and confidence score?"}],"resultDescription":"Returns the most likely persona label from a fixed enum (Trader, HODLer, MEV-bot, Whale, Smart-Money, Airdrop-Farmer, Compromised, Inactive), a confidence score, and supporting heuristic signals drawn from multi-source on-chain data.","failureModes":["Invalid or unrecognized wallet address returns error","Unsupported chain value returns validation error","Wallet with no on-chain history may return Inactive with low confidence","Payment failure (x402) if insufficient USDC balance","Rate limiting or upstream data source unavailability"],"whenToPreferThis":"Use this endpoint when you need a quick, heuristic behavioral label for a wallet address — especially useful before executing a trade, assessing counterparty risk, filtering airdrop recipients, or flagging bots. Prefer this over raw transaction analysis when you need a single summarized persona with confidence rather than raw data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:45:06.405Z","isFirstParty":false,"canonicalSlug":"api-hyperd-ai-b6e0b6bb"}