Resolves many addresses in one request. Costs 1 match credit per address that resolves to an X handle or a Farcaster account, after duplicates are removed. Addresses that match nothing cost nothing.This is the endpoint to build on. Fifty single lookups and one fifty-wallet batch cost the same match credits, but the batch is one request instead of fifty and returns in a fraction of the time.Batch answers from the index, which is why it returns in milliseconds. For a list larger than a batch, or when the misses are worth re-checking against live sources, submit an async job instead: same billing rule, no per-request address ceiling, and live resolution on wallets the index has not checked. To know what a list would cost before sending it, run the free estimate first.
Headers
string
Optional retry protection. An opaque value up to 200 characters, such as a
UUID. Resending the identical request with the same key inside 24 hours
replays the stored response, marked Idempotency-Replayed: true, and bills
nothing. See retries below.
Body
string[]
required
Addresses to resolve, up to your plan’s max_batch_size: 50 on the default
plan, 200 with a live Scale pack, 1,000 with a live Index pack (see
plans). The whole body is capped at 1 MB.
One entry per unique address, in submission order. Entries are the same
object as single lookup, or null where nothing was
found. That includes twitter.also, a second X
account attested for the same
wallet, on the few records that have one. Each found entry also carries
last_updated and stale, the same freshness pair single lookup reports in
its meta, here per row because a batch has one meta for many rows.
object
Show properties
number
Unique addresses after deduplication.
number
How many resolved to at least one identity, including ENS, Lens and
GitHub.
number
How many resolved to an X handle or a Farcaster account. On a fresh
request this is the number billed, and it is never more than found. For
a replay, see retries.
number
Unique addresses with no identity at all: requested minus found.
object
Negative knowledge for the misses: wallet to ISO timestamp, for each
null entry we have checked before and found bare. A miss absent from
this map has never been examined. The whole field is absent when no miss
was previously checked; absent is not false. The single lookup makes the
same distinction with meta.checked_at.
Positions map to the deduplicated list, not to the array you sent. Submit
[A, B, A] and you get two entries back, not three. Deduplicate before you
send, then index by the wallet field rather than by position.
Differences from single lookup
Batch returns a deliberately lighter record. One thing present on
/v1/wallet/{address} is absent here:
No quality object.
stale and last_updatedare present as of 2026-09-01, per row rather
than in meta, and misses carry their checked-at time through
meta.previously_checked. Only the staleness response headers stay
single-lookup-only, since one header cannot describe fifty rows.farcaster.verified is present as of 2026-08-30, on the same terms as
single lookup, and so is twitter.verified. It was previously omitted here
alone, which meant a multi-address caller received an account without the class
of evidence behind it. Every match carries its evidence, and that has to hold on
the route that resolves the most of them.
twitter.verified widened on 20 September 2026. An X handle that came
from a Farcaster account’s verified accounts now reports true. It already
did when our Farcaster sweep wrote the row, and reported false when a live
lookup did, so the same evidence gave two answers depending on which path
reached the address last. If you treat verified as a filter, expect more
rows to pass it; none of them are new evidence, only evidence that was already
there being reported consistently.
The reachability fields and twitter.also are present here on the same terms
as on single lookup.If you are filtering on confidence, resolve in bulk with batch and then re-fetch
the shortlist through single lookup. It is usually a small number of addresses
and it is the only way to see the quality metadata.
Cost
Match credits are charged on the addresses that resolve to an X handle or a
Farcaster account, after deduplication. On a fresh request, meta.matched is
exactly that count; for a replay, see
retries.
An address that carries only an ENS name, a Lens profile or a GitHub account is
returned and counted in found, but not billed. Submitting [A, B, A] where A
matches and B does not costs 1 credit and returns 2 records. Deduplicating
still helps, because duplicates count against your rate limit even though they
are billed once.A batch that exceeds your batch limit is rejected whole with
BATCH_SIZE_EXCEEDED. Nothing is charged and nothing is partially processed, so
split oversized batches client-side and send the pieces.
Retries and the Idempotency-Key
A plain retry bills again, because it resolves again. Send an Idempotency-Key
header on any batch you might have to retry, and a resend of the identical
request replays the stored response instead:
The dedup is scoped to your API key and pinned to the exact request body, and
lasts 24 hours. A replay returns the original status and the original body,
less any removals (below), with an Idempotency-Replayed: true header, bills
no matches, and resolves nothing.
A replay honors removals made since the original request. An address or
account whose owner asked to be removed in the meantime is left out of the
replay exactly as a fresh request would leave it out, and found,
not_found and matched count what the replay returns, so matched can be
below what the original request billed. The replay itself bills nothing, and
your usage and balance remain the billing record.
Rate limits still apply to a replay: the request weight is spent at the gate,
before the store is consulted.
Reusing a key with a different body is refused with
422 IDEMPOTENCY_KEY_REUSED rather than silently answered with the older
list.
A response too large to store (over 256 KB, far beyond a full 50-address
batch) is recorded without a body; replaying it answers
409 IDEMPOTENCY_NOT_REPLAYABLE, and the fix is to resend under a fresh key,
knowingly billed as a new request.
Only a 200 consumes a key. A request that failed can be retried under the
same key into a success.
The window protects sequential retries, not concurrent duplicates: two copies
of the same request racing each other can both execute and both bill.
Serialize retries.
The balance gate runs before the replay store is consulted, so a key at zero
balance cannot replay even a stored response. If the batch that spent your
last credits lost its response in transit, read your usage rather than
retrying: the matches were billed and recorded.
Errors
INVALID_REQUEST, INVALID_ADDRESS, BATCH_SIZE_EXCEEDED,
IDEMPOTENCY_KEY_REUSED, IDEMPOTENCY_NOT_REPLAYABLE, plus the
standard errors.A single malformed address rejects the entire batch. The error message names the
first few offenders.
{"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":"6ae16601270944e7c88ad02f","clientVersion":"0.0.4177","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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/batch","slug":"/api-reference/batch","pageMetadata":{"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"},"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 many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\"\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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,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);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Resolves many addresses in one request. Costs `,_jsx(_components.strong,{children:`1 match credit per address that resolves`}),` to an X handle or a Farcaster account, after duplicates are removed. Addresses that match nothing cost nothing.`]}),`\n`,_jsx(_components.p,{children:`This is the endpoint to build on. Fifty single lookups and one fifty-wallet batch cost the same match credits, but the batch is one request instead of fifty and returns in a fraction of the time.`}),`\n`,_jsxs(_components.p,{children:[`Batch answers from the index, which is why it returns in milliseconds. For a list larger than a batch, or when the misses are worth re-checking against live sources, submit an `,_jsx(_components.a,{href:`/api-reference/jobs`,children:`async job`}),` instead: same billing rule, no per-request address ceiling, and live resolution on wallets the index has not checked. To know what a list would cost before sending it, run the free `,_jsx(_components.a,{href:`/api-reference/estimate`,children:`estimate`}),` first.`]}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,id:`param-idempotency-key`,children:_jsxs(_components.p,{children:[`Optional retry protection. An opaque value up to 200 characters, such as a\nUUID. Resending the identical request with the same key inside 24 hours\nreplays the stored response, marked `,_jsx(_components.code,{children:`Idempotency-Replayed: true`}),`, and bills\nnothing. See `,_jsx(_components.a,{href:`#retries-and-the-idempotency-key`,children:`retries`}),` below.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`body`,children:`Body`}),`\n`,_jsx(ParamField,{body:`wallets`,type:`string[]`,required:true,id:`param-wallets`,children:_jsxs(_components.p,{children:[`Addresses to resolve, up to your plan’s `,_jsx(_components.code,{children:`max_batch_size`}),`: 50 on the default\nplan, 200 with a live Scale pack, 1,000 with a live Index pack (see\n`,_jsx(_components.a,{href:`/api-reference/introduction#plans`,children:`plans`}),`). The whole body is capped at 1 MB.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`request`,children:`Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,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:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -X POST https://walletlink.social/api/v1/batch \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer wts_live_YOUR_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -d `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"wallets\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"0x00000000000000000000000000000000000000a1\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"0x0000000000000000000000000000000000000001\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`data`,type:`array`,id:`param-data`,children:_jsxs(_components.p,{children:[`One entry per `,_jsx(_components.strong,{children:`unique`}),` address, in submission order. Entries are the same\nobject as `,_jsx(_components.a,{href:`/api-reference/wallet`,children:`single lookup`}),`, or `,_jsx(_components.code,{children:`null`}),` where nothing was\nfound. That includes `,_jsx(_components.code,{children:`twitter.also`}),`, `,_jsx(_components.a,{href:`/api-reference/wallet#a-second-x-account`,children:`a second X\naccount`}),` attested for the same\nwallet, on the few records that have one. Each found entry also carries\n`,_jsx(_components.code,{children:`last_updated`}),` and `,_jsx(_components.code,{children:`stale`}),`, the same freshness pair single lookup reports in\nits `,_jsx(_components.code,{children:`meta`}),`, here per row because a batch has one `,_jsx(_components.code,{children:`meta`}),` for many rows.`]})}),`\n`,_jsx(ResponseField,{name:`meta`,type:`object`,id:`param-meta`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`requested`,type:`number`,id:`param-requested`,children:_jsx(_components.p,{children:`Unique addresses after deduplication.`})}),_jsx(ResponseField,{name:`found`,type:`number`,id:`param-found`,children:_jsx(_components.p,{children:`How many resolved to at least one identity, including ENS, Lens and\nGitHub.`})}),_jsx(ResponseField,{name:`matched`,type:`number`,id:`param-matched`,children:_jsxs(_components.p,{children:[`How many resolved to an X handle or a Farcaster account. On a fresh\nrequest this is the number billed, and it is never more than `,_jsx(_components.code,{children:`found`}),`. For\na replay, see `,_jsx(_components.a,{href:`#retries-and-the-idempotency-key`,children:`retries`}),`.`]})}),_jsx(ResponseField,{name:`not_found`,type:`number`,id:`param-not-found`,children:_jsxs(_components.p,{children:[`Unique addresses with no identity at all: `,_jsx(_components.code,{children:`requested`}),` minus `,_jsx(_components.code,{children:`found`}),`.`]})}),_jsx(ResponseField,{name:`previously_checked`,type:`object`,id:`param-previously-checked`,children:_jsxs(_components.p,{children:[`Negative knowledge for the misses: wallet to ISO timestamp, for each\n`,_jsx(_components.code,{children:`null`}),` entry we have checked before and found bare. A miss absent from\nthis map has never been examined. The whole field is absent when no miss\nwas previously checked; absent is not false. The single lookup makes the\nsame distinction with `,_jsx(_components.code,{children:`meta.checked_at`}),`.`]})})]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`27`,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:`27`,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`,_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:` \"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:` \"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`})]}),`\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:` \"last_updated\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-14T02:11:09.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:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` null`})}),`\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:` \"requested\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_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\":`#B5CEA8`},children:`1`}),_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:` \"matched\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_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:` \"not_found\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_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:` \"previously_checked\"`}),_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:` \"0x0000000000000000000000000000000000000001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-08-20T05:40: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(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Positions map to the `,_jsx(_components.strong,{children:`deduplicated`}),` list, not to the array you sent. Submit\n`,_jsx(_components.code,{children:`[A, B, A]`}),` and you get two entries back, not three. Deduplicate before you\nsend, then index by the `,_jsx(_components.code,{children:`wallet`}),` field rather than by position.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`differences-from-single-lookup`,children:`Differences from single lookup`}),`\n`,_jsxs(_components.p,{children:[`Batch returns a deliberately lighter record. One thing present on\n`,_jsx(_components.a,{href:`/api-reference/wallet`,children:_jsx(_components.code,{children:`/v1/wallet/{address}`})}),` is absent here:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`No `,_jsx(_components.code,{children:`quality`}),` object.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`stale`}),` and `,_jsx(_components.code,{children:`last_updated`}),` `,_jsx(_components.strong,{children:`are`}),` present as of 2026-09-01, per row rather\nthan in `,_jsx(_components.code,{children:`meta`}),`, and misses carry their checked-at time through\n`,_jsx(_components.code,{children:`meta.previously_checked`}),`. Only the staleness response headers stay\nsingle-lookup-only, since one header cannot describe fifty rows.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`farcaster.verified`}),` is present as of 2026-08-30, on the same terms as\nsingle lookup, and so is `,_jsx(_components.code,{children:`twitter.verified`}),`. It was previously omitted here\nalone, which meant a multi-address caller received an account without the class\nof evidence behind it. Every match carries its evidence, and that has to hold on\nthe route that resolves the most of them.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`twitter.verified`}),` widened on 20 September 2026.`]}),` An X handle that came\nfrom a Farcaster account’s verified accounts now reports `,_jsx(_components.code,{children:`true`}),`. It already\ndid when our Farcaster sweep wrote the row, and reported `,_jsx(_components.code,{children:`false`}),` when a live\nlookup did, so the same evidence gave two answers depending on which path\nreached the address last. If you treat `,_jsx(_components.code,{children:`verified`}),` as a filter, expect more\nrows to pass it; none of them are new evidence, only evidence that was already\nthere being reported consistently.`]})}),`\n`,_jsxs(_components.p,{children:[`The reachability fields and `,_jsx(_components.code,{children:`twitter.also`}),` are present here on the same terms\nas on single lookup.`]}),`\n`,_jsx(_components.p,{children:`If you are filtering on confidence, resolve in bulk with batch and then re-fetch\nthe shortlist through single lookup. It is usually a small number of addresses\nand it is the only way to see the quality metadata.`}),`\n`,_jsx(Heading,{level:`2`,id:`cost`,children:`Cost`}),`\n`,_jsxs(_components.p,{children:[`Match credits are charged on the addresses that `,_jsx(_components.strong,{children:`resolve to an X handle or a\nFarcaster account`}),`, after deduplication. On a fresh request, `,_jsx(_components.code,{children:`meta.matched`}),` is\nexactly that count; for a replay, see\n`,_jsx(_components.a,{href:`#retries-and-the-idempotency-key`,children:`retries`}),`.\nAn address that carries only an ENS name, a Lens profile or a GitHub account is\nreturned and counted in `,_jsx(_components.code,{children:`found`}),`, but not billed. Submitting `,_jsx(_components.code,{children:`[A, B, A]`}),` where A\nmatches and B does not costs 1 credit and returns 2 records. Deduplicating\nstill helps, because duplicates count against your rate limit even though they\nare billed once.`]}),`\n`,_jsxs(_components.p,{children:[`A batch that exceeds your batch limit is rejected whole with\n`,_jsx(_components.code,{children:`BATCH_SIZE_EXCEEDED`}),`. Nothing is charged and nothing is partially processed, so\nsplit oversized batches client-side and send the pieces.`]}),`\n`,_jsx(Heading,{level:`2`,id:`retries-and-the-idempotency-key`,children:`Retries and the Idempotency-Key`}),`\n`,_jsxs(_components.p,{children:[`A plain retry bills again, because it resolves again. Send an `,_jsx(_components.code,{children:`Idempotency-Key`}),`\nheader on any batch you might have to retry, and a resend of the identical\nrequest replays the stored response instead:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The dedup is scoped to your API key and pinned to the exact request body, and\nlasts 24 hours. A replay returns the original status and the original body,\nless any removals (below), with an `,_jsx(_components.code,{children:`Idempotency-Replayed: true`}),` header, bills\nno matches, and resolves nothing.`]}),`\n`,_jsxs(_components.li,{children:[`A replay honors removals made since the original request. An address or\naccount whose owner asked to be removed in the meantime is left out of the\nreplay exactly as a fresh request would leave it out, and `,_jsx(_components.code,{children:`found`}),`,\n`,_jsx(_components.code,{children:`not_found`}),` and `,_jsx(_components.code,{children:`matched`}),` count what the replay returns, so `,_jsx(_components.code,{children:`matched`}),` can be\nbelow what the original request billed. The replay itself bills nothing, and\nyour usage and balance remain the billing record.`]}),`\n`,_jsx(_components.li,{children:`Rate limits still apply to a replay: the request weight is spent at the gate,\nbefore the store is consulted.`}),`\n`,_jsxs(_components.li,{children:[`Reusing a key with a `,_jsx(_components.strong,{children:`different`}),` body is refused with\n`,_jsx(_components.code,{children:`422 IDEMPOTENCY_KEY_REUSED`}),` rather than silently answered with the older\nlist.`]}),`\n`,_jsxs(_components.li,{children:[`A response too large to store (over 256 KB, far beyond a full 50-address\nbatch) is recorded without a body; replaying it answers\n`,_jsx(_components.code,{children:`409 IDEMPOTENCY_NOT_REPLAYABLE`}),`, and the fix is to resend under a fresh key,\nknowingly billed as a new request.`]}),`\n`,_jsxs(_components.li,{children:[`Only a `,_jsx(_components.code,{children:`200`}),` consumes a key. A request that failed can be retried under the\nsame key into a success.`]}),`\n`,_jsx(_components.li,{children:`The window protects sequential retries, not concurrent duplicates: two copies\nof the same request racing each other can both execute and both bill.\nSerialize retries.`}),`\n`,_jsx(_components.li,{children:`The balance gate runs before the replay store is consulted, so a key at zero\nbalance cannot replay even a stored response. If the batch that spent your\nlast credits lost its response in transit, read your usage rather than\nretrying: the matches were billed and recorded.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`INVALID_REQUEST`}),`, `,_jsx(_components.code,{children:`INVALID_ADDRESS`}),`, `,_jsx(_components.code,{children:`BATCH_SIZE_EXCEEDED`}),`,\n`,_jsx(_components.code,{children:`IDEMPOTENCY_KEY_REUSED`}),`, `,_jsx(_components.code,{children:`IDEMPOTENCY_NOT_REPLAYABLE`}),`, plus the\n`,_jsx(_components.a,{href:`/api-reference/errors`,children:`standard errors`}),`.`]}),`\n`,_jsx(_components.p,{children:`A single malformed address rejects the entire batch. The error message names the\nfirst few offenders.`})]})}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":"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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Body","slug":"body","depth":2,"children":[]},{"title":"Request","slug":"request","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Differences from single lookup","slug":"differences-from-single-lookup","depth":2,"children":[]},{"title":"Cost","slug":"cost","depth":2,"children":[]},{"title":"Retries and the Idempotency-Key","slug":"retries-and-the-idempotency-key","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Batch lookup","path":"/api/v1/batch","servers":[{"url":"https://walletlink.social"}],"method":"post","request":{"security":[],"parameters":{"query":{},"header":{"Idempotency-Key":{"schema":[{"type":"string","description":"Optional retry protection. An opaque value up to 200 characters, such as a UUID. Resending the identical request with the same key inside 24 hours replays the stored response, marked `Idempotency-Replayed: true` , and bills nothing. See retries below."}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"wallets":[{"type":"array","items":[{"type":"string"}],"description":"Addresses to resolve, up to your plan’s `max_batch_size` : 50 on the default plan, 200 with a live Scale pack, 1,000 with a live Index pack (see plans ). The whole body is capped at 1 MB.","required":true}]}}],"examples":{"example":{"value":{"wallets":["\u003cstring>"]}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"One entry per unique address, in submission order. Entries are the same object as single lookup , or `null` where nothing was found. That includes `twitter.also` , a second X account attested for the same wallet, on the few records that have one. Each found entry also carries `last_updated` and `stale` , the same freshness pair single lookup reports in its `meta` , here per row because a batch has one `meta` for many rows."}],"meta":[{"type":"object","properties":{"requested":[{"type":"number","description":"Unique addresses after deduplication."}],"found":[{"type":"number","description":"How many resolved to at least one identity, including ENS, Lens and GitHub."}],"matched":[{"type":"number","description":"How many resolved to an X handle or a Farcaster account. On a fresh request this is the number billed, and it is never more than `found` . For a replay, see retries ."}],"not_found":[{"type":"number","description":"Unique addresses with no identity at all: `requested` minus `found` ."}],"previously_checked":[{"type":"object","properties":{},"description":"Negative knowledge for the misses: wallet to ISO timestamp, for each `null` entry we have checked before and found bare. A miss absent from this map has never been examined. The whole field is absent when no miss was previously checked; absent is not false. The single lookup makes the same distinction with `meta.checked_at` ."}]}}]}}],"examples":{"example":{"value":{"data":[{}],"meta":{"requested":123,"found":123,"matched":123,"not_found":123,"previously_checked":{}}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"walletlink","siteName":"walletlink.social","title":"Batch lookup - walletlink.social","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T21:41:07.603Z","originalFileLocation":"api-reference/batch.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 many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\">\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=\"Batch lookup - walletlink.social\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\">\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/batch\">\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=Batch+lookup\u0026amp;description=Resolve+many+addresses+from+the+index+in+one+request%2C+for+1+match+credit+per+address+that+resolves+to+X+or+Farcaster.\u0026amp;theme=a33f390d9f66a2cfd68d4de4\u0026amp;signature=ffd194da135ee0c9a2c60455ec0d4f92398ea322cf87356cb7984bf1ea56dfec\">\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=\"Batch lookup - walletlink.social\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://walletlink.mintlify.site/_mintlify/api/og/v2?division=Lookups\u0026amp;title=Batch+lookup\u0026amp;description=Resolve+many+addresses+from+the+index+in+one+request%2C+for+1+match+credit+per+address+that+resolves+to+X+or+Farcaster.\u0026amp;theme=a33f390d9f66a2cfd68d4de4\u0026amp;signature=ffd194da135ee0c9a2c60455ec0d4f92398ea322cf87356cb7984bf1ea56dfec\">\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/batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/batch.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/batch#webpage\",\"url\":\"https://docs.walletlink.social/api-reference/batch\",\"name\":\"Batch lookup\",\"description\":\"Resolve many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\",\"dateModified\":\"2026-09-29T21:41:07.603Z\",\"isPartOf\":{\"@id\":\"https://docs.walletlink.social#website\"},\"breadcrumb\":{\"@id\":\"https://docs.walletlink.social/api-reference/batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.walletlink.social/api-reference/batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Lookups\",\"item\":\"https://docs.walletlink.social/api-reference/wallet\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Batch lookup\",\"item\":\"https://docs.walletlink.social/api-reference/batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.walletlink.social/api-reference/batch#apireference\",\"headline\":\"Batch lookup\",\"name\":\"Batch lookup\",\"description\":\"Resolve many addresses from the index in one request, for 1 match credit per address that resolves to X or Farcaster.\",\"url\":\"https://docs.walletlink.social/api-reference/batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.walletlink.social/api-reference/batch#webpage\"},\"dateModified\":\"2026-09-29T21:41:07.603Z\",\"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/batch.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","href":"/api-reference/errors"}]},{"group":"Lookups","pages":[{"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"},{"title":"Batch lookup","api":"POST https://walletlink.social/api/v1/batch","href":"/api-reference/batch"},{"title":"Estimate","description":"A free dry run over a list: how many addresses are in the index, checked and bare, or never seen, and the band a resolve would bill inside.","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":"Batch lookup - walletlink.social","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js"]}