{"uid":"cap_i7-2Ky9yEMov5xeEDDlpI","slug":"openintel-find-candidate-wallets-for-token-balances-872ea6da","name":"OpenIntel Find Candidate Wallets for Token Balances","description":"Pay-per-call proxy for the OpenIntel API.","url":"https://api.openintel.agency/api/v1/find_candidate_wallets_for_token_balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","minLength":1},"limit":{"type":"integer","maximum":200,"minimum":1},"observations":{"type":"array","items":{"type":"object","properties":{"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"wallet_address":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_balance_amount":{"anyOf":[{"type":"string"},{"type":"null"}]},"partial_wallet_address":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"minItems":1},"observation_time":{"anyOf":[{"type":"string"},{"type":"null"}]}}},"responseSchema":{"type":"json","example":{"meta":{"as_of":"2026-05-23T00:00:00Z","cache_age_seconds":0},"results":[{"as_of":"2026-05-23T00:00:00Z","score":1,"k_of_n":{"k":2,"n":2},"address":"0xabcdef0123456789abcdef0123456789abcdef01","matched_pass":1,"matching_balances":[{"balance":1234.5,"token_address":"0x22aF33FE49fD1Fa80c7149773dDe5890D3c76F3b"},{"balance":2.1,"token_address":"0x4200000000000000000000000000000000000006"}]}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-tkHmY84kJ0wEVGmAUdFk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Given a set of token balance criteria, returns candidate blockchain wallet addresses that likely hold those token balances, scored by match quality.","exampleAgentPrompt":"I need to find candidate wallet addresses that hold at least 1234.5 of token 0x22aF33FE49fD1Fa80c7149773dDe5890D3c76F3b and 2.1 of token 0x4200000000000000000000000000000000000006 — can you search OpenIntel for wallets matching both of those balances?","exampleUseCases":[{"title":"Identify whale wallets for airdrop campaigns","prompt":"Can you find me blockchain wallet addresses that hold at least 10 ETH and 500 USDC? I want to target high-value users for our upcoming token airdrop and need OpenIntel to surface wallets matching both those criteria."},{"title":"Discover potential investors holding specific tokens","prompt":"I'm looking for wallet addresses that have at least 5 of token 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 or 100 of token 0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72 — can you search for addresses that hold either of those token balances?"},{"title":"Find liquidity providers for token pairs","prompt":"We need to identify which wallet addresses are holding both 1000 DAI and 1 WETH as potential liquidity providers for our new market. Can you query OpenIntel for addresses matching those specific token balance requirements?"}],"resultDescription":"Returns a list of candidate wallet addresses, each with a relevance score (0–1), k-of-n match details indicating how many of the specified token criteria were satisfied, the specific matching token balances found, and a timestamp indicating data freshness.","failureModes":["No matching wallets found for the given criteria — empty results array","Invalid token address format causes a 400 bad request","Insufficient USDC balance for the $0.05 per-call fee results in payment failure","Rate limiting or upstream OpenIntel API unavailability causes 5xx errors","Stale cache data may cause slightly outdated balance information (cache_age_seconds > 0)"],"whenToPreferThis":"Use this endpoint when you need to discover which blockchain wallet addresses hold specific token balances, especially when matching against multiple tokens using k-of-n logic. Prefer this over generic blockchain explorers when you need scored, ranked candidate wallets rather than exact lookups. Ideal for on-chain intelligence tasks like identifying holders of a specific token portfolio.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:34:24.448Z","isFirstParty":false}