{"uid":"cap_1ku_9EE5-cMhz0ASDkJ7a","slug":"fomoscan-user-lookup-by-handle-ddbc493e","name":"FomoScan User Lookup by Handle","description":"Resolve a FOMO trader by public handle (the @name on FOMO, without @). Use when you have a handle and not a stored user id. Returns id, handle, name, bio, and verified solanaAddress/evmAddress. Persist id — handles can change. Do not pass a wallet or numeric id.","url":"https://www.fomoscan.dev/v2/user/handle/OfficeWorker","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","properties":{}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_Sx2KqfmPyamBzCBCg13tH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a FOMO trader's profile by their public @handle, returning stable user ID, name, bio, and verified blockchain addresses.","exampleAgentPrompt":"Can you look up the FOMO trader with handle OfficeWorker and get me their stable user ID, bio, and verified wallet addresses?","exampleUseCases":[{"title":"Resolve handle before posting thesis","prompt":"I want to reference the FOMO trader CryptoSam in my analysis — can you look up their handle on FomoScan and grab their stable user ID and verified wallet so I have the right data to link them?"},{"title":"Find wallet address from social handle","prompt":"Someone on Twitter mentioned the FOMO trader @MoonHunter — can you pull their profile from FomoScan and tell me their verified Solana and EVM addresses?"},{"title":"Persist stable ID after handle discovery","prompt":"I only know this FOMO trader by their handle DegenKing — can you resolve it on FomoScan and give me their stable user ID so I can track them going forward even if they change their handle?"}],"resultDescription":"Returns a JSON object containing the trader's stable numeric user ID, current handle, display name, bio text, and their verified solanaAddress and evmAddress (either may be null if not linked). The stable ID should be persisted for future lookups since handles can change.","failureModes":["Handle not found — returns 404 if the @handle does not exist on FOMO","Incorrect input type — passing a wallet address or numeric ID instead of a plain handle will fail; only bare handles (no @) are accepted","Payment failure — the x402 payment of $0.1 USDC must succeed or the request is rejected","Handle changed — the resolved handle may differ from what was searched if the user recently renamed; always persist the returned ID"],"whenToPreferThis":"Use this endpoint when you have a FOMO trader's public @handle (without the @ symbol) and need to resolve it to a stable user ID or verified blockchain addresses. Prefer the handle-based endpoint over wallet or ID lookups when you only have a social username. Once you have the stable user ID from this call, switch to the ID-based endpoint for all subsequent lookups to avoid stale handle issues.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:33:52.371Z","isFirstParty":false}