Farcaster by Ethereum address · Farcaster BY Address

by Farcaster by Ethereum address

POSTBaseSolanaArbitrumPolygonMonadAvalancheeip155:1329OptimismFraxtaleip155:42220stellar:pubnetalgorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=

$0.002

per call · USD Coin on Base

Reverse-lookup an Ethereum address to its Farcaster account (via verified address). Returns FID, username, display name, bio, follower/following counts, and Warpcast URL, or found=false if the address has not verified on Farcaster. Use to label wallet activity with the owner's Farcaster identity when ENS is missing.

Endpoint

POST https://agent402.tools/api/farcaster-by-address

4

Calls / 30d

1

Unique payers / 30d

Aug 31

Last called

exact

Payment scheme

Call this service

TypeScript · @x402/fetch
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://agent402.tools/api/farcaster-by-address", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "0xd7029bdea1c17493893aafe29aad69ef892b8ff2"
  }),
});
const data = await res.json();
cURL
curl -X POST \
  "https://agent402.tools/api/farcaster-by-address" \
  -H "Content-Type: application/json" \
  -d '{"address":"0xd7029bdea1c17493893aafe29aad69ef892b8ff2"}' \
  -H "X-PAYMENT: <signed x402 payment>"

Example response

{
  "address": "0xd7029bdea1c17493893aafe29aad69ef892b8ff2",
  "bio": "Working on Farcaster.",
  "displayName": "Dan Romero",
  "fid": 3,
  "followerCount": 500000,
  "followingCount": 1000,
  "found": true,
  "pfpUrl": "https://...",
  "source": "neynar",
  "username": "dwr",
  "venueUrl": "https://warpcast.com/dwr"
}

Payment details

Pay to0xabf4fabd7c416fb67202e5f9002389fc75e2a9d0
AssetUSD Coin · 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913
NetworksBase, Solana, Arbitrum, Polygon, Monad, Avalanche, eip155:1329, Optimism, Fraxtal, eip155:42220, stellar:pubnet, algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=
Schemesexact, upto

Is this your API?

Pin it to the top of Social & Community and the homepage with a featured placement.

Get featured →

More from Farcaster by Ethereum address & similar services