An x402-native X/Twitter API: the 402 challenge is the price list.

Last updated July 28, 2026

twitr.sh is an x402 service end to end: every one of its 14 X/Twitter tools answers an unpaid request with HTTP 402 and an exact USDC quote, accepts x402 payments on Base and Solana (and MPP on Tempo), and settles each call on-chain. There is nothing to sign up for — the paying wallet is the account, and the 402 challenge doubles as the price list.

Why x402 fits social data

Social data demand is bursty and fine-grained — one agent needs 50 tweets about a topic, another needs a week-long monitor on a single account. Subscriptions price for the peak; x402 prices the actual request. Per-item billing with a mandatory resultsLimit means a search for 50 tweets costs about six cents total — and an agent can verify that total in the challenge before signing. Failed calls are never charged, and idempotency keys make retries safe.

Discovery surfaces for x402 clients

Everything a client needs is machine-readable: /.well-known/x402 lists the paid resources, /.well-known/mpp.json covers MPP discovery, /openapi.json is a full OpenAPI 3.1 document with x-payment-info on every endpoint, and /llms.txt + /llms-full.txt serve LLM-ready indexes. MCP clients call POST /api/mcp directly — tools/list free, tools/call gated with a JSON-RPC 402. Start with the docs or browse the tools.

FAQ

What is x402?

x402 is an open payment protocol that revives the HTTP 402 Payment Required status code for machine payments: a server answers an unpaid request with 402 and a price, the client signs a stablecoin payment authorization and retries, and the server verifies, serves the response, and settles on-chain. It lets APIs charge per request without accounts or API keys.

Is there an x402 API for Twitter/X data?

Yes — twitr.sh exposes 14 X/Twitter tools (reads, search, timelines, bulk extraction, real-time monitors, and write actions) as x402-priced endpoints, paid in USDC on Base or Solana. The same endpoints also accept MPP payments in USDC on Tempo.

How do x402 clients discover the service?

Machine discovery lives at /.well-known/x402 and /.well-known/mpp.json, with a full OpenAPI 3.1 spec at /openapi.json carrying x-payment-info blocks per endpoint, an llms.txt index, and an MCP endpoint at POST /api/mcp.

What does an x402 call to twitr.sh cost?

The floor is $0.001. Single reads are about $0.0012, per-item tools bill about $0.0012 per returned item, monitors are ~$0.025 per prepaid hour, and write actions run $0.012–$0.036. The exact quote — including a line-item breakdown — is in every 402 challenge before you sign.