Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count. No signup, no API keys — every request is paid in USDC through the HTTP 402 flow, and the exact price is quoted before you pay.
One endpoint: POST /api/tools/draws over HTTP, or the x_draws tool over MCP at POST /api/mcp.
curl -X POST https://twitr.sh/api/tools/draws \
-H 'Content-Type: application/json' \
-d '{"tweetUrl":"https://x.com/vercel/status/2079908425904042170","winnerCount":3,"estimatedEntries":500}'
# → 402 Payment Required with the exact USDC price.
# Pay it (x402 on Base/Solana, MPP on Tempo) and retry the same request → 200 + data.
# x402-aware clients do both steps automatically.tweetUrl required. Optional: winnerCount (default 1), backupCount, uniqueAuthorsOnly, mustRetweet, mustFollowUsername, filterMinFollowers, filterAccountAgeDays, filterLanguage, requiredHashtags/Keywords/Mentions. Pricing is fixed upfront from the estimatedEntries you set (default 1000, max 10000) — set it near the tweet's reply count; that number is enforced as a hard cap. Payment settles before the draw runs, so pay only when you intend to run it; a failed draw does not auto-refund (contact support). Idempotency-Key header required — retries with the same key replay the original result instead of re-charging.
The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged. Full input schema in the OpenAPI spec.
Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count. It is one of 14 pay-per-call X/Twitter tools on twitr.sh, available over HTTP (POST /api/tools/draws) and MCP (tool name x_draws).
$0.0024–$84.0012 per call in USDC. The exact quote is returned in the 402 challenge before you pay — an agent always knows the cost first. Failed calls are never charged.
POST https://twitr.sh/api/tools/draws with your input. The first response is HTTP 402 Payment Required carrying the exact price; pay it in USDC (x402 on Base or Solana, MPP on Tempo) and retry the identical request to get the data. No signup — the wallet is the account.
Yes. Call the x_draws tool via the MCP endpoint at POST https://twitr.sh/api/mcp — tools/list is free, tools/call is payment-gated with a JSON-RPC 402. The installable agent skill at https://twitr.sh/skill.md covers the full workflow.