Identity & Enrichment · x402 · early usage

Search Farcaster users by name or username fragment

Search Farcaster users by name or username fragment. Returns up to 10 compact profiles: fid, username, display name, bio, follower and following counts, Neynar quality score, primary verified Ethereum address. Use to resolve a person or brand to a fid before…

by agent402.tools · discovered, not yet claimed by its owner · updated 2026-10-08

30d calls3

30d payers3

MethodPOST

Outputjson

Mirrored from Coinbase's public x402 Bazaar. The description is the provider's own text and has not been reviewed here; the payment requirements are copied as published.

What it does

Tags: web · farcaster · social · user · search · bazaar · builder-code · payment-identifier

Call contract

Method: POST
Input: json
Output: json
Last paid call: 2026-10-08

Input example from Bazaar metadata

{
  "limit": 3,
  "q": "example"
}

Output example

{
  "cached": false,
  "count": 1,
  "fetchedAt": "2026-08-22T13:19:12.000Z",
  "nextCursor": null,
  "query": "example",
  "rateLimit": {
    "limit": 300,
    "remaining": 299,
    "resetAt": "2026-08-22T13:20:00.000Z"
  },
  "source": "neynar",
  "users": [
    {
      "bio": "Example profile used only to show the response shape.",
      "displayName": "Example User",
      "fid": 3,
      "followerCount": 630338,
      "followingCount": 77,
      "pfpUrl": "https://imagedelivery.net/.../original",
      "powerBadge": false,
      "primaryEthAddress": "0x6ce09ed5526de4afe4a981ad86d17b2f5c92fea5",
      "score": 0.99,
      "url": "https://warpcast.com/dwr",
      "username": "example-user"
    }
  ]
}

Use with an agent

Discover. Agents find this listing with GET https://bazaar.saylorinnovations.com/discovery/search?query=…, the MCP tool search_resources, or /discovery/resources.
Inspect. Fetch /resources/28114.json for the price and payment options.
Pay. Call GET https://agent402.tools/api/fc-user-search. The provider answers 402 with its payment requirements. An x402 client signs one of the options below and retries with PAYMENT-SIGNATURE.
Execute. The provider returns 200 with the data. Agent Bazaar is not in the request path and never sees your payment.

For humans

You don't need an account or an API key; you need a wallet holding a small amount of USDC on Base, Polygon, Arbitrum One, eip155:143, Avalanche, eip155:1329, Optimism, eip155:4663, eip155:42220, Solana, stellar:pubnet, algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=, and an x402-capable client (see the examples below). Call the endpoint unpaid first to see exactly what it asks for.

Pricing & payment

Price: $0.003 / request
Protocol: x402 v2
Auth: No account or API key. Pay per request.
Networks: Base, Polygon, Arbitrum One, eip155:143, Avalanche, eip155:1329, Optimism, eip155:4663, eip155:42220, Solana, stellar:pubnet, algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=
Demand: 3 calls · 3 unique payers in 30d (public x402 Bazaar data)

x402 payment requirements

Scheme	Network	Asset	Amount	Pay to	Timeout
exact	Base eip155:8453	USDC	$0.003	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Polygon eip155:137	USDC	$0.003	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Arbitrum One eip155:42161	USDC	$0.003	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:143 eip155:143	0x754704Bc059F8C67012fEd69BC8A327a5aafb603	3000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Avalanche eip155:43114	0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E	3000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:1329 eip155:1329	0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392	3000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Optimism eip155:10	0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85	4000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:4663 eip155:4663	0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168	3000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	eip155:42220 eip155:42220	0xcebA9300f2b948710d2653dD7B07f33A8B32118C	3000	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
upto	Base eip155:8453	USDC	$0.003	0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0	300s
exact	Solana solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp	USDC	$0.003	J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg	300s
exact	stellar:pubnet stellar:pubnet	CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75	30000	GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL	300s
exact	algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8= algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=	31566704	3000	C7IIHG7SPLPZ5H7ZT6HW3UV2OQMQQE6Y2HBNGZXSLRJULE42BEE2OY2XIE	300s

accepts[] (raw JSON)

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "amountUsd": 0.003,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:137",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "amount": "3000",
    "amountUsd": 0.003,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42161",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "3000",
    "amountUsd": 0.003,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:143",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x754704Bc059F8C67012fEd69BC8A327a5aafb603",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:43114",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:1329",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xe15fC38F6D8c56aF07bbCBe3BAf5708A2Bf42392",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:10",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
    "amount": "4000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:4663",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "eip155:42220",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "upto",
    "network": "eip155:8453",
    "payTo": "0xaBF4FAbd7c416fB67202E5f9002389Fc75e2a9D0",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "3000",
    "amountUsd": 0.003,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "J7aN3PLJnTCF5qpEnvJHJsnCjcGuqC2rYtEM8Gv3xwg",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "3000",
    "amountUsd": 0.003,
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "stellar:pubnet",
    "payTo": "GDNJXCKW7ZM7GEEVP674TWPU26YJNBQ2FI4ZIPRKTPTNUEJMDHFJWWRL",
    "asset": "CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75",
    "amount": "30000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "algorand:wGHE2Pwdvd7S12BL5FaOP20EGYesN73ktiC1qzkkit8=",
    "payTo": "C7IIHG7SPLPZ5H7ZT6HW3UV2OQMQQE6Y2HBNGZXSLRJULE42BEE2OY2XIE",
    "asset": "31566704",
    "amount": "3000",
    "maxTimeoutSeconds": 300
  }
]

Schemas

Output schema (JSON Schema)

{
  "properties": {
    "example": {
      "properties": {
        "cached": {
          "type": "boolean"
        },
        "count": {
          "type": "integer"
        },
        "fetchedAt": {
          "type": "string"
        },
        "nextCursor": {},
        "query": {
          "type": "string"
        },
        "rateLimit": {
          "properties": {
            "limit": {
              "type": "integer"
            },
            "remaining": {
              "type": "integer"
            },
            "resetAt": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "source": {
          "type": "string"
        },
        "users": {
          "items": {
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "source",
        "fetchedAt",
        "cached",
        "rateLimit",
        "query",
        "count",
        "users"
      ],
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}

Example shape — generated from the schema, not a captured live response

{
  "example": {
    "cached": true,
    "count": 0,
    "fetchedAt": "string",
    "nextCursor": null,
    "query": "string",
    "rateLimit": {
      "limit": 0,
      "remaining": 0,
      "resetAt": "string"
    },
    "source": "string",
    "users": [
      {}
    ]
  },
  "type": "string"
}

Examples

curl

curl "https://agent402.tools/api/fc-user-search"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

JavaScript

const res = await fetch("https://agent402.tools/api/fc-user-search");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

Python

import httpx
res = httpx.get("https://agent402.tools/api/fc-user-search")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header

Details

Provider: agent402.tools
Endpoint: https://agent402.tools/api/fc-user-search
Machine-readable: /resources/28114.json