x402 List

x402 Protocol Service Directory

●

twit.sh

Data

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%
BASE URL https://x402.twit.sh │ ENDPOINTS 10 │ NETWORK Base │ ASSET USDC │ MEMBER SINCE 2026-07-20 │ MONITORED SINCE 2026-07-20

ASSESSMENT

updated 29m 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
186ms
avg response
120ms
total checks
47
compliance A (11/11)

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

jump to compliance checklist

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 $711.62 30d · 124 buyers
volume 30d
$711.62
buyers 30d
124
settlements 30d
116,879
last settlement
2026-07-21
top buyer share
91% of 30d volume
trend 7d vs 30d
1.16x 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-derived

Provides a Twitter/X data API for retrieving tweets, users, and related information.

category
twitter-api
in
query params
twittersocial-mediadata-apiuser-lookuptweet-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 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

07-20 · uptime 100.0% · 117ms avg07-21 · uptime 100.0% · 126ms avg07-2007-21
RESPONSE TIME
07-20 · 117ms avg07-20 · 117ms avg07-21 · 126ms avg07-21 · 126ms avg07-2007-21
30d UPTIME 100%
UPTIME 30D 100%
AVG RESP 120ms
TOTAL CHECKS 49

RECENT CHECKS

TIME STATUS RESP
● OK 95ms
● OK 142ms
● OK 101ms
● OK 139ms
● OK 114ms
● OK 123ms
● OK 121ms
● OK 115ms
● OK 106ms
● OK 174ms
● OK 112ms
● OK 114ms
● OK 130ms
● OK 127ms
● OK 145ms
● OK 138ms
● OK 121ms
● OK 121ms
18 of 49 checks

OVER TIME

All charts share the 30d 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)
07-20 · $0.0107-21 · $0.01$0.0107-2007-21

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

SUB-SCORES (uptime + x402 compliance)
07-20 uptime: 100.0% compliance: 100% checks07-21 uptime: 100.0% compliance: 100% checksuptimecompliance07-2007-21
VOLUME (on-chain settlement, USD)
06-21 · $206-22 · $506-23 · $606-24 · $506-25 · $206-26 · $906-27 · $2806-28 · $2806-29 · $3006-30 · $2807-01 · $3007-02 · $2707-03 · $2807-04 · $2707-05 · $2807-06 · $3707-07 · $2607-08 · $3107-09 · $2707-10 · $2807-11 · $2707-12 · $2607-13 · $2807-14 · $2807-15 · $2807-16 · $2707-17 · $2707-18 · $2707-19 · $2707-20 · $3007-21 · $6peak $3706-2107-21
DISTINCT BUYERS
06-21 · 11 buyers06-22 · 13 buyers06-23 · 12 buyers06-24 · 13 buyers06-25 · 15 buyers06-26 · 12 buyers06-27 · 11 buyers06-28 · 12 buyers06-29 · 18 buyers06-30 · 12 buyers07-01 · 20 buyers07-02 · 10 buyers07-03 · 12 buyers07-04 · 14 buyers07-05 · 11 buyers07-06 · 14 buyers07-07 · 15 buyers07-08 · 16 buyers07-09 · 16 buyers07-10 · 8 buyers07-11 · 11 buyers07-12 · 10 buyers07-13 · 11 buyers07-14 · 17 buyers07-15 · 19 buyers07-16 · 14 buyers07-17 · 12 buyers07-18 · 25 buyers07-19 · 17 buyers07-20 · 18 buyers07-21 · 9 buyerspeak 25 buyers06-2107-21

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

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

twit.sh listed on x402-list
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 ]