FETCH402
← Protocol index

Resource / 84

healthy

Unnamed resource.

GET https://x402.twit.sh/users/by/username ↗

Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON.

Eligibility
probeable
Failures
0
Last quote
2026-08-12 21:30:02 UTC
Last probe
2026-08-12 21:30:02 UTC
Payment requirements / accepts[] 1 options
State Network Scheme Atomic amount Asset payTo / untrusted
active eip155:8453 exact 5000 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8

All advertised payment options are stored. Base (`eip155:8453`) is the operational network for ranking and canaries; non-Base options remain visible for transparency.

Probe evidence 1 recent
healthy 2026-08-12 21:30:02 UTC GET · HTTP 402 · 98ms · accepts 1 · base 1 ok
Request
GET https://x402.twit.sh/users/by/username
Robots
error
Note
robots_error:{:robots_http_status, 404};http_402;accepts=1;base=1
Accepts fingerprint
98deec8809c3d02af271ea102291bdbf909291833b65c31d489e6401b0b75ead

Accepts snapshot

[
  {
    "amount": "5000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetTransferMethod": null,
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "maxTimeoutSeconds": 300,
    "network": "eip155:8453",
    "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
    "paymentFlow": null,
    "raw": {
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "max_timeout_seconds": 300,
      "network": "eip155:8453",
      "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "pay_to": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "scheme": "exact"
    },
    "scheme": "exact"
  }
]

PaymentRequired raw 

{
  "accepts": [
    {
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "network": "eip155:8453",
      "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
      "scheme": "exact"
    }
  ],
  "error": "Payment required",
  "extensions": {
    "bazaar": {
      "category": "api",
      "discoverable": true,
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "username": "elonmusk"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "data": {
              "description": "Running bitcoin.",
              "id": "9253672",
              "name": "Hal Finney",
              "public_metrics": {
                "followers_count": 134000,
                "following_count": 200,
                "like_count": 300,
                "tweet_count": 600
              },
              "username": "halfin",
              "verified": false
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "username": {
                    "description": "Twitter screen name without @",
                    "type": "string"
                  }
                },
                "required": [
                  "username"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      },
      "tags": [
        "twitter",
        "x",
        "social",
        "user",
        "profile",
        "lookup",
        "username",
        "screen-name",
        "followers",
        "bio",
        "verification",
        "agent",
        "x402"
      ]
    },
    "builder-code": {
      "info": {
        "a": "bc_qobj93ib"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": false,
        "properties": {
          "a": {
            "description": "App builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          },
          "s": {
            "description": "Service builder codes",
            "items": {
              "pattern": "^[a-z0-9_]{1,32}$",
              "type": "string"
            },
            "type": "array"
          },
          "w": {
            "description": "Wallet builder code",
            "pattern": "^[a-z0-9_]{1,32}$",
            "type": "string"
          }
        },
        "type": "object"
      }
    }
  },
  "resource": {
    "description": "Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON.",
    "mimeType": "application/json",
    "url": "https://x402.twit.sh/users/by/username"
  },
  "x402Version": 2
}

Response headers

{
  "access-control-allow-origin": "*",
  "access-control-expose-headers": "PAYMENT-REQUIRED,PAYMENT-RESPONSE,X-PAYMENT-RESPONSE",
  "connection": "keep-alive",
  "content-length": "2",
  "content-type": "application/json; charset=utf-8",
  "date": "Wed, 12 Aug 2026 21:30:02 GMT",
  "etag": "W/\"2-vyGp6PvFo4RvsFtPoIWeCReyIC8\"",
  "payment-required": "eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly94NDAyLnR3aXQuc2gvdXNlcnMvYnkvdXNlcm5hbWUiLCJkZXNjcmlwdGlvbiI6Ikxvb2sgdXAgYSBUd2l0dGVyL1ggdXNlciBwcm9maWxlIGJ5IHRoZWlyIHNjcmVlbiBuYW1lLiBSZXR1cm5zIGZ1bGwgcHJvZmlsZSBkYXRhIGluY2x1ZGluZyBpZCwgbmFtZSwgdXNlcm5hbWUsIGJpbywgZm9sbG93ZXIgY291bnQsIGZvbGxvd2luZyBjb3VudCwgdHdlZXQgY291bnQsIHZlcmlmaWNhdGlvbiBzdGF0dXMsIGFuZCBwcm9maWxlIGltYWdlIFVSTC4gUXVlcnkgcGFyYW06IHVzZXJuYW1lIChzdHJpbmcsIHJlcXVpcmVkKSAtIFR3aXR0ZXIgc2NyZWVuIG5hbWUgd2l0aG91dCBALCBlLmcuIEdFVCAvdXNlcnMvYnkvdXNlcm5hbWU/dXNlcm5hbWU9ZWxvbm11c2suIFJldHVybnMgWCB2MiBBUEktY29tcGF0aWJsZSBKU09OLiIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFtb3VudCI6IjUwMDAiLCJhc3NldCI6IjB4ODMzNTg5ZkNENmVEYjZFMDhmNGM3QzMyRDRmNzFiNTRiZEEwMjkxMyIsInBheVRvIjoiMHg5ZEJBNDE0NjM3YzYxMWExNkJFYTZmMDc5NkJGY2JjQmRjNDEwZGY4IiwibWF4VGltZW91dFNlY29uZHMiOjMwMCwiZXh0cmEiOnsibmFtZSI6IlVTRCBDb2luIiwidmVyc2lvbiI6IjIifX1dLCJleHRlbnNpb25zIjp7ImJhemFhciI6eyJkaXNjb3ZlcmFibGUiOnRydWUsImNhdGVnb3J5IjoiYXBpIiwidGFncyI6WyJ0d2l0dGVyIiwieCIsInNvY2lhbCIsInVzZXIiLCJwcm9maWxlIiwibG9va3VwIiwidXNlcm5hbWUiLCJzY3JlZW4tbmFtZSIsImZvbGxvd2VycyIsImJpbyIsInZlcmlmaWNhdGlvbiIsImFnZW50IiwieDQwMiJdLCJpbmZvIjp7ImlucHV0Ijp7InR5cGUiOiJodHRwIiwicXVlcnlQYXJhbXMiOnsidXNlcm5hbWUiOiJlbG9ubXVzayJ9LCJtZXRob2QiOiJHRVQifSwib3V0cHV0Ijp7InR5cGUiOiJqc29uIiwiZXhhbXBsZSI6eyJkYXRhIjp7ImlkIjoiOTI1MzY3MiIsIm5hbWUiOiJIYWwgRmlubmV5IiwidXNlcm5hbWUiOiJoYWxmaW4iLCJkZXNjcmlwdGlvbiI6IlJ1bm5pbmcgYml0Y29pbi4iLCJ2ZXJpZmllZCI6ZmFsc2UsInB1YmxpY19tZXRyaWNzIjp7ImZvbGxvd2Vyc19jb3VudCI6MTM0MDAwLCJmb2xsb3dpbmdfY291bnQiOjIwMCwidHdlZXRfY291bnQiOjYwMCwibGlrZV9jb3VudCI6MzAwfX19fX0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIkdFVCJdfSwicXVlcnlQYXJhbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidXNlcm5hbWUiOnsidHlwZSI6InN0cmluZyIsImRlc2NyaXB0aW9uIjoiVHdpdHRlciBzY3JlZW4gbmFtZSB3aXRob3V0IEAifX0sInJlcXVpcmVkIjpbInVzZXJuYW1lIl19fSwicmVxdWlyZWQiOlsidHlwZSIsIm1ldGhvZCJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9LCJvdXRwdXQiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidHlwZSI6eyJ0eXBlIjoic3RyaW5nIn0sImV4YW1wbGUiOnsidHlwZSI6Im9iamVjdCJ9fSwicmVxdWlyZWQiOlsidHlwZSJdfX0sInJlcXVpcmVkIjpbImlucHV0Il19fSwiYnVpbGRlci1jb2RlIjp7ImluZm8iOnsiYSI6ImJjX3FvYmo5M2liIn0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJhIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlthLXowLTlfXXsxLDMyfSQiLCJkZXNjcmlwdGlvbiI6IkFwcCBidWlsZGVyIGNvZGUifSwidyI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il5bYS16MC05X117MSwzMn0kIiwiZGVzY3JpcHRpb24iOiJXYWxsZXQgYnVpbGRlciBjb2RlIn0sInMiOnsidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsidHlwZSI6InN0cmluZyIsInBhdHRlcm4iOiJeW2EtejAtOV9dezEsMzJ9JCJ9LCJkZXNjcmlwdGlvbiI6IlNlcnZpY2UgYnVpbGRlciBjb2RlcyJ9fSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOmZhbHNlfX19fQ==",
  "server": "railway-hikari",
  "x-hikari-trace": "iad1.fp5t",
  "x-powered-by": "Express",
  "x-railway-edge": "iad1",
  "x-railway-request-id": "9r8ox219Qc-xE3guYqdHTg"
}

Response body 

{}

Request headers

{
  "accept": "*/*",
  "user-agent": "Fetch402Bot/0.1 (+https://fetch402.com/crawler; contact: crawler@fetch402.com)"
}

Machine contract

Schemas.

InputJSON
{
  "method": "GET",
  "queryParams": {
    "username": "elonmusk"
  },
  "type": "http"
}
OutputJSON
{
  "example": {
    "data": {
      "description": "Running bitcoin.",
      "id": "9253672",
      "name": "Hal Finney",
      "public_metrics": {
        "followers_count": 134000,
        "following_count": 200,
        "like_count": 300,
        "tweet_count": 600
      },
      "username": "halfin",
      "verified": false
    }
  },
  "type": "json"
}