Paid API for X/Twitter data: tweet search, user profiles, followers, lists and communities returned as X v2 compatible JSON, plus write endpoints such as posting and interactions. Paid per single request in USDC on Base via x402.
Pay from $0.0025 to $0.01 per request in USDC on Base, settled onchain via the x402 protocol, no signup, no API key needed.
UPTIME 24H 100% │ 7D 100% │ 30D 100%
ASSESSMENT
updated 1h agoEvidence-backed signals, not a single score. Click any chip for the proof. Measured values stay read-only; unknown is honest.
reliability 100%
- uptime 24h
- 100%
- uptime 7d
- 100%
- uptime 30d
- 100%
- uptime 90d
- 100%
- response p95
- 185ms
- avg response
- 107ms
- total checks
- 70
compliance A (11/11)
11 of 11 x402 conformance checks pass. Full checklist below.
price $0.0025 to $0.01 (p36 in Data)
- price (min)
- $0.0025
- price (max)
- $0.01
- category percentile (min)
- p36 in Data
- category percentile (max)
- p35 in Data
- endpoints / prices
- 10 / 4
- model
- tiered
- stability
- 100%
risk clean
No deterministic risk flag. Risk fires only on an exact blocklist match, or a reserved-brand name with a mismatched verified payTo. Never from low uptime, a high price, or a model guess.
traction $718.47 30d · 122 buyers
- volume 30d
- $718.47
- buyers 30d
- 122
- settlements 30d
- 118,022
- last settlement
- 2026-07-21
- top buyer share
- 91% of 30d volume
- trend 7d vs 30d
- 1.15x the 30d daily rate
- networks
- eip155:8453
Conservative undercount: only USDC settlements via facilitators we measure are counted. A measured floor, not an estimate.
Top buyer share is a concentration signal, not part of the ranking score.
WHAT IT DOES
ai-derivedProvides a Twitter/X data API for retrieving tweets, users, and related information.
- category
- twitter-api
- in
- query params
AI-generated summary. The measured data is never altered by it.
ENDPOINTS
| METHOD | PATH | DESCRIPTION | PRICE | NETWORK | ASSET |
|---|---|---|---|---|---|
| GET | /lists/tweets | $0.01 | Base | USDC | |
| GET | /tweets | $0.01 | Base | USDC | |
| GET | /tweets/by/id | $0.0025 | Base | USDC | |
| GET | /tweets/mentions | $0.006 | Base | USDC | |
| GET | /tweets/search | $0.006 | Base | USDC | |
| GET | /tweets/user | $0.01 | Base | USDC | |
| GET | /users/by/username | $0.005 | Base | USDC | |
| GET | /users/followers | $0.01 | Base | USDC | |
| GET | /users/following | $0.01 | Base | USDC | |
| GET | /users/search | $0.01 | Base | USDC |
10 endpoints
REQUEST / RESPONSE EXAMPLE
An unpaid request to GET /lists/tweets returns HTTP 402 with the payment terms. Settle onchain via your facilitator, then retry with the X-Payment header.
// request
curl -i 'https://x402.twit.sh/lists/tweets'
// 402 response (captured by monitor) · 10 payloads · click to expand
[
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/lists/tweets",
"mimeType": "application/json",
"description": "Get the latest tweets from a Twitter/X List by its numeric List ID. Returns ~100 tweets per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/tweets?id=84839422. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"id": "84839422"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"list",
"lists",
"tweets",
"timeline",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Numeric Twitter/X List ID"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/tweets",
"mimeType": "application/json",
"description": "Bulk look up multiple Twitter/X tweets by their numeric tweet IDs in a single request. Each tweet includes full text, author profile, and engagement metrics. Query param: ids (string, required) - comma-separated numeric tweet IDs, max 50, e.g. GET /tweets?ids=1110302988,1234567890. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"ids": "1110302988,1234567890"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
]
}
}
},
"tags": [
"twitter",
"x",
"social",
"tweets",
"posts",
"bulk",
"batch",
"ids",
"lookup",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "string",
"description": "Comma-separated numeric tweet IDs, max 50"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "2500",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/tweets/by/id",
"mimeType": "application/json",
"description": "Look up a single Twitter/X tweet by its numeric tweet ID. Returns full tweet data including text, author profile, creation date, engagement metrics (likes, retweets, replies, quotes, bookmarks), and referenced tweets. Query param: id (string, required) - numeric tweet ID, e.g. GET /tweets/by/id?id=1110302988. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"id": "1110302988"
}
},
"output": {
"type": "json",
"example": {
"data": {
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"tweet",
"post",
"lookup",
"id",
"metrics",
"likes",
"retweets",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Numeric tweet ID"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "6000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/tweets/mentions",
"mimeType": "application/json",
"description": "Get the latest tweets that mention the authenticated user (the notifications timeline). Returns up to 20 tweets per page, most recent first, with pagination support. Query params: auth_token (string, required) - Twitter auth_token cookie; ct0 (string, required) - Twitter ct0 cookie; type (string, optional) - notifications timeline to read: All (default), Priority, or Mentions; next_token (string, optional) - pagination cursor. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"tweets",
"mentions",
"notifications",
"timeline",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"auth_token",
"ct0"
],
"properties": {
"ct0": {
"type": "string",
"description": "Twitter ct0 cookie value"
},
"type": {
"enum": [
"All",
"Priority",
"Mentions"
],
"type": "string",
"description": "Notifications timeline to read (default All)"
},
"auth_token": {
"type": "string",
"description": "Twitter auth_token cookie value"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "6000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/tweets/search",
"mimeType": "application/json",
"description": "Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"from": "elonmusk",
"words": "bitcoin",
"minLikes": "100"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"tweets",
"search",
"posts",
"filter",
"hashtag",
"keyword",
"paginated",
"mentions",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"properties": {
"to": {
"type": "string",
"description": "Tweets replying to this username"
},
"from": {
"type": "string",
"description": "Tweets from this username"
},
"since": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"until": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
},
"words": {
"type": "string",
"description": "All these words must appear"
},
"phrase": {
"type": "string",
"description": "Exact phrase match"
},
"anyWords": {
"type": "string",
"description": "Any of these words"
},
"hashtags": {
"type": "string",
"description": "Filter by hashtag"
},
"minLikes": {
"type": "string",
"description": "Minimum like count"
},
"noneWords": {
"type": "string",
"description": "Exclude these words"
},
"mentioning": {
"type": "string",
"description": "Tweets mentioning this username"
},
"minReplies": {
"type": "string",
"description": "Minimum reply count"
},
"minReposts": {
"type": "string",
"description": "Minimum retweet count"
},
"next_token": {
"type": "string",
"description": "Pagination cursor"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/tweets/user",
"mimeType": "application/json",
"description": "Get the latest tweets (timeline) from a specific Twitter/X user by their username. Returns up to 20 tweets per page sorted by most recent first, with pagination support. Query params: username (string, required) - Twitter screen name; next_token (string, optional) - pagination cursor, e.g. GET /tweets/user?username=elonmusk. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"username": "elonmusk"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "1110302988",
"text": "Running bitcoin",
"author": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin"
},
"created_at": "2009-01-11T03:39:18.000Z",
"public_metrics": {
"like_count": 134000,
"quote_count": 3500,
"reply_count": 5400,
"retweet_count": 32000
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"tweets",
"timeline",
"posts",
"user",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "Twitter screen name (without @)"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "5000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/users/by/username",
"mimeType": "application/json",
"description": "Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"username": "elonmusk"
}
},
"output": {
"type": "json",
"example": {
"data": {
"id": "9253672",
"name": "Hal Finney",
"username": "halfin",
"verified": false,
"description": "Running bitcoin.",
"public_metrics": {
"like_count": 300,
"tweet_count": 600,
"followers_count": 134000,
"following_count": 200
}
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"user",
"profile",
"lookup",
"username",
"screen-name",
"followers",
"bio",
"verification",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"username"
],
"properties": {
"username": {
"type": "string",
"description": "Twitter screen name without @"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/users/followers",
"mimeType": "application/json",
"description": "Get the list of Twitter/X users who follow a specific user. Returns up to 50 follower profiles per page with pagination support. Query params: id (string, required) - numeric Twitter user ID; next_token (string, optional) - pagination cursor, e.g. GET /users/followers?id=44196397. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"id": "44196397"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "9253672",
"name": "Hal Finney",
"username": "halfin",
"verified": false,
"description": "Running bitcoin.",
"public_metrics": {
"like_count": 300,
"tweet_count": 600,
"followers_count": 134000,
"following_count": 200
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"user",
"followers",
"network",
"graph",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Numeric Twitter user ID"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/users/following",
"mimeType": "application/json",
"description": "Get the list of Twitter/X users that a specific user follows. Returns up to 50 following profiles per page with pagination support. Query params: id (string, required) - numeric Twitter user ID; next_token (string, optional) - pagination cursor, e.g. GET /users/following?id=44196397. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"id": "44196397"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "9253672",
"name": "Hal Finney",
"username": "halfin",
"verified": false,
"description": "Running bitcoin.",
"public_metrics": {
"like_count": 300,
"tweet_count": 600,
"followers_count": 134000,
"following_count": 200
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"user",
"following",
"network",
"graph",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Numeric Twitter user ID"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
},
{
"error": "Payment required",
"accepts": [
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x9dBA414637c611a16BEa6f0796BFcbcBdc410df8",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
}
],
"resource": {
"url": "https://x402.twit.sh/users/search",
"mimeType": "application/json",
"description": "Search Twitter/X for user accounts matching a keyword or phrase. Returns up to 20 matching user profiles per page with pagination support. Useful for discovering users by topic, name, or keyword. Query params: query (string, required) - search keyword or phrase; next_token (string, optional) - pagination cursor from previous response, e.g. GET /users/search?query=bitcoin. Returns X v2 API-compatible JSON."
},
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"query": "bitcoin"
}
},
"output": {
"type": "json",
"example": {
"data": [
{
"id": "9253672",
"name": "Hal Finney",
"username": "halfin",
"verified": false,
"description": "Running bitcoin.",
"public_metrics": {
"like_count": 300,
"tweet_count": 600,
"followers_count": 134000,
"following_count": 200
}
}
],
"meta": {
"next_token": "abc123"
}
}
}
},
"tags": [
"twitter",
"x",
"social",
"user",
"search",
"discovery",
"keyword",
"paginated",
"agent",
"x402"
],
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Search keyword or phrase"
},
"next_token": {
"type": "string",
"description": "Pagination cursor from previous response"
}
}
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object"
}
}
}
}
},
"category": "api",
"discoverable": true
},
"builder-code": {
"info": {
"a": "bc_qobj93ib"
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"a": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "App builder code"
},
"s": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$"
},
"description": "Service builder codes"
},
"w": {
"type": "string",
"pattern": "^[a-z0-9_]{1,32}$",
"description": "Wallet builder code"
}
},
"additionalProperties": false
}
}
},
"x402Version": 2
}
] UPTIME
RESPONSE TIME
24h UPTIME 100%
UPTIME 24H 100%
AVG RESP 105ms
TOTAL CHECKS 74
RECENT CHECKS
TIME STATUS RESP
● OK 74ms
● OK 74ms
● OK 69ms
● OK 38ms
● OK 48ms
● OK 35ms
● OK 44ms
● OK 41ms
● OK 69ms
● OK 122ms
● OK 88ms
● OK 82ms
● OK 56ms
● OK 148ms
● OK 46ms
● OK 116ms
● OK 82ms
● OK 44ms
OVER TIME
All charts share the 24h window selected here. Every series is also served as JSON at /api/v1/services/twit-sh/price, /scores, /volume and /buyers. On-chain volume and distinct buyers are measured over the service's settlement address and are a conservative undercount (only settlements that reach a measured facilitator are counted).
PRICE (captured 402, USD)
Median across 10 endpoints. Use the selector to isolate one.
SUB-SCORES (uptime + x402 compliance)
VOLUME (on-chain settlement, USD)
DISTINCT BUYERS
COMPLIANCE
11/11 checks pass · grade A- 402 payload captured
- accepts[] array present
- payTo address recoverable
- payTo at accepts[0].payTo (conformant shape)
- payTo is a valid on-chain address
- atomic price declared
- atomic price in a sane range
- asset (token) address declared
- network resolves to CAIP-2
- payment scheme declared
- served over HTTPS
EMBED THIS BADGE
// HTML
<a href="https://x402-list.com/services/twit-sh?utm_source=badge&utm_medium=referral&utm_campaign=embed"> <img src="https://x402-list.com/badge/twit-sh.svg" alt="twit.sh listed on x402-list" height="28"> </a>
// Markdown
[](https://x402-list.com/services/twit-sh?utm_source=badge&utm_medium=referral&utm_campaign=embed)
// HTML · live uptime variant
<a href="https://x402-list.com/services/twit-sh?utm_source=badge&utm_medium=referral&utm_campaign=embed"> <img src="https://x402-list.com/badge/twit-sh.svg?data=uptime" alt="twit.sh uptime on x402-list" height="28"> </a>