# ReadX Following List

> ReadX Following List is a paid API for AI agents from readx.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a paginated list (~200 per page) of X/Twitter accounts that a given user follows

## Facts

- Endpoint: GET https://readx.sh/api/:name/following
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-following-list-e5d4c595
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TTh2SAmcU4oSMZa9R3304

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-following-list-e5d4c595
```

Example prompt: Can you fetch the list of accounts that @jack follows on X? Start from the beginning and give me the first page.

## When to prefer this

Use this endpoint when you need programmatic access to X/Twitter following lists without the official Twitter API, especially for paginated traversal of large following lists. Prefer this over scraping when you need structured JSON output and are willing to pay per call via x402.

## Known failure modes

- Invalid or nonexistent X handle returns an error or empty result
- Rate limiting or payment failure (402) if USDC balance is insufficient
- Cursor mismatch or stale cursor causing pagination errors
- Private/protected accounts may return no following data
- Handle with special characters rejected by alphanumeric-only pattern validation

## How this service works

Accounts a user follows (~200 per page; paginate with cursor until has_more is false). Example: GET /api/jack/following

## Output

A JSON array of X/Twitter accounts (up to ~200 per page) that the specified user follows, along with a pagination cursor and a has_more boolean to indicate whether additional pages exist.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "pattern": "^[A-Za-z0-9_]+$",
       "minLength": 1,
       "description": "X handle without the leading @ (alphanumeric and underscore)."
      },
      "cursor": {
       "type": "string",
       "description": "Pagination cursor from a previous response's pagination.next_cursor (the conversation endpoint at /api/{name}/tweets/{id} instead takes its own nested reply cursor — see that endpoint)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-following-list-e5d4c595/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readx.sh](https://www.zero.xyz/host/readx.sh/llms.txt)