# twitter.surf.cascade.fyi - User Tweets

> twitter.surf.cascade.fyi - User Tweets is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Fetches recent tweets posted by a specific Twitter/X user, with optional inclusion of replies

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/teknium/tweets
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-5e6a7b2b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M_-IXuY3QhwD3XTon7Cn4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability twitter-surf-cascade-fyi-5e6a7b2b
```

Example prompt: Can you pull the latest tweets from the Twitter user 'teknium', including any replies they've posted?

## When to prefer this

Use this endpoint when you need to retrieve tweets from a specific Twitter/X user programmatically without direct access to the official Twitter API, especially in agent workflows requiring paid microtransactions via x402. Prefer this over scraping or manual lookup when you need structured tweet data for a known username.

## Known failure modes

- User not found or invalid username returns an error or empty result
- Payment of 0.004 USDC per call required via x402 protocol; missing payment results in 402 response
- Rate limiting or upstream Twitter API restrictions may cause failures
- include_replies parameter misconfigured may return unexpected result set
- Network or provider availability issues may cause timeouts

## How this service works

User tweets

## Output

Returns a list of tweets posted by the specified Twitter user, including tweet text, metadata, and optionally replies depending on the include_replies query parameter.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "include_replies": false
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "include_replies": {
       "type": "boolean",
       "description": "Include replies"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "_truncated",
  "_originalSize"
 ],
 "properties": {
  "_truncated": {
   "type": "boolean"
  },
  "_originalSize": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-surf-cascade-fyi-5e6a7b2b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.surf.cascade.fyi](https://www.zero.xyz/host/twitter.surf.cascade.fyi/llms.txt)
