# walletlink.social

> 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.

- [walletlink.social](https://docs.walletlink.social/index.md): Resolve wallet addresses to the people behind them, in both directions.
- [Quickstart](https://docs.walletlink.social/quickstart.md): From nothing to your first resolved wallet.
- [Running a lookup](https://docs.walletlink.social/app/lookups.md): Getting addresses in, choosing how hard to look, and getting results back out.
- [MCP server](https://docs.walletlink.social/mcp-server.md): Eight tools that let an agent resolve wallets to social identities, over the same API and the same balance.
- [Agent pack (x402)](https://docs.walletlink.social/agent-pack.md): Buy match credits with USDC on Base. No account, no card, no email.
- [Coverage](https://docs.walletlink.social/concepts/coverage.md): What fraction of a wallet list resolves, and what the number actually means.
- [Scan depth](https://docs.walletlink.social/concepts/scan-depth.md): Fast reads the index. Deep asks every live source. Which one you want, and why.
- [Data quality](https://docs.walletlink.social/concepts/data-quality.md): How matches are attested, what the quality score means, and when a record goes stale.
- [Introduction](https://docs.walletlink.social/api-reference/introduction.md): Base URL, authentication, plans, and the conventions every endpoint follows.
- [Rate limits](https://docs.walletlink.social/api-reference/rate-limits.md): Three windows, the headers that report them, and how to back off correctly.
- [Errors](https://docs.walletlink.social/api-reference/errors.md): Error shape and every code the API returns.
- [Look up a wallet](https://docs.walletlink.social/api-reference/wallet.md): GET /v1/wallet/{address}
- [Batch lookup](https://docs.walletlink.social/api-reference/batch.md): POST /v1/batch
- [Estimate](https://docs.walletlink.social/api-reference/estimate.md): POST /v1/estimate
- [Async jobs](https://docs.walletlink.social/api-reference/jobs.md): POST /v1/jobs and GET /v1/jobs/{id}
- [Reverse X lookup](https://docs.walletlink.social/api-reference/reverse-twitter.md): GET /v1/reverse/twitter/{handle}
- [Reverse Farcaster lookup](https://docs.walletlink.social/api-reference/reverse-farcaster.md): GET /v1/reverse/farcaster/{username}
- [Index stats](https://docs.walletlink.social/api-reference/stats.md): GET /v1/stats
- [Usage](https://docs.walletlink.social/api-reference/usage.md): GET /v1/usage

## OpenAPI Specs

- [openapi](/openapi.yaml)