How it works
MPP uses HTTP 402 (Payment Required) as a payment challenge. When you call an eligible endpoint without a subscription or API key, the server returns a 402 with payment instructions. Your client pays via Tempo (USDC), then retries the request with a payment credential.Payment method
MPP payments on Xquik use Tempo with USDC (a dollar-pegged stablecoin). Tempo provides near-zero transaction fees, making micropayments practical for per-call pricing. You need a funded Tempo USDC wallet. See the MPP quickstart for setup instructions.Payment intents
Xquik uses 2 payment intents depending on the endpoint:| Intent | How it works | Used by |
|---|---|---|
charge | Fixed cost per call. Single on-chain settlement. | Tweet lookup, user lookup, follower check, article extraction, trends, community info |
session | Pay per result returned. Client deposits funds, sends off-chain vouchers per item. | Tweet search, user tweets, media download, quotes, replies, retweeters, favoriters, thread, likes, user media, community members/moderators/tweets/search, list followers/members/tweets, user batch/search/followers/following/mentions/verified-followers/followers-you-know |
charge, you pay a flat amount per request. With session, you pay proportional to the number of results (tweets found, media items downloaded).
Eligible endpoints
| Endpoint | Method | Price | Intent |
|---|---|---|---|
/api/v1/x/tweets/{id} | GET | $0.00015 per call | charge |
/api/v1/x/tweets/search | GET | $0.00015 per tweet | session |
/api/v1/x/users/{id} | GET | $0.00015 per call | charge |
/api/v1/x/followers/check | GET | $0.00105 per call | charge |
/api/v1/x/articles/{id} | GET | $0.00105 per call | charge |
/api/v1/x/media/download | POST | $0.00015 per media item | session |
/api/v1/x/users/{id}/tweets | GET | $0.00015 per tweet | session |
/api/v1/x/tweets/{id}/quotes | GET | $0.00015 per tweet | session |
/api/v1/x/tweets/{id}/replies | GET | $0.00015 per tweet | session |
/api/v1/x/tweets/{id}/retweeters | GET | $0.00015 per user | session |
/api/v1/x/tweets/{id}/favoriters | GET | $0.00015 per user | session |
/api/v1/x/tweets/{id}/thread | GET | $0.00015 per tweet | session |
/api/v1/x/users/{id}/likes | GET | $0.00015 per tweet | session |
/api/v1/x/users/{id}/media | GET | $0.00015 per tweet | session |
/api/v1/trends | GET | $0.00045 per call | charge |
/api/v1/x/trends | GET | $0.00045 per call | charge |
/api/v1/x/communities/{id}/info | GET | $0.00015 per call | charge |
/api/v1/x/communities/{id}/members | GET | $0.00015 per user | session |
/api/v1/x/communities/{id}/moderators | GET | $0.00015 per user | session |
/api/v1/x/communities/{id}/tweets | GET | $0.00015 per tweet | session |
/api/v1/x/communities/search | GET | $0.00015 per community | session |
/api/v1/x/communities/tweets | GET | $0.00015 per tweet | session |
/api/v1/x/lists/{id}/followers | GET | $0.00015 per user | session |
/api/v1/x/lists/{id}/members | GET | $0.00015 per user | session |
/api/v1/x/lists/{id}/tweets | GET | $0.00015 per tweet | session |
/api/v1/x/users/batch | GET | $0.00015 per user | session |
/api/v1/x/users/search | GET | $0.00015 per user | session |
/api/v1/x/users/{id}/followers | GET | $0.00015 per user | session |
/api/v1/x/users/{id}/followers-you-know | GET | $0.00015 per user | session |
/api/v1/x/users/{id}/following | GET | $0.00015 per user | session |
/api/v1/x/users/{id}/mentions | GET | $0.00015 per tweet | session |
/api/v1/x/users/{id}/verified-followers | GET | $0.00015 per user | session |
MPP vs subscription
| MPP (pay-per-use) | Subscription ($20/month) | |
|---|---|---|
| Account required | No | Yes |
| API key required | No | Yes |
| Payment | Per call via Tempo (USDC) | Monthly credit/debit card |
| Available endpoints | 32 X-API read-only | All endpoints |
| Write actions | Not available | Post tweets, like, retweet, follow, DM, profile updates |
| Monitors & webhooks | Not available | Real-time account monitoring |
| Extractions & draws | Not available | Bulk data extraction, giveaway draws |
| Best for | AI agents, one-off lookups, low-volume reads | Full platform access, production integrations |
Next steps
MPP quickstart
Make your first pay-per-use API call.
Authentication
All authentication methods including MPP headers.
Billing & usage
Subscription pricing and MPP per-call costs.