Returns every identity attached to a single address. Costs 1 match credit if the address resolves to an X handle or a Farcaster account, and nothing if it does not.For more than a handful of addresses use batch instead.
Path parameters
string
required
An address as 0x followed by 40 hex characters. Case-insensitive; returned
lowercased.
The record, or null when nothing is attached to the address.
Show properties
string
Lowercased address. Always present.
string
Primary ENS name.
object
handle, url, verified, self_declared where the handle rests only on text the wallet owner typed into their own record, and, once we have checked, reachable, reachability and reachability_checked_at. See the verified flags, which are narrower than they look, self-declared handles, and when a handle stops being true.also, an object with handle, url and source, is present only where a second X account is attested for the same wallet and both accounts are live. See a second X account.
object
username, url, followers, fid, and verified.
string
Lens handle.
string
GitHub username.
string[]
Evidence classes backing the record: onchain, farcaster, attested-social, manual, aggregated. See evidence classes.
object
Present only when the address is a known onchain agent. Carries is_agent, name, framework, type, token_symbol and verified.Absent where the address owner attested an identity that is not the agent’s own. A catalog entry is a third party’s claim about an address; an attestation is the owner’s, and the address a launch protocol files against an agent is frequently its creator’s rather than the agent’s. Absent means we decline to say, not that we checked and it is not an agent.
object
score from 0 to 100, and last_verified.
object
Show properties
string
The normalized address you asked for.
boolean
Whether any identities were attached.
string
When the record last changed. Present only when found is true.
boolean
Whether the record is past its freshness window. Present only when found
is true.
string | null
Present only when found is false. A timestamp means we checked and found
nothing; null means we have never seen this address.
All three of these are HTTP 200. A wallet with nothing attached is a
successful lookup with a negative answer, not an error.
A second X account
A wallet can have two X accounts attested for it: one through a Farcaster
verification, say, and a different one through a signed attestation made later.
When we have checked both and both still reach someone, there is no evidence
for preferring either, so the record keeps its handle and carries the other
as twitter.also.
source is the evidence class of
the attestation behind the second handle. The field is absent, not null, on
every other record. It never appears where the stored handle has stopped
reaching anyone: that record is corrected instead, and handle becomes the
account that still works.
Staleness headers
When a record is past its freshness window the response adds:
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"walletlink.social","description":"Resolve wallet addresses to the X and Farcaster accounts their owners published, and back again. Every match is labeled with the evidence behind it, attested or correlated, and every X handle carries a state saying whether it still reaches a person. Sold as one-time credit packs, metered only on matches, with a USDC rail that needs no account. Product overview at https://walletlink.social/llms.txt and full docs at https://docs.walletlink.social/llms-full.txt.","colors":{"primary":"#4131B0","light":"#8585FF","dark":"#36239A"},"api":{"openapi":"openapi.yaml"},"background":{"color":{"light":"#F6F6FA","dark":"#0A0A0C"}},"navbar":{"links":[{"href":"mailto:help@walletlink.social","label":"Support"}],"primary":{"type":"button","label":"Open app","href":"https://walletlink.social"}},"footer":{"socials":{"x":"https://x.com/walletlinkETH"}},"contextual":{"options":["download-spec"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"walletlink","hasAudioNarration":false,"actualSubdomain":"walletlink","customDomains":["docs.walletlink.social"],"gitSource":{"type":"github","owner":"starl3xx","repo":"wallet-to-social","deployBranch":"main","contentDirectory":"docs-site","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01dd2fd00c6c0f47fe5835","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":11},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Lookups","count":3},{"language":"default","tag":"Overview","count":3},{"language":"default","tag":"Concepts","count":3},{"language":"default","tag":"For agents","count":2},{"language":"default","tag":"Reverse lookups","count":2},{"language":"default","tag":"Account","count":2},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Jobs","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/wallet","slug":"/api-reference/wallet","pageMetadata":{"title":"Look up a wallet","description":"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.","api":"GET https://walletlink.social/api/v1/wallet/{address}","href":"/api-reference/wallet"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns every identity attached to a single address. Costs `,_jsx(_components.strong,{children:`1 match credit if the address resolves`}),` to an X handle or a Farcaster account, and nothing if it does not.`]}),`\n`,_jsxs(_components.p,{children:[`For more than a handful of addresses use `,_jsx(_components.a,{href:`/api-reference/batch`,children:`batch`}),` instead.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`address`,type:`string`,required:true,id:`param-address`,children:_jsxs(_components.p,{children:[`An address as `,_jsx(_components.code,{children:`0x`}),` followed by 40 hex characters. Case-insensitive; returned\nlowercased.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://walletlink.social/api/v1/wallet/0x00000000000000000000000000000000000000a1`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer wts_live_YOUR_KEY\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(ResponseField,{name:`data`,type:`object | null`,id:`param-data`,children:[_jsxs(_components.p,{children:[`The record, or `,_jsx(_components.code,{children:`null`}),` when nothing is attached to the address.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`wallet`,type:`string`,id:`param-wallet`,children:`Lowercased address. Always present.`}),_jsx(ResponseField,{name:`ens_name`,type:`string`,id:`param-ens-name`,children:`Primary ENS name.`}),_jsxs(ResponseField,{name:`twitter`,type:`object`,id:`param-twitter`,children:[_jsxs(_components.p,{children:[_jsx(_components.code,{children:`handle`}),`, `,_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`verified`}),`, `,_jsx(_components.code,{children:`self_declared`}),` where the handle rests only on text the wallet owner typed into their own record, and, once we have checked, `,_jsx(_components.code,{children:`reachable`}),`, `,_jsx(_components.code,{children:`reachability`}),` and `,_jsx(_components.code,{children:`reachability_checked_at`}),`. See `,_jsx(_components.a,{href:`/concepts/data-quality#the-verified-flags`,children:`the verified flags`}),`, which are narrower than they look, `,_jsx(_components.a,{href:`/concepts/data-quality#self-declared-handles`,children:`self-declared handles`}),`, and `,_jsx(_components.a,{href:`/concepts/data-quality#when-a-handle-stops-being-true`,children:`when a handle stops being true`}),`.`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`also`}),`, an object with `,_jsx(_components.code,{children:`handle`}),`, `,_jsx(_components.code,{children:`url`}),` and `,_jsx(_components.code,{children:`source`}),`, is present only where a second X account is attested for the same wallet and both accounts are live. See `,_jsx(_components.a,{href:`#a-second-x-account`,children:`a second X account`}),`.`]})]}),_jsx(ResponseField,{name:`farcaster`,type:`object`,id:`param-farcaster`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`username`}),`, `,_jsx(_components.code,{children:`url`}),`, `,_jsx(_components.code,{children:`followers`}),`, `,_jsx(_components.code,{children:`fid`}),`, and `,_jsx(_components.code,{children:`verified`}),`.`]})}),_jsx(ResponseField,{name:`lens`,type:`string`,id:`param-lens`,children:`Lens handle.`}),_jsx(ResponseField,{name:`github`,type:`string`,id:`param-github`,children:`GitHub username.`}),_jsx(ResponseField,{name:`sources`,type:`string[]`,id:`param-sources`,children:_jsxs(_components.p,{children:[`Evidence classes backing the record: `,_jsx(_components.code,{children:`onchain`}),`, `,_jsx(_components.code,{children:`farcaster`}),`, `,_jsx(_components.code,{children:`attested-social`}),`, `,_jsx(_components.code,{children:`manual`}),`, `,_jsx(_components.code,{children:`aggregated`}),`. See `,_jsx(_components.a,{href:`/concepts/data-quality#evidence-classes`,children:`evidence classes`}),`.`]})}),_jsxs(ResponseField,{name:`agent`,type:`object`,id:`param-agent`,children:[_jsxs(_components.p,{children:[`Present only when the address is a known onchain agent. Carries `,_jsx(_components.code,{children:`is_agent`}),`, `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`framework`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`token_symbol`}),` and `,_jsx(_components.code,{children:`verified`}),`.`]}),_jsx(_components.p,{children:`Absent where the address owner attested an identity that is not the agent’s own. A catalog entry is a third party’s claim about an address; an attestation is the owner’s, and the address a launch protocol files against an agent is frequently its creator’s rather than the agent’s. Absent means we decline to say, not that we checked and it is not an agent.`})]}),_jsx(ResponseField,{name:`quality`,type:`object`,id:`param-quality`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`score`}),` from 0 to 100, and `,_jsx(_components.code,{children:`last_verified`}),`.`]})})]})]}),`\n`,_jsx(ResponseField,{name:`meta`,type:`object`,id:`param-meta`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`wallet`,type:`string`,id:`param-wallet-1`,children:_jsx(_components.p,{children:`The normalized address you asked for.`})}),_jsx(ResponseField,{name:`found`,type:`boolean`,id:`param-found`,children:_jsx(_components.p,{children:`Whether any identities were attached.`})}),_jsx(ResponseField,{name:`last_updated`,type:`string`,id:`param-last-updated`,children:_jsxs(_components.p,{children:[`When the record last changed. Present only when `,_jsx(_components.code,{children:`found`}),` is true.`]})}),_jsx(ResponseField,{name:`stale`,type:`boolean`,id:`param-stale`,children:_jsxs(_components.p,{children:[`Whether the record is past its freshness window. Present only when `,_jsx(_components.code,{children:`found`}),`\nis true.`]})}),_jsx(ResponseField,{name:`checked_at`,type:`string | null`,id:`param-checked-at`,children:_jsxs(_components.p,{children:[`Present only when `,_jsx(_components.code,{children:`found`}),` is false. A timestamp means we checked and found\nnothing; `,_jsx(_components.code,{children:`null`}),` means we have never seen this address.`]})})]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Found`,numberOfLines:`32`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`32`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"wallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x00000000000000000000000000000000000000a1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ens_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example.eth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"twitter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"handle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example_user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://x.com/example_user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachability\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"live\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachability_checked_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-17T09:41:02.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"farcaster\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"username\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"example\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://warpcast.com/example\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"followers\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`123456`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`900001`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sources\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"onchain\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"farcaster\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"quality\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"score\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`90`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-10T09:12:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"wallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x00000000000000000000000000000000000000a1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"last_updated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-10T09:12:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"stale\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Checked, nothing found`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"wallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x0000000000000000000000000000000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"checked_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-02T11:30:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Never seen`,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"wallet\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0x0000000000000000000000000000000000000002\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"checked_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`All three of these are HTTP `,_jsx(_components.strong,{children:`200`}),`. A wallet with nothing attached is a\nsuccessful lookup with a negative answer, not an error.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`a-second-x-account`,children:`A second X account`}),`\n`,_jsxs(_components.p,{children:[`A wallet can have two X accounts attested for it: one through a Farcaster\nverification, say, and a different one through a signed attestation made later.\nWhen we have checked both and both still reach someone, there is no evidence\nfor preferring either, so the record keeps its `,_jsx(_components.code,{children:`handle`}),` and carries the other\nas `,_jsx(_components.code,{children:`twitter.also`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"twitter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"handle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"someone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://x.com/someone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"verified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachability\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"live\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reachability_checked_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-17T09:41:02.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"also\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"handle\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"someone_eth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://x.com/someone_eth\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"attested-social\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`source`}),` is the `,_jsx(_components.a,{href:`/concepts/data-quality#evidence-classes`,children:`evidence class`}),` of\nthe attestation behind the second handle. The field is absent, not null, on\nevery other record. It never appears where the stored handle has stopped\nreaching anyone: that record is corrected instead, and `,_jsx(_components.code,{children:`handle`}),` becomes the\naccount that still works.`]}),`\n`,_jsx(Heading,{level:`2`,id:`staleness-headers`,children:`Staleness headers`}),`\n`,_jsx(_components.p,{children:`When a record is past its freshness window the response adds:`}),`\n`,_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-Data-Staleness: stale`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-Last-Updated: 2026-05-01T00:00:00.000Z`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Both are absent on fresh records, so test for presence rather than comparing values.`}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INVALID_ADDRESS`}),`, plus the `,_jsx(_components.a,{href:`/api-reference/errors`,children:`standard errors`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Look up a wallet","description":"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.","api":"GET https://walletlink.social/api/v1/wallet/{address}","href":"/api-reference/wallet"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"A second X account","slug":"a-second-x-account","depth":2,"children":[]},{"title":"Staleness headers","slug":"staleness-headers","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Look up a wallet","path":"/api/v1/wallet/{address}","servers":[{"url":"https://walletlink.social"}],"method":"get","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{"address":{"schema":[{"type":"string","description":"An address as `0x` followed by 40 hex characters. Case-insensitive; returned lowercased.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"object","properties":{"wallet":[{"type":"string","description":"Lowercased address. Always present."}],"ens_name":[{"type":"string","description":"Primary ENS name."}],"twitter":[{"type":"object","properties":{},"description":"`handle` , `url` , `verified` , `self_declared` where the handle rests only on text the wallet owner typed into their own record, and, once we have checked, `reachable` , `reachability` and `reachability_checked_at` . See the verified flags , which are narrower than they look, self-declared handles , and when a handle stops being true . `also` , an object with `handle` , `url` and `source` , is present only where a second X account is attested for the same wallet and both accounts are live. See a second X account ."}],"farcaster":[{"type":"object","properties":{},"description":"`username` , `url` , `followers` , `fid` , and `verified` ."}],"lens":[{"type":"string","description":"Lens handle."}],"github":[{"type":"string","description":"GitHub username."}],"sources":[{"type":"array","items":[{"type":"string"}],"description":"Evidence classes backing the record: `onchain` , `farcaster` , `attested-social` , `manual` , `aggregated` . See evidence classes ."}],"agent":[{"type":"object","properties":{},"description":"Present only when the address is a known onchain agent. Carries `is_agent` , `name` , `framework` , `type` , `token_symbol` and `verified` . Absent where the address owner attested an identity that is not the agent’s own. A catalog entry is a third party’s claim about an address; an attestation is the owner’s, and the address a launch protocol files against an agent is frequently its creator’s rather than the agent’s. Absent means we decline to say, not that we checked and it is not an agent."}],"quality":[{"type":"object","properties":{},"description":"`score` from 0 to 100, and `last_verified` ."}]},"description":"The record, or `null` when nothing is attached to the address."}],"meta":[{"type":"object","properties":{"wallet":[{"type":"string","description":"The normalized address you asked for."}],"found":[{"type":"boolean","description":"Whether any identities were attached."}],"last_updated":[{"type":"string","description":"When the record last changed. Present only when `found` is true."}],"stale":[{"type":"boolean","description":"Whether the record is past its freshness window. Present only when `found` is true."}],"checked_at":[{"type":"object","properties":{},"description":"Present only when `found` is false. A timestamp means we checked and found nothing; `null` means we have never seen this address."}]}}]}}],"examples":{"example":{"value":{"data":{"wallet":"\u003cstring>","ens_name":"\u003cstring>","twitter":{},"farcaster":{},"lens":"\u003cstring>","github":"\u003cstring>","sources":["\u003cstring>"],"agent":{},"quality":{}},"meta":{"wallet":"\u003cstring>","found":true,"last_updated":"\u003cstring>","stale":true,"checked_at":{}}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"walletlink","siteName":"walletlink.social","title":"Look up a wallet - walletlink.social","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T21:41:07.595Z","originalFileLocation":"api-reference/wallet.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\">\u003cmeta data-mint-head name=\"application-name\" content=\"walletlink.social\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/walletlink/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/walletlink/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/walletlink/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/walletlink/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Look up a wallet - walletlink.social\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"walletlink.social\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.walletlink.social/api-reference/wallet\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://walletlink.mintlify.site/_mintlify/api/og/v2?division=Lookups\u0026amp;title=Look+up+a+wallet\u0026amp;description=Resolve+one+address+to+every+identity+attached+to+it%2C+for+1+match+credit+if+it+resolves+to+X+or+Farcaster+and+nothing+if+it+does+not.\u0026amp;theme=a33f390d9f66a2cfd68d4de4\u0026amp;signature=a6f8d770e5697b836e2bde10776d56ec76a5834c9164fc803779e5af25e55947\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Look up a wallet - walletlink.social\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://walletlink.mintlify.site/_mintlify/api/og/v2?division=Lookups\u0026amp;title=Look+up+a+wallet\u0026amp;description=Resolve+one+address+to+every+identity+attached+to+it%2C+for+1+match+credit+if+it+resolves+to+X+or+Farcaster+and+nothing+if+it+does+not.\u0026amp;theme=a33f390d9f66a2cfd68d4de4\u0026amp;signature=a6f8d770e5697b836e2bde10776d56ec76a5834c9164fc803779e5af25e55947\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/walletlink/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"walletlink.social\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4131B0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.walletlink.social/api-reference/wallet\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/wallet.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.walletlink.social/#organization\",\"name\":\"walletlink.social\",\"url\":\"https://docs.walletlink.social\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.walletlink.social#website\",\"name\":\"walletlink.social\",\"url\":\"https://docs.walletlink.social\",\"publisher\":{\"@id\":\"https://docs.walletlink.social/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.walletlink.social/api-reference/wallet#webpage\",\"url\":\"https://docs.walletlink.social/api-reference/wallet\",\"name\":\"Look up a wallet\",\"description\":\"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\",\"dateModified\":\"2026-09-29T21:41:07.595Z\",\"isPartOf\":{\"@id\":\"https://docs.walletlink.social#website\"},\"breadcrumb\":{\"@id\":\"https://docs.walletlink.social/api-reference/wallet#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.walletlink.social/api-reference/wallet#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"walletlink.social\",\"item\":\"https://docs.walletlink.social\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Look up a wallet\",\"item\":\"https://docs.walletlink.social/api-reference/wallet\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.walletlink.social/api-reference/wallet#apireference\",\"headline\":\"Look up a wallet\",\"name\":\"Look up a wallet\",\"description\":\"Resolve one address to every identity attached to it, for 1 match credit if it resolves to X or Farcaster and nothing if it does not.\",\"url\":\"https://docs.walletlink.social/api-reference/wallet\",\"mainEntityOfPage\":{\"@id\":\"https://docs.walletlink.social/api-reference/wallet#webpage\"},\"dateModified\":\"2026-09-29T21:41:07.595Z\",\"publisher\":{\"@id\":\"https://docs.walletlink.social/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.walletlink.social#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"walletlink.social\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"walletlink.social\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/wallet.md","siteName":"walletlink.social","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Rate limits","href":"/api-reference/rate-limits"},{"title":"Errors","description":"Error shape and every code the API returns.","href":"/api-reference/errors"}]},{"group":"Lookups","pages":[{"title":"Look up a wallet","api":"GET https://walletlink.social/api/v1/wallet/{address}","href":"/api-reference/wallet"},{"title":"Batch lookup","description":"Resolve many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.","api":"POST https://walletlink.social/api/v1/batch","href":"/api-reference/batch"},{"title":"Estimate","api":"POST https://walletlink.social/api/v1/estimate","href":"/api-reference/estimate"}]},{"group":"Jobs","pages":[{"title":"Async jobs","api":"POST https://walletlink.social/api/v1/jobs","href":"/api-reference/jobs"}]},{"group":"Reverse lookups","pages":[{"title":"Reverse X lookup","api":"GET https://walletlink.social/api/v1/reverse/twitter/{handle}","href":"/api-reference/reverse-twitter"},{"title":"Reverse Farcaster lookup","api":"GET https://walletlink.social/api/v1/reverse/farcaster/{username}","href":"/api-reference/reverse-farcaster"}]},{"group":"Account","pages":[{"title":"Index stats","api":"GET https://walletlink.social/api/v1/stats","href":"/api-reference/stats"},{"title":"Usage","api":"GET https://walletlink.social/api/v1/usage","href":"/api-reference/usage"}]}]}]},"basePath":"","title":"Look up a wallet - walletlink.social","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}