{"uid":"cap_0Di8HyfmR6sG6ShWS7xYB","slug":"xspy-twitter-username-history-79c38a6d","name":"xspy Twitter Username History","description":"Real-time KOL intelligence, smart follower graphs, and on-chain token signals from tweets. Pay only for the calls you make in USDC on Base or Solana. Agent-ready, no API keys required.","url":"https://xspy.pro/api/v1/pro/twitter/%7Busername%7D/username-history","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":200,"data":{"history":[{"username":"oldhandle","changedAt":"2025-01-01T00:00:00.000Z"}]},"status":true,"message":"success"}},"example":null,"exampleRequest":null,"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_Ek62FiWG6rC64M80MAKr2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the historical Twitter/X handle changes for a given account, including all previous usernames and the timestamps when each change occurred.","exampleAgentPrompt":"Can you pull up the full username history for the Twitter account @elonmusk — I want to see every handle they've ever used and when each change happened.","exampleUseCases":null,"resultDescription":"A JSON object containing a list of historical usernames for the specified account, each with the old handle string and the ISO 8601 timestamp of when the change occurred. Returns HTTP 200 with status true and a data.history array on success.","failureModes":["Username not found or account does not exist — likely returns empty history array or 404-style error","Account with no username changes returns an empty history array","Invalid or malformed username in path parameter — may return error response","Payment failure via x402 protocol — endpoint returns 402 Payment Required if USDC payment not completed","Rate limiting or service unavailability — returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to audit or verify the identity continuity of a Twitter/X account over time — for example, to detect rebrandings, investigate whether a KOL previously operated under a different name, or correlate on-chain activity with historical Twitter handles. Prefer this over manual Twitter profile checks since it provides structured, timestamped history not surfaced in the Twitter UI.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T06:30:23.713Z","isFirstParty":false}