{"uid":"cap_RXMXjgT3rW2KiKaa2OJH1","slug":"x-twitter-handle-to-contract-address-matcher-fe532f66","name":"X/Twitter Handle to Contract Address Matcher","description":"Best-effort X/Twitter ↔ contract-address match via twiscan public mirror. Returns MATCH|PARTIAL|NO_MATCH|UNKNOWN (honest UNKNOWN if scrape unavailable). Query handle= (required) & optional ca=. ~$0.01.","url":"https://x402.isthisarug.trade/x-ca?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"},"queryParams":{"type":"object","required":["handle"],"properties":{"ca":{"type":"string","description":"Token contract address (0x + 40 hex) to match against X timeline."},"handle":{"type":"string","description":"X/Twitter handle (with or without @)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7554BKG1L78b0pUeWA0Wu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Matches an X/Twitter handle to a token contract address by scraping the X timeline via twiscan, returning MATCH, PARTIAL, NO_MATCH, or UNKNOWN.","exampleAgentPrompt":"Can you check if the Twitter handle @RugCoinOfficial actually matches the contract address 0xabc123def456abc123def456abc123def456abc1 — I want to know if it's a MATCH, PARTIAL, or NO_MATCH before I buy in.","exampleUseCases":[{"title":"Pre-buy token social verification","prompt":"Before I ape into this token, check if the Twitter account @MoonShibaInu matches the contract address 0xd3ad8eef1234567890abcdef1234567890abcdef — tell me if it's a real match or not."},{"title":"Scam detection for unknown token","prompt":"Someone shared a contract address 0x1234567890abcdef1234567890abcdef12345678 and claimed it belongs to @CryptoGemOfficial on Twitter — can you verify if that X handle actually matches that contract?"},{"title":"Due diligence on promoted token","prompt":"I'm researching this token that's being promoted by @BasedPepeCoin — look up whether their Twitter handle is linked to the contract 0xfeedbeef1234abcd5678efab9012cdef34567890 and give me the match result."}],"resultDescription":"Returns one of four string values: MATCH (strong positive correlation found between the handle's timeline and the contract address), PARTIAL (some association found but not conclusive), NO_MATCH (no association detected), or UNKNOWN (scrape was unavailable and result cannot be determined). The response is a best-effort determination based on publicly available X timeline data via the twiscan mirror.","failureModes":["UNKNOWN returned when twiscan scrape is unavailable or rate-limited","handle not found or suspended X account returns UNKNOWN","invalid contract address format may result in error or UNKNOWN","rate limiting or scrape failures at the twiscan mirror layer cause UNKNOWN responses","payment failure (non-402-compliant client) will block the call entirely"],"whenToPreferThis":"Use this endpoint when you need a quick, low-cost (~$0.01) social signal cross-check between an X/Twitter handle and a token contract address as part of a token diligence workflow. It is ideal for agents that need to verify whether a crypto project's Twitter account is actually associated with the contract address being promoted, helping detect impersonators or mismatched promotional accounts. Prefer this over manual timeline scraping when you want a structured MATCH/PARTIAL/NO_MATCH/UNKNOWN signal without building your own scraper. It pairs naturally with the sibling endpoints on the same host for full LP, ERC20, and risk gate checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:34:32.655Z","isFirstParty":false,"canonicalSlug":"x-twitter-handle-to-contract-address-matcher-fe532f66"}