{"uid":"cap__9KVs26f63wTn2xFJMz9c","slug":"blockrun-ai-e6795e31","name":"BlockRun.AI Polymarket Wallet Filter","description":"Filter wallets by market trades with AND/OR logic","url":"https://blockrun.ai/api/v1/pm/polymarket/wallets/filter","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0085","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kbitrVct6I_Tv109GkEJk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0085","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Filter Polymarket wallets by market trading activity using combinable AND/OR logic conditions","exampleAgentPrompt":"Show me all Polymarket wallets that traded on both the US election market AND the crypto price market — use AND logic to filter only wallets that participated in all of those markets.","exampleUseCases":null,"resultDescription":"A filtered list of Polymarket wallet addresses that match the specified trade-based filter conditions, potentially including wallet metadata and trade context for each matching wallet.","failureModes":["Invalid or malformed filter logic returns 400 error","No wallets match the given criteria — empty result set returned","Unknown market IDs in filter conditions cause query failure","Payment not received or insufficient USDC triggers 402 response","Rate limiting on high-volume filter queries"],"whenToPreferThis":"Use this endpoint when you need to segment or identify Polymarket wallets based on their trading history across specific markets, especially when combining multiple conditions with boolean AND/OR logic. Prefer this over raw wallet lookups when building trader cohorts, doing competitive analysis, or finding wallets that share specific market participation patterns.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T13:06:50.618Z","isFirstParty":false}