FETCH402
← Protocol index

Resource / 75

healthy

Unnamed resource.

Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?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 10000 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 · 99ms · accepts 1 · base 1 ok
Request
GET https://x402.twit.sh/tweets/user
Robots
error
Note
robots_error:{:robots_http_status, 404};http_402;accepts=1;base=1
Accepts fingerprint
7a7cbe75932cdf333c20a5b49f727ab8f7847450910a37e27a3d4e709e113c02

Accepts snapshot

[
  {
    "amount": "10000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetTransferMethod": null,
    "extra": {
      "name": "USD Coin",
      "version": "2"
    },
    "maxTimeoutSeconds": 300,
    "network": "eip155:8453",
    "payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
    "paymentFlow": null,
    "raw": {
      "amount": "10000",
      "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": "10000",
      "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": [
              {
                "author": {
                  "id": "9253672",
                  "name": "Hal Finney",
                  "username": "halfin"
                },
                "created_at": "2009-01-11T03:39:18.000Z",
                "id": "1110302988",
                "public_metrics": {
                  "like_count": 134000,
                  "quote_count": 3500,
                  "reply_count": 5400,
                  "retweet_count": 32000
                },
                "text": "Running bitcoin"
              }
            ],
            "meta": {
              "next_token": "abc123"
            }
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "next_token": {
                    "description": "Pagination cursor from previous response",
                    "type": "string"
                  },
                  "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",
        "tweets",
        "timeline",
        "posts",
        "user",
        "paginated",
        "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": "Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON.",
    "mimeType": "application/json",
    "url": "https://x402.twit.sh/tweets/user"
  },
  "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": "eyJ4NDAyVmVyc2lvbiI6MiwiZXJyb3IiOiJQYXltZW50IHJlcXVpcmVkIiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly94NDAyLnR3aXQuc2gvdHdlZXRzL3VzZXIiLCJkZXNjcmlwdGlvbiI6IkdldCB0aGUgbGF0ZXN0IHR3ZWV0cyAodGltZWxpbmUpIGZyb20gYSBzcGVjaWZpYyBUd2l0dGVyL1ggdXNlciBieSB0aGVpciB1c2VybmFtZS4gUmV0dXJucyB1cCB0byAyMCB0d2VldHMgcGVyIHBhZ2Ugc29ydGVkIGJ5IG1vc3QgcmVjZW50IGZpcnN0LCB3aXRoIHBhZ2luYXRpb24gc3VwcG9ydC4gUXVlcnkgcGFyYW1zOiB1c2VybmFtZSAoc3RyaW5nLCByZXF1aXJlZCkgLSBUd2l0dGVyIHNjcmVlbiBuYW1lOyBuZXh0X3Rva2VuIChzdHJpbmcsIG9wdGlvbmFsKSAtIHBhZ2luYXRpb24gY3Vyc29yLCBlLmcuIEdFVCAvdHdlZXRzL3VzZXI/dXNlcm5hbWU9ZWxvbm11c2suIFJldHVybnMgWCB2MiBBUEktY29tcGF0aWJsZSBKU09OLiIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiJ9LCJhY2NlcHRzIjpbeyJzY2hlbWUiOiJleGFjdCIsIm5ldHdvcmsiOiJlaXAxNTU6ODQ1MyIsImFtb3VudCI6IjEwMDAwIiwiYXNzZXQiOiIweDgzMzU4OWZDRDZlRGI2RTA4ZjRjN0MzMkQ0ZjcxYjU0YmRBMDI5MTMiLCJwYXlUbyI6IjB4OWRCQTQxNDYzN2M2MTFhMTZCRWE2ZjA3OTZCRmNiY0JkYzQxMGRmOCIsIm1heFRpbWVvdXRTZWNvbmRzIjozMDAsImV4dHJhIjp7Im5hbWUiOiJVU0QgQ29pbiIsInZlcnNpb24iOiIyIn19XSwiZXh0ZW5zaW9ucyI6eyJiYXphYXIiOnsiZGlzY292ZXJhYmxlIjp0cnVlLCJjYXRlZ29yeSI6ImFwaSIsInRhZ3MiOlsidHdpdHRlciIsIngiLCJzb2NpYWwiLCJ0d2VldHMiLCJ0aW1lbGluZSIsInBvc3RzIiwidXNlciIsInBhZ2luYXRlZCIsImFnZW50IiwieDQwMiJdLCJpbmZvIjp7ImlucHV0Ijp7InR5cGUiOiJodHRwIiwicXVlcnlQYXJhbXMiOnsidXNlcm5hbWUiOiJlbG9ubXVzayJ9LCJtZXRob2QiOiJHRVQifSwib3V0cHV0Ijp7InR5cGUiOiJqc29uIiwiZXhhbXBsZSI6eyJkYXRhIjpbeyJpZCI6IjExMTAzMDI5ODgiLCJ0ZXh0IjoiUnVubmluZyBiaXRjb2luIiwiY3JlYXRlZF9hdCI6IjIwMDktMDEtMTFUMDM6Mzk6MTguMDAwWiIsImF1dGhvciI6eyJpZCI6IjkyNTM2NzIiLCJ1c2VybmFtZSI6ImhhbGZpbiIsIm5hbWUiOiJIYWwgRmlubmV5In0sInB1YmxpY19tZXRyaWNzIjp7Imxpa2VfY291bnQiOjEzNDAwMCwicmV0d2VldF9jb3VudCI6MzIwMDAsInJlcGx5X2NvdW50Ijo1NDAwLCJxdW90ZV9jb3VudCI6MzUwMH19XSwibWV0YSI6eyJuZXh0X3Rva2VuIjoiYWJjMTIzIn19fX0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIkdFVCJdfSwicXVlcnlQYXJhbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidXNlcm5hbWUiOnsidHlwZSI6InN0cmluZyIsImRlc2NyaXB0aW9uIjoiVHdpdHRlciBzY3JlZW4gbmFtZSAod2l0aG91dCBAKSJ9LCJuZXh0X3Rva2VuIjp7InR5cGUiOiJzdHJpbmciLCJkZXNjcmlwdGlvbiI6IlBhZ2luYXRpb24gY3Vyc29yIGZyb20gcHJldmlvdXMgcmVzcG9uc2UifX0sInJlcXVpcmVkIjpbInVzZXJuYW1lIl19fSwicmVxdWlyZWQiOlsidHlwZSIsIm1ldGhvZCJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9LCJvdXRwdXQiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsidHlwZSI6eyJ0eXBlIjoic3RyaW5nIn0sImV4YW1wbGUiOnsidHlwZSI6Im9iamVjdCJ9fSwicmVxdWlyZWQiOlsidHlwZSJdfX0sInJlcXVpcmVkIjpbImlucHV0Il19fSwiYnVpbGRlci1jb2RlIjp7ImluZm8iOnsiYSI6ImJjX3FvYmo5M2liIn0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJhIjp7InR5cGUiOiJzdHJpbmciLCJwYXR0ZXJuIjoiXlthLXowLTlfXXsxLDMyfSQiLCJkZXNjcmlwdGlvbiI6IkFwcCBidWlsZGVyIGNvZGUifSwidyI6eyJ0eXBlIjoic3RyaW5nIiwicGF0dGVybiI6Il5bYS16MC05X117MSwzMn0kIiwiZGVzY3JpcHRpb24iOiJXYWxsZXQgYnVpbGRlciBjb2RlIn0sInMiOnsidHlwZSI6ImFycmF5IiwiaXRlbXMiOnsidHlwZSI6InN0cmluZyIsInBhdHRlcm4iOiJeW2EtejAtOV9dezEsMzJ9JCJ9LCJkZXNjcmlwdGlvbiI6IlNlcnZpY2UgYnVpbGRlciBjb2RlcyJ9fSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOmZhbHNlfX19fQ==",
  "server": "railway-hikari",
  "x-hikari-trace": "iad1.fp5t",
  "x-powered-by": "Express",
  "x-railway-edge": "iad1",
  "x-railway-request-id": "kCXkUz7qQVycj_UKEuroCg"
}

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": [
      {
        "author": {
          "id": "9253672",
          "name": "Hal Finney",
          "username": "halfin"
        },
        "created_at": "2009-01-11T03:39:18.000Z",
        "id": "1110302988",
        "public_metrics": {
          "like_count": 134000,
          "quote_count": 3500,
          "reply_count": 5400,
          "retweet_count": 32000
        },
        "text": "Running bitcoin"
      }
    ],
    "meta": {
      "next_token": "abc123"
    }
  },
  "type": "json"
}