●

twit.sh

Data PAYMENT-READY imported

payment-ready until 2026-08-20

imported from the x402 Bazaar, not submitted by the operator · own this service? claim it · or ask to be removed

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.

first settlement 2026-02-13 · $21.7k all-time · settled via coinbase, dexter, openfacilitator

BASE URL https://x402.twit.sh │ ENDPOINTS 10 │ NETWORK Base │ ASSET USDC │ MEMBER SINCE 2026-07-20 │ MONITORED SINCE 2026-07-20

ASSESSMENT

updated 2h ago

Evidence-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: 456ms
avg response: 176ms
total checks: 2,145

Measured on the unpaid 402 handshake, not the paid call. A service can 402 correctly and still fail after payment.

compliance A (14/14)

14 of 14 x402 conformance checks pass. Full checklist below.

jump to compliance checklist

price $0.0025 to $0.01 (p26 in Data)

price (min): $0.0025
price (max): $0.01
category percentile (min): p26 in Data
category percentile (max): p24 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.

domain age: -
registrar: -
hosting: custom
domain created: ---

Identity facts, not a risk score.

traction $523.9355 30d · 161 buyers · top buyer 95%

volume 30d: $523.9355
buyers 30d: 161
settlements 30d: 86,798
first settlement: 2026-02-13
last settlement: 2026-08-13
top buyer share: 95% of 30d volume
trend 7d vs 30d: 0.04x the 30d daily rate
networks: eip155:8453
volume all-time: $21.7k
settlements all-time: 263,203
median settlement 30d: $0.006
max settlement 30d: $0.01
settled via: coinbase ($495.56, 82,088 tx), dexter ($27.93, 4,638 tx), openfacilitator ($0.45, 72 tx)

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-derived

Provides access to Twitter/X user and tweet data through various lookup and search endpoints

category: twitter-api
in: query params
auth: api key

twitter-apiuser-lookuptweet-lookupsocial-mediadata-retrieval

AI-generated summary. The measured data is never altered by it.

ENDPOINTS

Service endpoints with HTTP method, path, description, pricing, and network
METHOD	PATH	PRICE	NETWORK	ASSET	402 CHANNEL
GET	/lists/tweets	$0.01	Base	USDC	header
GET	/tweets	$0.01	Base	USDC	header
GET	/tweets/by/id	$0.0025	Base	USDC	header
GET	/tweets/mentions	$0.006	Base	USDC	header
GET	/tweets/search	$0.006	Base	USDC	header
GET	/tweets/user	$0.01	Base	USDC	header
GET	/users/by/username	$0.005	Base	USDC	header
GET	/users/followers	$0.01	Base	USDC	header
GET	/users/following	$0.01	Base	USDC	header
GET	/users/search	$0.01	Base	USDC	header

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
  }
]

OVER TIME

All charts use the 30d selector; each series spans only the dates it has data for. 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). The on-chain series roll up hourly, so the latest day can be up to about an hour behind; distinct buyers are counted per payout address, so a service that settles to more than one address is an upper bound.

UPTIME

30d UPTIME 100%

RESPONSE TIME

AVG RESP 177ms

PRICE (captured 402, USD)

Median across 10 endpoints. Use the selector to isolate one.

SUB-SCORES (uptime + x402 compliance)

checklist grew 11->14 on 2026-07-28; a step here is a metric change, not a regression

PILLARS OVER TIME (measured)

price percentile in Data

site signals present (of 6)

Measured site and economics pillars from the assessment history, so the latest value shown elsewhere on this page reads as a point on a trend rather than a permanent state.

VOLUME (on-chain settlement, USD)

DISTINCT BUYERS

COMPLIANCE

14/14 checks pass · grade A

last 402 captured 2026-07-20 · last up 2026-08-13

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
declares the current x402 version (2)
EIP-712 domain parameters present on every EVM entry
x402 v2 envelope delivered in the payment-required header

SITE PILLARS

homepage reachable
openapi doc
pricing page
llms.txt
robots.txt
terms page

recent checks (18) live · click to expand

TIME STATUS RESP CAUSE

15:06:13 UTC ● SLOW 524ms

14:50:12 UTC ● SLOW 608ms

14:34:07 UTC ● OK 110ms

14:18:11 UTC ● SLOW 509ms

14:02:10 UTC ● SLOW 390ms

13:46:11 UTC ● SLOW 452ms

13:30:11 UTC ● SLOW 476ms

13:14:08 UTC ● OK 230ms

12:58:11 UTC ● SLOW 413ms

12:42:09 UTC ● OK 243ms

12:26:12 UTC ● SLOW 460ms

12:10:09 UTC ● SLOW 421ms

11:54:11 UTC ● SLOW 393ms

11:38:09 UTC ● OK 113ms

11:22:11 UTC ● SLOW 456ms

11:06:11 UTC ● SLOW 489ms

10:50:11 UTC ● SLOW 365ms

10:34:10 UTC ● SLOW 392ms

EMBED THIS BADGE

Show that twit.sh is monitored on x402-list. Paste this on your site or README, it links back to this live listing.

status

twit.sh uptime on x402-list — live uptime

// 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

[![twit.sh on x402-list](https://x402-list.com/badge/twit-sh.svg)](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>

RUN THIS SERVICE?

Keep this listing accurate: propose changes to the name, description, website, category or add new endpoints to monitor. Ownership is verified with a domain proof and every change is reviewed manually; measured data stays read-only.

[ update this listing ]

Earn the verified tier: x402list pays a real call to this endpoint and, if it delivers, the service is delivery-verified. The fee covers the cost of the probe, not the badge; there is no refund if the call does not deliver. Agent and API only, no in-browser signing. See /api.

[ verify this service ($0.25) ]

To request delisting, email info@x402-list.com or update your listing at /services/twit-sh/update.