{"uid":"cap_G8EswBnsIFNIS9PCU0rE-","slug":"readx-list-timeline-api-866eaab4","name":"ReadX List Timeline API","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.sh/api/lists/%7Bid%7D/timeline","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":"unknown","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_3SCjWV1RqiiDSX-RxYVt7","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 via pay-per-call micropayment","exampleAgentPrompt":"Pull the latest tweets from the X/Twitter list with ID 1234567890 using ReadX — I don't have an API key so use the pay-per-call option.","exampleUseCases":null,"resultDescription":"A JSON object containing the tweet timeline for the specified list, including tweet content, metadata, and author details, returned as structured JSON with a code and data field.","failureModes":["Invalid or non-existent list ID returns an error code in the response body","List is private or inaccessible, resulting in an authorization error","Payment failure via x402 micropayment protocol causes a 402 Payment Required response","Rate limiting or quota exceeded on the ReadX platform","Malformed list ID format causes a bad request error"],"whenToPreferThis":"Choose this endpoint when you need to read tweets from a specific curated X/Twitter list without setting up Twitter API credentials. Ideal for AI agents needing occasional, on-demand access to list timelines using USDC micropayments on Base or Solana rather than managing OAuth tokens or monthly API subscriptions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-08T18:30:01.617Z","isFirstParty":false}