# ReadX — X/Twitter User Timeline with Replies

> ReadX — X/Twitter User Timeline with Replies is a paid API for AI agents from readx.1x402.sh, paid per call via x402, $0.03/call, status down (last checked 2026-09-15).

Fetches a Twitter/X user's tweet timeline including their replies, returned as JSON, paid per call with USDC micropayments via x402.

## Facts

- Endpoint: GET https://readx.1x402.sh/api/%7Bname%7D/with_replies
- Price: $0.03/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-x-twitter-user-timeline-with-replies-3040d058
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jrleE9d2YcjYAMDqsK6kN

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 readx-x-twitter-user-timeline-with-replies-3040d058
```

Example prompt: Can you pull the full tweet timeline including replies for the X account @elonmusk so I can see what they've been posting and responding to recently?

## When to prefer this

Use this endpoint when you need a Twitter/X user's timeline that includes both their original tweets AND their replies to others, rather than just their top-level posts. Prefer this over a basic timeline endpoint when you want to understand someone's full conversational activity on X. Ideal for agents that need to analyze public figures' engagement, monitor reply behavior, or research what an account has been responding to. No API keys needed — just pay $0.05 USDC per call via x402.

## Known failure modes

- Username not found or account does not exist — returns error code in JSON
- Account is private or suspended — data may be unavailable
- Payment failure via x402 — 402 response if USDC payment not provided or insufficient
- Rate limiting or upstream X API restrictions — may return empty or partial data
- Malformed username in URL path — returns error response

## How this service works

ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.

## Output

A JSON object containing the user's tweets and replies (timeline with replies), including tweet content, metadata, and engagement data for the specified X/Twitter username.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-x-twitter-user-timeline-with-replies-3040d058/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readx.1x402.sh](https://www.zero.xyz/host/readx.1x402.sh/llms.txt)