Fetch a Twitter/X user's recent posts via x402 micropayment on Base
What it does
This x402 endpoint retrieves a Twitter/X user's recent timeline posts. It is part of the Heurist Mesh API platform and is operated by the TwitterIntelligenceAgent. Callers send a POST request with a user handle (e.g. @username) or numeric user ID and receive the user's latest tweets. Pagination is supported via a cursor parameter, and a limit parameter controls how many tweets are returned per call.
Payment is handled through the x402 protocol on the Base network using USDC (contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). The maximum amount required per call is 10,000 units (in the token's smallest denomination). The endpoint returns JSON and supports a maximum timeout of 120 seconds.
Documentation beyond the x402 challenge itself is sparse — the /docs, /api, /pricing, and /README paths on mesh.heurist.xyz all return 404. The input schema is well-defined in the challenge's outputSchema, but no response schema or example response is provided, so the structure of returned tweet data must be inferred at runtime.
Capabilities
Use cases
- —Retrieve a public figure's latest tweets for sentiment analysis or news monitoring
- —Feed a user's recent posts into an AI agent for summarization or Q&A
- —Track official announcements from a brand or project's Twitter account
- —Paginate through a user's tweet history for archival or research purposes
Fit
Best for
- —AI agents that need real-time Twitter/X data without managing API keys directly
- —Autonomous workflows that can pay per-call via x402 on Base
- —Monitoring specific Twitter accounts for recent activity
Not for
- —Bulk scraping of millions of tweets (per-call payment model, 120s timeout)
- —Searching tweets by keyword or hashtag (this is user-timeline only)
- —Accessing private or protected Twitter accounts
Quick start
curl -X POST https://mesh.heurist.xyz/x402/agents/TwitterIntelligenceAgent/user_timeline \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <x402_payment_header>" \
-d '{"identifier": "@elonmusk", "limit": 5, "debug": false}'Example
Request
{
"debug": false,
"limit": 5,
"identifier": "@elonmusk"
}Endpoint
Quality
The x402 challenge is live and provides a clear input schema with field descriptions. However, no response schema, example responses, or external documentation are available — all doc/pricing/README paths return 404. Pricing details beyond maxAmountRequired are absent. Score reflects a working endpoint with adequate input docs but missing output specification.
Warnings
- —No response schema provided — the structure of returned tweet data is unknown until runtime
- —All documentation paths (/docs, /api, /pricing, /README) on mesh.heurist.xyz return 404
- —No OpenAPI spec or ai-plugin manifest found
- —Pricing is stated only as maxAmountRequired: 10000 USDC base units; actual cost per call may vary
Citations
- —Endpoint is live and returns a 402 x402 challenge on POSThttps://mesh.heurist.xyz/x402/agents/TwitterIntelligenceAgent/user_timeline
- —Payment uses USDC on Base network with maxAmountRequired of 10000https://mesh.heurist.xyz/x402/agents/TwitterIntelligenceAgent/user_timeline
- —Input schema includes identifier (required), limit, cursor, and debug fieldshttps://mesh.heurist.xyz/x402/agents/TwitterIntelligenceAgent/user_timeline
- —Root service status returns ok for Heurist Mesh APIhttps://mesh.heurist.xyz
- —robots.txt disallows /api/ and references mesh.heurist.ai as canonical hosthttps://mesh.heurist.xyz