Skip to content
onelayer.
All tools

Tool detail

ReadX

Returns a user's X/Twitter timeline: tweets, retweets, and quotes, by @handle.

Categories: Social media

Use when

  • get a Twitter/X user's recent timeline
  • page through a user's tweets with a cursor

Not for

  • not tweets with replies included (see the with_replies endpoint)
  • not a single tweet's conversation thread

Inputs

GET path param: name (required, @handle without the @); query param: cursor (optional pagination token)

Admitted input schema

{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "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)."
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://readx.sh/api/{name}

Payment

Protocol
x402
Listed price
0.01 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://readx.sh/api/:name
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z