{"uid":"cap_INr-z7U1bE6i0eiD0oj4z","slug":"readx-x-twitter-list-timeline-9a375e56","name":"ReadX — X/Twitter List Timeline","description":"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.","url":"https://readx.1x402.sh/api/lists/%7Bid%7D/timeline","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HFGM4uWCOOH5T3D6YT1PM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the tweet timeline for a specific X/Twitter list by list ID, returning JSON results paid per call via x402 micropayments.","exampleAgentPrompt":"Pull the latest tweet timeline from X list ID 1234567890 — I want to see all the recent posts from that curated list.","exampleUseCases":null,"resultDescription":"A JSON object containing the timeline of tweets from the specified X/Twitter list, including tweet content, metadata, and associated user information, returned as a structured JSON response with a status code and data payload.","failureModes":["Invalid or non-existent list ID returns empty data or error code","Private or restricted list returns access error","Payment failure via x402 micropayment prevents API access","Rate limiting or downstream X/Twitter API errors cause failures","Malformed list ID format results in bad request error"],"whenToPreferThis":"Use this endpoint when you need to read the tweet timeline of a specific X/Twitter list without managing Twitter API keys, especially when micropayment-per-call billing (USDC on Base or Solana) is preferred over subscription-based API access. Ideal for agents that need occasional or burst access to list timelines without committing to a recurring API plan.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T13:25:36.972Z","isFirstParty":false}