Fetches all users based on multiple Ethereum or Solana addresses.
Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.
A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users.
You can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.
GET
/
v2
/
farcaster
/
user
/
bulk-by-address
/
By Eth or Sol addresses
curl --request GET \ --url https://api.neynar.com/v2/farcaster/user/bulk-by-address/ \ --header 'x-api-key: <api-key>'
Customize which address types the request should search for. This is a comma-separated string that can include the following values: 'custody_address' and 'verified_address'. By default api returns both. To select multiple types, use a comma-separated list of these values.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Neynar","colors":{"primary":"#482b82","light":"#8512e0","dark":"#482b82"},"logo":{"light":"https://mintcdn.com/neynar/R9a_lt8Wf1SbwKa6/logo/farcaster-icon-light.svg?fit=max\u0026auto=format\u0026n=R9a_lt8Wf1SbwKa6\u0026q=85\u0026s=68441f4612c3fb569fd6cfd574f7be38","dark":"https://mintcdn.com/neynar/R9a_lt8Wf1SbwKa6/logo/farcaster-icon.svg?fit=max\u0026auto=format\u0026n=R9a_lt8Wf1SbwKa6\u0026q=85\u0026s=5bd2df1a42270c9df85557b517f1be64","href":"https://docs.neynar.com/"},"favicon":"https://mintcdn.com/neynar/R9a_lt8Wf1SbwKa6/favicon.svg?fit=max\u0026auto=format\u0026n=R9a_lt8Wf1SbwKa6\u0026q=85\u0026s=8ff2344189ea332738675757ccc06287","appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://dev.neynar.com/","label":"Log in"}],"primary":{"type":"github","href":"https://github.com/farcasterxyz"}},"footer":{"socials":{"github":"https://github.com/neynarxyz"}},"seo":{"metatags":{"og:type":"website","og:site_name":"Neynar Docs","og:url":"https://docs.neynar.com","og:title":"Neynar Documentation","og:description":"Comprehensive documentation for Neynar APIs and SDKs","referrer":"strict-origin-when-cross-origin","robots":"index, follow"},"indexing":"all"},"fonts":{"heading":{"family":"Work Sans","weight":500},"body":{"family":"Work Sans"}},"styling":{"codeblocks":"system","latex":true},"integrations":{"ga4":{"measurementId":"G-P1P663665L"}},"contextual":{"options":["claude","chatgpt","cursor","vscode","mcp","copy","view"],"display":"header"},"navigation":{"global":{"anchors":[{"anchor":"Status","icon":"signal","href":"https://status.neynar.com/"},{"anchor":"Blog","icon":"newspaper","href":"https://neynar.com/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"neynar","hasAudioNarration":false,"actualSubdomain":"neynar","customDomains":["docs.neynar.com"],"gitSource":{"type":"github","owner":"neynarxyz","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aebe3fbbaab42e7766182d9","collectionId":"f5db92e5-3f45-45f2-82de-e15de925dc3d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aebe3fbbaab42e7766182d9"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aebe3fbbaab42e7766182d9","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"REST API Reference","count":166},{"language":"default","tag":"Node.js SDK","count":138},{"language":"default","tag":"Farcaster","count":128},{"language":"default","tag":"Learn","count":92},{"language":"default","tag":"Tutorials","count":80},{"language":"default","tag":"Mini Apps","count":53},{"language":"default","tag":"Snapchain","count":39},{"language":"default","tag":"SDK","count":27},{"language":"default","tag":"Reference","count":25},{"language":"default","tag":"Farcaster Hub API","count":25}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@neynar.com","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"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":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"h1,h2,h3,h4,h5,h6{font-weight:500!important}.page-title,.section-title,.heading{font-weight:500!important}[class*=\"font-bold\"],[class*=\"font-semibold\"]{font-weight:500!important}.cursor-doc-image{width:min(640px, 80%);height:auto;display:block;margin:0.5rem auto;border-radius:12px}.cursor-doc-image--compact{width:min(300px, 60%);height:auto;display:block;margin:0.5rem auto;border-radius:12px}.nav-dropdown-wrapper{position:relative;display:inline-flex}.nav-dropdown-trigger{display:inline-flex;align-items:center;gap:4px;background:none;border:none;cursor:pointer;font-size:14px;font-weight:500;font-family:inherit;color:inherit;padding:6px 0;white-space:nowrap}.nav-dropdown-trigger:hover{opacity:0.8}.nav-dropdown-chevron{display:inline-flex;align-items:center;transition:transform 0.2s ease}.nav-dropdown-wrapper.open .nav-dropdown-chevron{transform:rotate(180deg)}.nav-dropdown-menu{position:absolute;top:calc(100% + 8px);right:0;min-width:180px;border-radius:8px;padding:4px;opacity:0;visibility:hidden;transform:translateY(-4px);transition:opacity 0.15s ease, transform 0.15s ease, visibility 0.15s;z-index:100;background:#ffffff;border:1px solid #e5e5e5;box-shadow:0 4px 12px rgba(0, 0, 0, 0.08)}:root[class~=\"dark\"] .nav-dropdown-menu,.dark .nav-dropdown-menu{background:#1a1a2e;border-color:#2a2a3e;box-shadow:0 4px 12px rgba(0, 0, 0, 0.3)}.nav-dropdown-wrapper.open .nav-dropdown-menu{opacity:1;visibility:visible;transform:translateY(0)}.nav-dropdown-item{display:block;padding:8px 12px;font-size:14px;font-weight:400;color:#374151;text-decoration:none;border-radius:6px;white-space:nowrap}.nav-dropdown-item:hover{background:#f3f4f6;color:#111827;text-decoration:none}:root[class~=\"dark\"] .nav-dropdown-item,.dark .nav-dropdown-item{color:#d1d5db}:root[class~=\"dark\"] .nav-dropdown-item:hover,.dark .nav-dropdown-item:hover{background:#2a2a3e;color:#ffffff}"}],"page":{"pagePath":"reference/fetch-bulk-users-by-eth-or-sol-address","slug":"/reference/fetch-bulk-users-by-eth-or-sol-address","pageMetadata":{"openapi":"get /v2/farcaster/user/bulk-by-address/","keywords":["fetch users by address","ethereum address","solana address","bulk users","wallet lookup","neynar api"],"author":"Neynar","robots":"index, follow","openGraph":{"title":"Fetch Bulk Users by ETH/SOL Address - Neynar Farcaster API","description":"Retrieve multiple Farcaster users by their Ethereum or Solana wallet addresses using Neynar API","type":"article"},"title":"By Eth or Sol addresses","description":"Fetches all users based on multiple Ethereum or Solana addresses.\n\nEach farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.\n\nA custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users.\nYou can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.","href":"/reference/fetch-bulk-users-by-eth-or-sol-address"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Fetches all users based on multiple Ethereum or Solana addresses.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users.\\nYou can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.\"\n })]\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`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(Heading,{level:`3`,id:`see-related-guide-user-by-wallet-address`,children:[`See related guide: `,_jsx(_components.a,{href:`/docs/fetching-farcaster-user-based-on-ethereum-address`,children:`User by wallet address`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`node-js-sdk`,children:`Node.js SDK`}),`\n`,_jsxs(_components.p,{children:[`🔗 `,_jsx(_components.strong,{children:`SDK Method:`}),` `,_jsx(_components.a,{href:`/nodejs-sdk/user-apis/fetchBulkUsersByEthOrSolAddress`,children:`fetchBulkUsersByEthOrSolAddress`})]}),`\n`,_jsx(_components.p,{children:`Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.`})]})}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":{"codeStyling":"system","config":{},"pageMetadata":{"openapi":"get /v2/farcaster/user/bulk-by-address/","keywords":["fetch users by address","ethereum address","solana address","bulk users","wallet lookup","neynar api"],"author":"Neynar","robots":"index, follow","openGraph":{"title":"Fetch Bulk Users by ETH/SOL Address - Neynar Farcaster API","description":"Retrieve multiple Farcaster users by their Ethereum or Solana wallet addresses using Neynar API","type":"article"},"title":"By Eth or Sol addresses","description":"Fetches all users based on multiple Ethereum or Solana addresses.\n\nEach farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.\n\nA custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users.\nYou can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.","href":"/reference/fetch-bulk-users-by-eth-or-sol-address"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"See related guide: User by wallet address","slug":"see-related-guide-user-by-wallet-address","depth":3,"children":[]},{"title":"Node.js SDK","slug":"node-js-sdk","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/neynar/877f22f5fc1f428d/ahrefs.js","/_mintlify/custom/neynar/298abe83c87933a3/scripts/generate-nodejs-sdk-docs.js","/_mintlify/custom/neynar/be9de9b5ab62eeb0/navbar-dropdown.js"],"openApiReferenceData":{"operation":{"description":"Fetches all users based on multiple Ethereum or Solana addresses.\n\nEach farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses.\n\nA custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users.\nYou can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.","externalDocs":{"url":"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address"},"operationId":"fetch-bulk-users-by-eth-or-sol-address","parameters":["4f89bd3c-9e98-424c-bff8-fceef9141d91","47d83551-a1ee-4338-8bc2-a85349b14015","8606da5b-9146-43f1-96c1-5ff7d2a04d61","b6b09d78-17e5-4278-816d-f85034a6316d"],"responses":{"200":"b960edb7-afe5-45fb-a881-6e2f882d4d44","400":"1b2fe894-12d9-4a23-8a17-80cc3872f02b","404":"0c1b53e3-e06a-4272-99b7-0fc810301c14"},"summary":"By Eth or Sol addresses","tags":["User"],"method":"get","type":"path","servers":["2904a18f-acc9-476f-b32b-eb6329912ce6"],"security":["91d17d17-2cc4-472e-872a-2752a2039d8f"],"path":"/v2/farcaster/user/bulk-by-address/","baseUrlOptions":["https://api.neynar.com"],"title":"By Eth or Sol addresses","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4f89bd3c-9e98-424c-bff8-fceef9141d91":{"description":"Enables experimental features including filtering based on the Neynar score. See [docs](https://neynar.notion.site/Experimental-Features-1d2655195a8b80eb98b4d4ae7b76ae4a) for more details.","in":"header","name":"x-neynar-experimental","schema":{"default":false,"type":"boolean","description":"Enables experimental features including filtering based on the Neynar score. See [docs](https://neynar.notion.site/Experimental-Features-1d2655195a8b80eb98b4d4ae7b76ae4a) for more details.","uniqueKey":"","typeLabel":"boolean"},"x-is-global-header":true},"47d83551-a1ee-4338-8bc2-a85349b14015":{"description":"Comma separated list of Ethereum or Solana addresses, up to 350 at a time","in":"query","name":"addresses","required":true,"schema":{"example":"0xa6a8736f18f383f1cc2d938576933e5ea7df01a1,0x7cac817861e5c3384753403fb6c0c556c204b1ce","type":"string","x-comma-separated":true,"isRequired":true,"description":"Comma separated list of Ethereum or Solana addresses, up to 350 at a time","uniqueKey":"","typeLabel":"string"}},"8606da5b-9146-43f1-96c1-5ff7d2a04d61":{"description":"Customize which address types the request should search for. This is a comma-separated string that can include the following values: 'custody_address' and 'verified_address'. By default api returns both. To select multiple types, use a comma-separated list of these values.","in":"query","name":"address_types","schema":{"items":{"enum":["custody_address","verified_address"],"title":"BulkUserAddressType","type":"string","uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","description":"Customize which address types the request should search for. This is a comma-separated string that can include the following values: 'custody_address' and 'verified_address'. By default api returns both. To select multiple types, use a comma-separated list of these values.","uniqueKey":"","typeLabel":"enum\u003cstring>[]"}},"b6b09d78-17e5-4278-816d-f85034a6316d":{"in":"query","name":"viewer_fid","schema":{"minimum":1,"type":"integer","uniqueKey":"","typeLabel":"integer"}}},"responses":{"b960edb7-afe5-45fb-a881-6e2f882d4d44":{"content":{"application/json":{"schema":{"type":"object","title":"BulkUsersByAddressResponse","additionalProperties":{"items":{"properties":{"auth_addresses":{"items":{"properties":{"address":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].address","typeLabel":"string"},"app":{"properties":{"fid":{"description":"The unique identifier of a farcaster user or app (unsigned integer)","example":3,"format":"int32","minimum":0,"title":"Fid","type":"integer","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.fid","typeLabel":"integer\u003cint32>"},"object":{"enum":["user_dehydrated"],"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.object","typeLabel":"enum\u003cstring>"},"custody_address":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.custody_address","typeLabel":"string"},"display_name":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.display_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.display_name","typeLabel":"string | null"},"pfp_url":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.pfp_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.pfp_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.pfp_url","typeLabel":"string | null"},"score":{"type":"number","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.score","typeLabel":"number"},"username":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app.username","typeLabel":"string"}},"required":["object","fid"],"title":"UserDehydrated","type":"object","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX].app","typeLabel":"UserDehydrated · object"}},"required":["address","app"],"type":"object","uniqueKey":"additionalProperties.items.[INDEX].auth_addresses.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].auth_addresses","typeLabel":"object[]"},"custody_address":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].custody_address","typeLabel":"string"},"fid":{"description":"The unique identifier of a farcaster user or app (unsigned integer)","example":3,"format":"int32","minimum":0,"title":"Fid","type":"integer","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].fid","typeLabel":"integer\u003cint32>"},"follower_count":{"description":"The number of followers the user has.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].follower_count","typeLabel":"integer\u003cint32>"},"following_count":{"description":"The number of users the user is following.","format":"int32","type":"integer","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].following_count","typeLabel":"integer\u003cint32>"},"object":{"enum":["user"],"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"profile":{"properties":{"bio":{"properties":{"text":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.text","typeLabel":"string"},"mentioned_channels":{"items":{"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].name","typeLabel":"string"},"object":{"enum":["channel_dehydrated"],"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"image_url":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].image_url","typeLabel":"string"},"viewer_context":{"description":"Adds context on the viewer's or author's role in the channel.","properties":{"following":{"description":"Indicates if the user is following the channel.","type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].viewer_context.following","typeLabel":"boolean"},"role":{"description":"The role of a channel member","enum":["member","moderator","owner"],"title":"ChannelMemberRole","type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].viewer_context.role","typeLabel":"enum\u003cstring>"}},"required":["following"],"title":"ChannelUserContext","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX].viewer_context","typeLabel":"ChannelUserContext · object"}},"required":["id","name","object"],"title":"ChannelDehydrated","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels.items.[INDEX]","typeLabel":"ChannelDehydrated · object"},"type":"array","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels","typeLabel":"ChannelDehydrated · object[]"},"mentioned_channels_ranges":{"description":"Positions within the text (inclusive start, exclusive end) where each mention occurs.\nEach index within this list corresponds to the same-numbered index in the mentioned_channels list.","items":{"properties":{"end":{"minimum":0,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels_ranges.items.[INDEX].end","typeLabel":"number"},"start":{"minimum":0,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels_ranges.items.[INDEX].start","typeLabel":"number"}},"required":["start","end"],"title":"TextRange","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels_ranges.items.[INDEX]","typeLabel":"TextRange · object"},"type":"array","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_channels_ranges","typeLabel":"TextRange · object[]"},"mentioned_profiles":{"items":{"properties":{"fid":{"description":"The unique identifier of a farcaster user or app (unsigned integer)","example":3,"format":"int32","minimum":0,"title":"Fid","type":"integer","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].fid","typeLabel":"integer\u003cint32>"},"object":{"enum":["user_dehydrated"],"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].object","typeLabel":"enum\u003cstring>"},"custody_address":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].custody_address","typeLabel":"string"},"display_name":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].display_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].display_name","typeLabel":"string | null"},"pfp_url":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].pfp_url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].pfp_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].pfp_url","typeLabel":"string | null"},"score":{"type":"number","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].score","typeLabel":"number"},"username":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX].username","typeLabel":"string"}},"required":["object","fid"],"title":"UserDehydrated","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles.items.[INDEX]","typeLabel":"UserDehydrated · object"},"type":"array","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles","typeLabel":"UserDehydrated · object[]"},"mentioned_profiles_ranges":{"description":"Positions within the text (inclusive start, exclusive end) where each mention occurs.\nEach index within this list corresponds to the same-numbered index in the mentioned_profiles list.","items":{"properties":{"end":{"minimum":0,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles_ranges.items.[INDEX].end","typeLabel":"number"},"start":{"minimum":0,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles_ranges.items.[INDEX].start","typeLabel":"number"}},"required":["start","end"],"title":"TextRange","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles_ranges.items.[INDEX]","typeLabel":"TextRange · object"},"type":"array","uniqueKey":"additionalProperties.items.[INDEX].profile.bio.mentioned_profiles_ranges","typeLabel":"TextRange · object[]"}},"required":["text"],"type":"object","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.bio","typeLabel":"object"},"banner":{"properties":{"url":{"description":"The URL of the user's banner image","format":"uri","type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.banner.url","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.banner","typeLabel":"object"},"live_at":{"properties":{"is_live":{"type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.live_at.is_live","typeLabel":"boolean"},"updated_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.live_at.updated_at","typeLabel":"string\u003cdate-time>"},"url":{"description":"The URL of the user's current live activity","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.live_at.url","typeLabel":"string"}},"required":["url","updated_at","is_live"],"type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.live_at","typeLabel":"object"},"location":{"description":"Coordinates and place names for a location","properties":{"latitude":{"format":"double","maximum":90,"minimum":-90,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.location.latitude","typeLabel":"number\u003cdouble>"},"longitude":{"format":"double","maximum":180,"minimum":-180,"type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.location.longitude","typeLabel":"number\u003cdouble>"},"address":{"properties":{"city":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.location.address.city","typeLabel":"string"},"country":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile.location.address.country","typeLabel":"string"},"country_code":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.location.address.country_code","typeLabel":"string"},"state":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.location.address.state","typeLabel":"string"},"state_code":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].profile.location.address.state_code","typeLabel":"string"}},"required":["city","country"],"title":"LocationAddress","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.location.address","typeLabel":"LocationAddress · object"},"radius":{"description":"The radius in meters for the location search. Any location within this radius will be returned.","minimum":0,"type":"number","uniqueKey":"additionalProperties.items.[INDEX].profile.location.radius","typeLabel":"number"}},"required":["latitude","longitude"],"title":"Location","type":"object","uniqueKey":"additionalProperties.items.[INDEX].profile.location","typeLabel":"Location · object"}},"required":["bio"],"type":"object","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].profile","typeLabel":"object"},"registered_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].registered_at","typeLabel":"string\u003cdate-time>"},"username":{"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].username","typeLabel":"string"},"verifications":{"items":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","uniqueKey":"additionalProperties.items.[INDEX].verifications.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verifications","typeLabel":"string[]"},"verified_accounts":{"items":{"description":"Verified accounts of the user on other platforms, currently only X is supported.","properties":{"platform":{"enum":["x","github"],"type":"string","uniqueKey":"additionalProperties.items.[INDEX].verified_accounts.items.[INDEX].platform","typeLabel":"enum\u003cstring>"},"username":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].verified_accounts.items.[INDEX].username","typeLabel":"string"}},"type":"object","uniqueKey":"additionalProperties.items.[INDEX].verified_accounts.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_accounts","typeLabel":"object[]"},"verified_addresses":{"properties":{"eth_addresses":{"description":"List of verified Ethereum addresses of the user sorted by oldest to most recent.","items":{"description":"Ethereum address","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","pattern":"^0x[a-fA-F0-9]{40}$","title":"EthAddress","type":"string","uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.eth_addresses.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.eth_addresses","typeLabel":"string[]"},"primary":{"properties":{"eth_address":{"oneOf":[{"type":"string","title":"EthAddress","description":"Ethereum address","pattern":"^0x[a-fA-F0-9]{40}$","example":"0x5a927ac639636e534b678e81768ca19e2c6280b7","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.eth_address.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.eth_address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.eth_address","typeLabel":"string | null"},"sol_address":{"oneOf":[{"type":"string","title":"SolAddress","description":"Solana address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.sol_address.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.sol_address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary.sol_address","typeLabel":"string | null"}},"required":["eth_address","sol_address"],"type":"object","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.primary","typeLabel":"object"},"sol_addresses":{"description":"List of verified Solana addresses of the user sorted by oldest to most recent.","items":{"description":"Solana address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","title":"SolAddress","type":"string","uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.sol_addresses.items.[INDEX]","typeLabel":"string"},"type":"array","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses.sol_addresses","typeLabel":"string[]"}},"required":["eth_addresses","sol_addresses","primary"],"type":"object","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].verified_addresses","typeLabel":"object"},"display_name":{"oneOf":[{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].display_name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"additionalProperties.items.[INDEX].display_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].display_name","typeLabel":"string | null"},"experimental":{"properties":{"neynar_user_score":{"description":"Score that represents the probability that the account is not spam.","format":"double","type":"number","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].experimental.neynar_user_score","typeLabel":"number\u003cdouble>"},"deprecation_notice":{"type":"string","uniqueKey":"additionalProperties.items.[INDEX].experimental.deprecation_notice","typeLabel":"string"}},"required":["neynar_user_score"],"type":"object","uniqueKey":"additionalProperties.items.[INDEX].experimental","typeLabel":"object"},"pfp_url":{"oneOf":[{"description":"The URL of the user's profile picture","type":"string","uniqueKey":"additionalProperties.items.[INDEX].pfp_url.oneOf.0","typeLabel":"string"},{"description":"The URL of the user's profile picture","type":"null","uniqueKey":"additionalProperties.items.[INDEX].pfp_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"additionalProperties.items.[INDEX].pfp_url","typeLabel":"string | null"},"pro":{"properties":{"expires_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].pro.expires_at","typeLabel":"string\u003cdate-time>"},"status":{"description":"The subscription status of the user","enum":["subscribed","unsubscribed"],"type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].pro.status","typeLabel":"enum\u003cstring>"},"subscribed_at":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].pro.subscribed_at","typeLabel":"string\u003cdate-time>"}},"required":["status","subscribed_at","expires_at"],"type":"object","uniqueKey":"additionalProperties.items.[INDEX].pro","typeLabel":"object"},"score":{"description":"Score that represents the probability that the account is not spam.","format":"double","type":"number","uniqueKey":"additionalProperties.items.[INDEX].score","typeLabel":"number\u003cdouble>"},"viewer_context":{"description":"Adds context on the viewer's follow relationship with the user.","properties":{"blocked_by":{"description":"Indicates if the viewer is blocked by the user.","type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].viewer_context.blocked_by","typeLabel":"boolean"},"blocking":{"description":"Indicates if the viewer is blocking the user.","type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].viewer_context.blocking","typeLabel":"boolean"},"followed_by":{"description":"Indicates if the viewer is followed by the user.","type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].viewer_context.followed_by","typeLabel":"boolean"},"following":{"description":"Indicates if the viewer is following the user.","type":"boolean","isRequired":true,"uniqueKey":"additionalProperties.items.[INDEX].viewer_context.following","typeLabel":"boolean"}},"required":["following","followed_by","blocking","blocked_by"],"title":"UserViewerContext","type":"object","uniqueKey":"additionalProperties.items.[INDEX].viewer_context","typeLabel":"UserViewerContext · object"}},"required":["object","fid","username","custody_address","registered_at","profile","follower_count","following_count","verifications","auth_addresses","verified_addresses","verified_accounts"],"title":"User","type":"object","uniqueKey":"additionalProperties.items.[INDEX]","typeLabel":"User · object"},"type":"array","uniqueKey":"additionalProperties","typeLabel":"User · object[]"},"uniqueKey":"","typeLabel":"BulkUsersByAddressResponse · object"},"examples":{"Example":{"title":"Example","value":{}}},"exampleType":"generated"}},"description":"Success","exampleType":"generated"},"1b2fe894-12d9-4a23-8a17-80cc3872f02b":{"content":{"application/json":{"schema":{"description":"Details for the error response","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"property":{"type":"string","uniqueKey":"property","typeLabel":"string"},"status":{"format":"int32","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint32>"}},"required":["message"],"title":"ErrorRes","type":"object","uniqueKey":"","typeLabel":"ErrorRes · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","property":"\u003cstring>","status":123}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"0c1b53e3-e06a-4272-99b7-0fc810301c14":{"content":{"application/json":{"schema":{"description":"Details for the error response","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"property":{"type":"string","uniqueKey":"property","typeLabel":"string"},"status":{"format":"int32","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint32>"}},"required":["message"],"title":"ErrorRes","type":"object","uniqueKey":"","typeLabel":"ErrorRes · object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","code":"\u003cstring>","property":"\u003cstring>","status":123}}},"exampleType":"generated"}},"description":"Resource not found","exampleType":"generated"}},"security":{"91d17d17-2cc4-472e-872a-2752a2039d8f":{"ApiKeyAuth":{"description":"API key to authorize requests","in":"header","name":"x-api-key","type":"apiKey","x-default":"NEYNAR_API_DOCS","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"2904a18f-acc9-476f-b32b-eb6329912ce6":{"url":"https://api.neynar.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key to authorize requests","in":"header","name":"x-api-key","type":"apiKey","x-default":"NEYNAR_API_DOCS","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","description":"API key to authorize requests","isRequired":true,"default":"NEYNAR_API_DOCS","typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi/api/openapi.yaml"},"subdomain":"neynar","siteName":"Neynar","title":"Neynar Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-27T22:51:25.176Z","originalFileLocation":"reference/fetch-bulk-users-by-eth-or-sol-address.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=\"dark\"}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=\"Fetches all users based on multiple Ethereum or Solana addresses. Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses. A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users. You can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Neynar\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Neynar Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Comprehensive documentation for Neynar APIs and SDKs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Neynar Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://neynar.mintlify.site/_mintlify/api/og/v2?division=Fetch+User+Information\u0026amp;title=By+Eth+or+Sol+addresses\u0026amp;description=Fetches+all+users+based+on+multiple+Ethereum+or+Solana+addresses.%0A%0AEach+farcaster+user+has+a+custody+Ethereum+address+and+optionally+verified+Ethereum+or+Solana\u0026amp;theme=186d51285df79b1217aa5b84\u0026amp;signature=22fe0dd1ee1f00c07ab3c64cd88f569a53bb56d3f0e68d3227dd8b58d8d3754a\">\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=\"Neynar Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Comprehensive documentation for Neynar APIs and SDKs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://neynar.mintlify.site/_mintlify/api/og/v2?division=Fetch+User+Information\u0026amp;title=By+Eth+or+Sol+addresses\u0026amp;description=Fetches+all+users+based+on+multiple+Ethereum+or+Solana+addresses.%0A%0AEach+farcaster+user+has+a+custody+Ethereum+address+and+optionally+verified+Ethereum+or+Solana\u0026amp;theme=186d51285df79b1217aa5b84\u0026amp;signature=22fe0dd1ee1f00c07ab3c64cd88f569a53bb56d3f0e68d3227dd8b58d8d3754a\">\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=\"/mintlify-assets/_mintlify/favicons/neynar/st0_6iz_-a2LKQkt/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Neynar\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#482b82\">\u003cmeta data-mint-head name=\"referrer\" content=\"strict-origin-when-cross-origin\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/fetch-bulk-users-by-eth-or-sol-address.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.neynar.com/#organization\",\"name\":\"Neynar\",\"url\":\"https://docs.neynar.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/neynar/R9a_lt8Wf1SbwKa6/logo/farcaster-icon-light.svg?fit=max\u0026auto=format\u0026n=R9a_lt8Wf1SbwKa6\u0026q=85\u0026s=68441f4612c3fb569fd6cfd574f7be38\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.neynar.com#website\",\"name\":\"Neynar\",\"url\":\"https://docs.neynar.com\",\"publisher\":{\"@id\":\"https://docs.neynar.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address#webpage\",\"url\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address\",\"name\":\"By Eth or Sol addresses\",\"description\":\"Fetches all users based on multiple Ethereum or Solana addresses. Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses. A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users. You can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.\",\"dateModified\":\"2026-01-27T22:51:25.176Z\",\"isPartOf\":{\"@id\":\"https://docs.neynar.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Farcaster\",\"item\":\"https://docs.neynar.com/reference/fetch-user-information\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"User\",\"item\":\"https://docs.neynar.com/reference/fetch-user-information\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Fetch User Information\",\"item\":\"https://docs.neynar.com/reference/fetch-user-information\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"By Eth or Sol addresses\",\"item\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address#apireference\",\"headline\":\"By Eth or Sol addresses\",\"name\":\"By Eth or Sol addresses\",\"description\":\"Fetches all users based on multiple Ethereum or Solana addresses. Each farcaster user has a custody Ethereum address and optionally verified Ethereum or Solana addresses. This endpoint returns all users that have any of the given addresses as their custody or verified Ethereum or Solana addresses. A custody address can be associated with only 1 farcaster user at a time but a verified address can be associated with multiple users. You can pass in Ethereum and Solana addresses, comma separated, in the same request. The response will contain users associated with the given addresses.\",\"url\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address\",\"mainEntityOfPage\":{\"@id\":\"https://docs.neynar.com/reference/fetch-bulk-users-by-eth-or-sol-address#webpage\"},\"dateModified\":\"2026-01-27T22:51:25.176Z\",\"keywords\":\"fetch users by address, ethereum address, solana address, bulk users, wallet lookup, neynar api\",\"publisher\":{\"@id\":\"https://docs.neynar.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.neynar.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Neynar\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Neynar","nav":{"global":{"anchors":[{"anchor":"Status","icon":"signal","href":"https://status.neynar.com/"},{"anchor":"Blog","icon":"newspaper","href":"https://neynar.com/blog"}]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/"}]},{"tab":"Tutorials","pages":[{"title":"Tutorials","href":"/docs/getting-started-with-neynar"}]},{"tab":"REST API Reference","groups":[{"group":"Overview","pages":[{"title":"Quickstart","href":"/reference/quickstart"},{"title":"Rate Limits","href":"/reference/what-are-the-rate-limits-on-neynar-apis"},{"title":"Credits Pricing","url":"https://dev.neynar.com/pricing","href":"/external-link-0"}]},{"group":"Farcaster","pages":[{"group":"User","pages":[{"group":"Fetch User Information","pages":[{"title":"Fetch User Information","sidebarTitle":"Overview","href":"/reference/fetch-user-information"},{"openapi":"get /v2/farcaster/user/search/","title":"Search for Usernames","href":"/reference/search-user"},{"openapi":"get /v2/farcaster/user/bulk/","sidebarTitle":"By FIDs (Farcaster IDs)","title":"By FIDs","description":"Fetches information about multiple users based on FIDs","href":"/reference/fetch-bulk-users"},{"openapi":"get /v2/farcaster/user/bulk-by-address/","title":"By Eth or Sol addresses","href":"/reference/fetch-bulk-users-by-eth-or-sol-address"},{"openapi":"get /v2/farcaster/user/custody-address/","title":"By custody-address","description":"Lookup a user by custody-address","href":"/reference/lookup-user-by-custody-address"},{"openapi":"get /v2/farcaster/user/by_username/","title":"By username","href":"/reference/lookup-user-by-username"},{"openapi":"get /v2/farcaster/user/by_x_username/","title":"By X username","href":"/reference/lookup-users-by-x-username"},{"openapi":"get /v2/farcaster/user/by_location/","title":"By location","href":"/reference/fetch-users-by-location"},{"openapi":"get /v2/farcaster/user/verifications/","title":"Fetch verifications","href":"/reference/fetch-verifications"}]},{"group":"Fetch User's Casts","pages":[{"openapi":"get /v2/farcaster/feed/user/popular/","title":"10 most popular casts","href":"/reference/fetch-popular-casts-by-user"},{"openapi":"get /v2/farcaster/feed/user/replies_and_recasts/","title":"Replies and recasts","href":"/reference/fetch-replies-and-recasts-for-user"},{"openapi":"get /v2/farcaster/feed/user/casts/","title":"Chronologically","href":"/reference/fetch-casts-for-user"}]},{"group":"Register New User","pages":[{"title":"Register New user","sidebarTitle":"Overview","href":"/reference/register-new-user"},{"openapi":"get /v2/farcaster/user/fid/","title":"Fetch fresh FID","href":"/reference/get-fresh-account-fid"},{"openapi":"post /v2/farcaster/user/","title":"Register new account","href":"/reference/register-account"}]},{"group":"Update User Profile","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/reference/update-user-profile-1"},{"openapi":"patch /v2/farcaster/user/","title":"Update user profile","href":"/reference/update-user"},{"openapi":"post /v2/farcaster/user/verification/","title":"Add verification","href":"/reference/publish-verification"},{"openapi":"delete /v2/farcaster/user/verification/","title":"Delete verification","href":"/reference/delete-verification"}]},{"openapi":"get /v2/farcaster/user/interactions/","title":"User interactions","href":"/reference/fetch-user-interactions"},{"openapi":"get /v2/farcaster/login/authorize/","title":"Fetch authorization url","href":"/reference/fetch-authorization-url"}]},{"group":"Cast","pages":[{"openapi":"get /v2/farcaster/cast/embed/crawl/","title":"Embedded URL metadata","href":"/reference/fetch-embedded-url-metadata"},{"openapi":"get /v2/farcaster/cast/","title":"By hash or URL","href":"/reference/lookup-cast-by-hash-or-url"},{"openapi":"post /v2/farcaster/cast/","title":"Post a cast","href":"/reference/publish-cast"},{"openapi":"delete /v2/farcaster/cast/","title":"Delete a cast","href":"/reference/delete-cast"},{"openapi":"get /v2/farcaster/casts/","title":"Bulk fetch casts","href":"/reference/fetch-bulk-casts"},{"openapi":"get /v2/farcaster/cast/search/","title":"Search for casts","href":"/reference/search-casts"},{"openapi":"get /v2/farcaster/cast/conversation/","title":"Conversation for a cast","href":"/reference/lookup-cast-conversation"},{"openapi":"get /v2/farcaster/cast/conversation/summary/","sidebarTitle":"Conversation summary","title":"Cast conversation summary","href":"/reference/lookup-cast-conversation-summary"},{"openapi":"get /v2/farcaster/cast/composer_actions/list/","title":null,"href":"/reference/fetch-composer-actions"},{"openapi":"get /v2/farcaster/cast/metrics/","title":"Metrics for casts","href":"/reference/fetch-cast-metrics"},{"openapi":"get /v2/farcaster/cast/quotes/","title":"Cast Quotes","href":"/reference/fetch-cast-quotes"}]},{"group":"Signer","pages":[{"group":"Neynar Managed","pages":[{"openapi":"get /v2/farcaster/signer/","title":"Status","href":"/reference/lookup-signer"},{"openapi":"post /v2/farcaster/signer/","title":"Create signer","href":"/reference/create-signer"},{"openapi":"post /v2/farcaster/signer/signed_key/","title":"Register Signed Key","href":"/reference/register-signed-key"}]},{"group":"Developer Managed","pages":[{"openapi":"get /v2/farcaster/signer/developer_managed/","title":"Status by public key","href":"/reference/lookup-developer-managed-signer"},{"openapi":"post /v2/farcaster/signer/developer_managed/signed_key/","title":"Register Signed Key","href":"/reference/register-signed-key-for-developer-managed-signer"},{"openapi":"post /v2/farcaster/message/","title":"Publish message","href":"/reference/publish-message-to-farcaster"}]},{"openapi":"get /v2/farcaster/signer/list/","title":"List signers","href":"/reference/fetch-signers"}]},{"group":"Auth Address","pages":[{"group":"Developer Managed","pages":[{"openapi":"post /v2/farcaster/auth_address/developer_managed/signed_key/","title":"Register Signed Key","href":"/reference/register-signed-key-for-developer-managed-auth-address"},{"openapi":"get /v2/farcaster/auth_address/developer_managed/","title":"Status by auth address","href":"/reference/lookup-developer-managed-auth-address"}]}]},{"group":"Feed","pages":[{"group":"User","pages":[{"openapi":"get /v2/farcaster/feed/following/","title":"Following","href":"/reference/fetch-user-following-feed"}]},{"group":"Channels","pages":[{"openapi":"get /v2/farcaster/feed/channels/","title":"By channel IDs","href":"/reference/fetch-feed-by-channel-ids"},{"openapi":"get /v2/farcaster/feed/parent_urls/","title":"By parent URLs","href":"/reference/fetch-feed-by-parent-urls"}]},{"openapi":"get /v2/farcaster/feed/","title":"By filters","href":"/reference/fetch-feed"},{"openapi":"get /v2/farcaster/feed/trending/","title":null,"href":"/reference/fetch-trending-feed"}]},{"group":"Reaction","pages":[{"openapi":"post /v2/farcaster/reaction/","title":"Post a reaction","href":"/reference/publish-reaction"},{"openapi":"delete /v2/farcaster/reaction/","title":"Delete reaction","href":"/reference/delete-reaction"},{"openapi":"get /v2/farcaster/reactions/user/","title":"Reactions for user","href":"/reference/fetch-user-reactions"},{"openapi":"get /v2/farcaster/reactions/cast/","title":"Reactions for cast","href":"/reference/fetch-cast-reactions"}]},{"group":"Follow","pages":[{"openapi":"get /v2/farcaster/followers/","title":"Followers","href":"/reference/fetch-user-followers"},{"openapi":"get /v2/farcaster/followers/relevant/","title":"Relevant followers","href":"/reference/fetch-relevant-followers"},{"openapi":"get /v2/farcaster/followers/reciprocal/","title":"Reciprocal Followers","href":"/reference/fetch-user-reciprocal-followers"},{"openapi":"get /v2/farcaster/following/","title":"Following","href":"/reference/fetch-user-following"},{"openapi":"get /v2/farcaster/following/suggested/","title":"Suggest Follows","href":"/reference/fetch-follow-suggestions"},{"openapi":"get /v2/farcaster/user/best_friends/","title":"Best friends","href":"/reference/best-friends"},{"group":"Update Follow / Unfollow","pages":[{"title":"Update Follow / Unfollow","sidebarTitle":"Overview","href":"/reference/update-follow-unfollow"},{"openapi":"post /v2/farcaster/user/follow/","title":"Follow user","href":"/reference/follow-user"},{"openapi":"delete /v2/farcaster/user/follow/","title":"Unfollow user","href":"/reference/unfollow-user"}]}]},{"group":"Mini Apps","pages":[{"group":"Notifications","pages":[{"openapi":"get /v2/farcaster/frame/notification_tokens/","title":"List of mini app notification tokens","href":"/reference/fetch-notification-tokens"},{"openapi":"post /v2/farcaster/frame/notifications/","title":"Send notifications","href":"/reference/publish-frame-notifications"}]},{"openapi":"get /v2/farcaster/frame/catalog/","title":"Mini apps catalog","href":"/reference/fetch-frame-catalog"},{"openapi":"get /v2/farcaster/frame/relevant/","title":"Relevant mini apps","href":"/reference/fetch-frame-relevant"},{"openapi":"get /v2/farcaster/frame/search/","title":"Search mini apps","href":"/reference/search-frames"}]},{"group":"Mini App Hosts","pages":[{"openapi":"get /v2/farcaster/app_host/user/event/","title":"Generate event","href":"/reference/app-host-get-event"},{"openapi":"post /v2/farcaster/app_host/user/event/","title":"Send event","href":"/reference/app-host-post-event"},{"openapi":"get /v2/farcaster/app_host/user/state/","title":"Enabled notifications","href":"/reference/app-host-get-user-state"}]},{"group":"Onchain","pages":[{"openapi":"get /v2/farcaster/user/balance/","title":"Token balance","href":"/reference/fetch-user-balance"},{"openapi":"get /v2/farcaster/fungible/owner/relevant/","title":"Relevant owners","href":"/reference/fetch-relevant-fungible-owners"},{"openapi":"get /v2/farcaster/fungible/trending/","title":"Trending fungibles","href":"/reference/fetch-trending-fungibles"},{"openapi":"get /v2/farcaster/fungibles/","title":"Fetch fungibles","href":"/reference/fetch-fungibles"},{"openapi":"get /v2/farcaster/fungible/trades/","title":"Get fungible trades","href":"/reference/fetch-fungible-trades"},{"openapi":"post /v2/farcaster/fungible/send/","title":"Send fungibles","href":"/reference/send-fungibles-to-users"},{"openapi":"post /v2/farcaster/user/register/","title":"Register Farcaster account onchain","href":"/reference/register-account-onchain"},{"openapi":"post /v2/signature/x402/","title":"Create x402 signature","href":"/reference/create-x402-signature"},{"group":"Subscribers","pages":[{"openapi":"get /v2/farcaster/user/subscriptions_created/","title":"Subscriptions created by FID","href":"/reference/fetch-subscriptions-for-fid"},{"openapi":"get /v2/farcaster/user/subscribed_to/","title":"Subscribed to","href":"/reference/fetch-subscribed-to-for-fid"},{"openapi":"get /v2/farcaster/user/subscribers/","title":"Subscribers of a user","href":"/reference/fetch-subscribers-for-fid"},{"openapi":"get /v2/stp/subscription_check/","title":"Hypersub subscription check","href":"/reference/fetch-subscription-check"}]},{"group":"NFTs","pages":[{"openapi":"post /v2/farcaster/nft/deploy/erc721/","title":"Deploy ERC-721 collection","href":"/reference/deploy-erc721"},{"openapi":"post /v2/farcaster/nft/image/","title":"Generate an NFT image","href":"/reference/generate-image"},{"openapi":"post /v2/farcaster/nft/metadata/token","title":"Upload NFT token metadata","href":"/reference/upload-token-metadata"},{"openapi":"get /v2/farcaster/nft/mint/","title":"Simulate NFT mint calldata","href":"/reference/get-nft-mint"},{"openapi":"post /v2/farcaster/nft/mint/","title":"Mint NFT(s)","href":"/reference/post-nft-mint"}]}]},{"group":"Agents","pages":[{"openapi":"get /v2/farcaster/cast/conversation/summary/","sidebarTitle":"Conversation summary","title":"Cast conversation summary","href":"/reference/lookup-cast-conversation-summary"},{"openapi":"get /v2/farcaster/user/interactions/","title":"User interactions","href":"/reference/fetch-user-interactions"},{"group":"Dynamic Transaction Frames","pages":[{"openapi":"post /v2/farcaster/frame/transaction/pay/","title":"Create transaction pay mini app","href":"/reference/create-transaction-pay-frame"},{"openapi":"get /v2/farcaster/frame/transaction/pay/","title":"Get transaction pay mini app","href":"/reference/get-transaction-pay-frame"}]}]},{"group":"Notifications","pages":[{"openapi":"get /v2/farcaster/notifications/","title":"For user","href":"/reference/fetch-all-notifications"},{"openapi":"get /v2/farcaster/notifications/channel/","title":"For user by channel","href":"/reference/fetch-channel-notifications-for-user"},{"openapi":"get /v2/farcaster/notifications/parent_url/","title":"For user by parent_urls","href":"/reference/fetch-notifications-by-parent-url-for-user"},{"openapi":"post /v2/farcaster/notifications/seen/","title":"Mark as seen","href":"/reference/mark-notifications-as-seen"}]},{"group":"Storage","pages":[{"openapi":"get /v2/farcaster/storage/allocations/","title":"Allocation of user","href":"/reference/lookup-user-storage-allocations"},{"openapi":"get /v2/farcaster/storage/usage/","title":"Usage of user","href":"/reference/lookup-user-storage-usage"},{"openapi":"post /v2/farcaster/storage/buy/","title":"Buy storage","href":"/reference/buy-storage"}]},{"group":"Channel","pages":[{"group":"Fetch Channel Info","pages":[{"openapi":"get /v2/farcaster/channel/search/","title":"Search by ID or name","href":"/reference/search-channels"},{"openapi":"get /v2/farcaster/channel/bulk/","title":"Bulk fetch","href":"/reference/fetch-bulk-channels"},{"openapi":"get /v2/farcaster/channel/","title":"By ID or parent_url","href":"/reference/lookup-channel"}]},{"group":"Members","pages":[{"openapi":"delete /v2/farcaster/channel/member/","title":"Remove user","href":"/reference/remove-channel-member"},{"openapi":"get /v2/farcaster/channel/member/list/","title":"Fetch members","href":"/reference/fetch-channel-members"},{"openapi":"post /v2/farcaster/channel/member/invite/","title":"Invite","href":"/reference/invite-channel-member"},{"openapi":"put /v2/farcaster/channel/member/invite/","title":"Accept or reject an invite","href":"/reference/respond-channel-invite"},{"openapi":"get /v2/farcaster/channel/member/invite/list/","title":"Open invites","href":"/reference/fetch-channel-invites"}]},{"group":"Fetch Followers","pages":[{"openapi":"get /v2/farcaster/channel/followers/","title":"For channel","href":"/reference/fetch-followers-for-a-channel"},{"openapi":"get /v2/farcaster/channel/followers/relevant/","title":"Relevant followers","href":"/reference/fetch-relevant-followers-for-a-channel"}]},{"group":"User's Channels","pages":[{"openapi":"get /v2/farcaster/user/channels/","title":"Following","href":"/reference/fetch-user-channels"},{"openapi":"get /v2/farcaster/user/memberships/list/","title":"Member of","href":"/reference/fetch-user-channel-memberships"},{"openapi":"post /v2/farcaster/channel/follow/","title":"Follow a channel","href":"/reference/follow-channel"},{"openapi":"delete /v2/farcaster/channel/follow/","title":"Unfollow a channel","href":"/reference/unfollow-channel"}]},{"group":"Trending","pages":[{"openapi":"get /v2/farcaster/channel/trending/","title":"Channels by activity","href":"/reference/fetch-trending-channels"}]},{"openapi":"get /v2/farcaster/channel/list/","title":"Fetch all channels with their details","href":"/reference/fetch-all-channels"},{"openapi":"get /v2/farcaster/channel/user/","title":"Fetch channels that user is active in","href":"/reference/fetch-users-active-channels"}]},{"group":"Fname","pages":[{"openapi":"get /v2/farcaster/fname/availability/","title":"Check fname availability","href":"/reference/is-fname-available"}]},{"group":"Webhook","pages":[{"openapi":"get /v2/farcaster/webhook/","title":"Fetch a webhook","href":"/reference/lookup-webhook"},{"openapi":"post /v2/farcaster/webhook/","title":"Create a webhook","href":"/reference/publish-webhook"},{"openapi":"patch /v2/farcaster/webhook/","title":"Update webhook status","href":"/reference/update-webhook-active-status"},{"openapi":"put /v2/farcaster/webhook/","title":"Update a webhook","href":"/reference/update-webhook"},{"openapi":"delete /v2/farcaster/webhook/","title":"Delete a webhook","href":"/reference/delete-webhook"},{"openapi":"get /v2/farcaster/webhook/list/","title":"Associated webhooks of user","href":"/reference/fetch-webhooks"}]},{"group":"Action","pages":[{"openapi":"post /v2/farcaster/action/","title":"User actions across apps","href":"/reference/publish-farcaster-action"}]},{"group":"Mute","pages":[{"openapi":"get /v2/farcaster/mute/list/","title":"Muted FIDs of user","href":"/reference/fetch-mute-list"},{"openapi":"post /v2/farcaster/mute/","title":"Mute FID","href":"/reference/publish-mute"},{"openapi":"delete /v2/farcaster/mute/","title":"Unmute FID","href":"/reference/delete-mute"}]},{"group":"Block","pages":[{"openapi":"get /v2/farcaster/block/list/","title":"Blocked / Blocked by FIDs","href":"/reference/fetch-block-list"},{"openapi":"post /v2/farcaster/block/","title":"Block FID","href":"/reference/publish-block"},{"openapi":"delete /v2/farcaster/block/","title":"Unblock FID","href":"/reference/delete-block"}]},{"group":"Ban","pages":[{"openapi":"get /v2/farcaster/ban/list/","title":"Banned FIDs of app","href":"/reference/fetch-ban-list"},{"openapi":"post /v2/farcaster/ban/","title":"Ban FIDs from app","href":"/reference/publish-bans"},{"openapi":"delete /v2/farcaster/ban/","title":"Unban FIDs from app","href":"/reference/delete-bans"}]},{"group":"Login","pages":[{"openapi":"get /v2/farcaster/login/nonce/","title":"Fetch nonce","href":"/reference/fetch-nonce"}]},{"group":"Metrics","pages":[{"openapi":"get /v2/farcaster/cast/metrics/","title":"Metrics for casts","href":"/reference/fetch-cast-metrics"}]}]},{"group":"Onchain","pages":[{"openapi":"get /v2/onchain/token/metadata","title":"Get token metadata","href":"/reference/get-token-metadata"},{"openapi":"get /v2/onchain/token/metadata/batch","title":"Batch get token metadata","href":"/reference/batch-get-token-metadata"},{"openapi":"get /v2/onchain/token/balances","title":"Get wallet token balances","href":"/reference/get-wallet-balances"}]},{"group":"Deploy onchain","pages":[{"openapi":"post /v2/fungible/","title":"Deploy fungible","href":"/reference/deploy-fungible"}]},{"group":"Farcaster Hub API","pages":[{"group":"Info","pages":[{"openapi":"get /v1/info","title":"Sync Methods","href":"/reference/lookup-hub-info"}]},{"group":"Casts","pages":[{"openapi":"get /v1/castById","title":"By FID and Hash","href":"/reference/lookup-cast-by-hash-and-fid"},{"openapi":"get /v1/castsByFid","title":"By FID","href":"/reference/fetch-users-casts-1"},{"openapi":"get /v1/castsByMention","title":"Mentioning an FID","href":"/reference/fetch-casts-mentioning-user"},{"openapi":"get /v1/castsByParent","title":"By parent cast","href":"/reference/fetch-casts-by-parent"}]},{"group":"Reactions","pages":[{"openapi":"get /v1/reactionById","title":"By FID or cast","href":"/reference/lookup-reaction-by-id"},{"openapi":"get /v1/reactionsByCast","title":"On cast","href":"/reference/fetch-cast-reactions-1"},{"openapi":"get /v1/reactionsByFid","title":"By FID","href":"/reference/fetch-user-reactions-1"},{"openapi":"get /v1/reactionsByTarget","title":"To a target URL","href":"/reference/fetch-reactions-by-target"}]},{"group":"Links","pages":[{"openapi":"get /v1/linkById","title":"By its FID and target FID","href":"/reference/lookup-user-relation"},{"openapi":"get /v1/linksByFid","title":"From source FID","href":"/reference/fetch-user-following-1"},{"openapi":"get /v1/linksByTargetFid","title":"To target FID","href":"/reference/fetch-user-followers-1"}]},{"group":"UserData","pages":[{"openapi":"get /v1/userDataByFid","title":"Fetch UserData for a FID","href":"/reference/fetch-user-data"}]},{"group":"Fids","pages":[{"openapi":"get /v1/fids","title":"Fetch a list of all the FIDs","href":"/reference/fetch-fids"}]},{"group":"Storage","pages":[{"openapi":"get /v1/storageLimitsByFid","title":"FID's limits","href":"/reference/lookup-user-storage-limit"}]},{"group":"Usernames","pages":[{"openapi":"get /v1/userNameProofsByFid","title":"Proofs provided by an FID","href":"/reference/fetch-username-proofs-by-fid"},{"openapi":"get /v1/userNameProofByName","title":"Proof for a username","href":"/reference/fetch-username-proof-by-name"}]},{"group":"Verifications","pages":[{"openapi":"get /v1/verificationsByFid","title":"Provided by an FID","href":"/reference/fetch-verifications-by-fid"}]},{"group":"OnChainEvents","pages":[{"openapi":"get /v1/onChainIdRegistryEventByAddress","title":"Fetch an on-chain ID Registry Event for a given Address","href":"/reference/lookup-on-chain-id-registry-event-by-address"},{"openapi":"get /v1/onChainEventsByFid","title":"Fetch a list of on-chain events provided by an FID","href":"/reference/fetch-user-on-chain-events"},{"openapi":"get /v1/onChainSignersByFid","title":"Fetch a list of signers provided by an FID","href":"/reference/fetch-user-on-chain-signers-events"}]},{"group":"Message","pages":[{"openapi":"post /v1/submitMessage","title":"Submit signed message","href":"/reference/publish-message"},{"openapi":"post /v1/validateMessage","title":"Validate signed message","href":"/reference/validate-message"}]},{"group":"HubEvents","pages":[{"openapi":"get /v1/events","title":"Page of events","href":"/reference/fetch-events"},{"openapi":"get /v1/eventById","title":"Event by ID","href":"/reference/lookup-event"}]}]},{"group":"Other SDKs","pages":[{"group":"Rust SDK","pages":[{"title":"Getting Started with Neynar Rust SDK","href":"/reference/getting-started-with-rust-sdk"}]},{"group":"Go SDK","pages":[{"title":"Getting Started with Neynar Go SDK","href":"/reference/getting-started-with-go-sdk"}]}]},{"group":"Github","pages":[{"title":"NodeJS-SDK","url":"https://github.com/neynarxyz/nodejs-sdk","href":"/external-link-1"},{"title":"Frontend React SDK","url":"https://github.com/neynarxyz/react/blob/main/README.md","href":"/external-link-2"},{"title":"OpenAPI Specification","url":"https://github.com/neynarxyz/OAS","href":"/external-link-3"},{"title":"Example Apps","url":"https://github.com/neynarxyz/farcaster-examples","href":"/external-link-4"}]}]},{"tab":"Node.js SDK","pages":[{"title":"Node.js SDK","href":"/nodejs-sdk/overview"}]},{"tab":"Mini Apps","pages":[{"title":"Mini Apps","href":"/miniapps/overview"}]},{"tab":"Learn","pages":[{"title":"Learn","href":"/farcaster/overview"}]},{"tab":"Snapchain","pages":[{"title":"Snapchain","href":"/snapchain/overview"}]},{"tab":"Get Help →","href":"mailto:support@ns.com"}]},"basePath":"","title":"Neynar Documentation","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}