Roundhouse

twitr.sh

The X/Twitter API and agent skill for AI agents. One command in Claude Code, Cursor or OpenClaw — read, search, monitor and post, paid in USDC. No API key.

SearchLiveeip155:8453Uptovia cdp
https://twitr.sh/api/tools/x_search
Calls · 30d
73↑ 18%
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far.
$37.33
Verified settled volume
787 settlements proven x402 by their on-chain EIP-3009 marker.
$0.060
Listed price
As published in the catalog. Always read the live 402 before paying.
78
Calls · 30d
Upstream's own call count for this endpoint, not ours.
7
Unique payers · 30d
Last called 2026-09-24 03:31Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A

The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.

Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Provider

The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.

Accepts

The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.

0.06USDC≈ $0.06 USD
on Base · upto scheme

Pay 0.06 USDC on Base to 0xb519…f826A. The signed payment is good for 5 minutes.

Paid to
0xb519…f826A
USD Coin contract
0x8335…02913
Payment window
5 minutes
As published
60000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2",
      "facilitatorAddress": "0xE74817F4cDC15844314812B2271276E64e890fAE",
      "assetTransferMethod": "permit2"
    },
    "payTo": "0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A",
    "amount": "60000",
    "scheme": "upto",
    "network": "eip155:8453",
    "extensions": {
      "eip2612GasSponsoring": {
        "info": {
          "version": "1",
          "description": "The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract."
        },
        "schema": {
          "type": "object",
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "required": [
            "from",
            "asset",
            "spender",
            "amount",
            "nonce",
            "deadline",
            "signature",
            "version"
          ],
          "properties": {
            "from": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "description": "The address of the sender."
            },
            "asset": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "description": "The address of the ERC-20 token contract."
            },
            "nonce": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "The current nonce of the sender."
            },
            "amount": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "The amount to approve (uint256). Typically MaxUint."
            },
            "spender": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$",
              "description": "The address of the spender (Canonical Permit2)."
            },
            "version": {
              "type": "string",
              "pattern": "^[0-9]+(\\.[0-9]+)*$",
              "description": "Schema version identifier."
            },
            "deadline": {
              "type": "string",
              "pattern": "^[0-9]+$",
              "description": "The timestamp at which the signature expires."
            },
            "signature": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]+$",
              "description": "The 65-byte concatenated signature (r, s, v) as a hex string."
            }
          }
        }
      }
    },
    "maxTimeoutSeconds": 300
  }
]

Extensions

{
  "bazaar": {
    "info": {
      "input": {
        "body": {
          "q": "artificial intelligence",
          "type": "search-tweets",
          "language": "en",
          "minFaves": 100,
          "resultsLimit": 50
        },
        "type": "http",
        "method": "POST",
        "bodyType": "json"
      },
      "output": {
        "type": "json",
        "example": {
          "items": [
            {
              "id": "1893710452812718080",
              "text": "This is a great thread, thanks for sharing.",
              "createdAt": "2026-02-24T10:05:00.000Z",
              "likeCount": 1180,
              "authorUsername": "elonmusk"
            }
          ],
          "runId": "tw_example",
          "payment": {
            "amount": "0.060000",
            "currency": "USD",
            "protocol": "x402"
          },
          "duration": 2
        }
      }
    },
    "tags": [
      "twitter",
      "x",
      "search",
      "tweets",
      "keyword",
      "hashtag",
      "query",
      "social-listening",
      "brand-monitoring",
      "sentiment",
      "user-search",
      "agent",
      "x402"
    ],
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "input"
      ],
      "properties": {
        "input": {
          "type": "object",
          "required": [
            "type",
            "method",
            "bodyType",
            "body"
          ],
          "properties": {
            "body": {
              "type": "object",
              "allOf": [
                {
                  "if": {
                    "properties": {
                      "type": {
                        "const": "search-users"
                      }
                    }
                  },
                  "else": {
                    "required": [
                      "resultsLimit"
                    ]
                  },
                  "then": {}
                }
              ],
              "required": [
                "q"
              ],
              "properties": {
                "q": {
                  "type": "string",
                  "description": "Search query (X operator syntax supported for tweets)."
                },
                "type": {
                  "enum": [
                    "search-tweets",
                    "search-users"
                  ],
                  "type": "string",
                  "description": "Search tweets (default) or users."
                },
                "cursor": {
                  "type": "string",
                  "description": "search-users: pagination cursor from a previous call's report.next_cursor."
                },
                "fromUser": {
                  "type": "string"
                },
                "language": {
                  "type": "string"
                },
                "minFaves": {
                  "type": "integer"
                },
                "mediaType": {
                  "enum": [
                    "images",
                    "videos",
                    "gifs",
                    "media"
                  ],
                  "type": "string"
                },
                "sinceDate": {
                  "type": "string",
                  "description": "YYYY-MM-DD"
                },
                "untilDate": {
                  "type": "string",
                  "description": "YYYY-MM-DD"
                },
                "minReplies": {
                  "type": "integer"
                },
                "exactPhrase": {
                  "type": "string"
                },
                "minRetweets": {
                  "type": "integer"
                },
                "excludeWords": {
                  "type": "string"
                },
                "resultsLimit": {
                  "type": "integer",
                  "maximum": 10000,
                  "minimum": 1,
                  "description": "search-tweets: MANDATORY max tweets returned, billed per tweet."
                },
                "verifiedOnly": {
                  "type": "boolean"
                },
                "advancedQuery": {
                  "type": "string",
                  "description": "Raw X search operator string appended to q."
                }
              }
            },
            "type": {
              "type": "string",
              "const": "http"
            },
            "method": {
              "enum": [
                "POST",
                "PUT",
                "PATCH"
              ],
              "type": "string"
            },
            "bodyType": {
              "enum": [
                "json",
                "form-data",
                "text"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "output": {
          "type": "object",
          "required": [
            "type"
          ],
          "properties": {
            "type": {
              "type": "string"
            },
            "example": {
              "type": "object",
              "required": [
                "items"
              ],
              "properties": {
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object"
                  },
                  "description": "Returned items. Shape varies per tool — see each tool's outputSample for a concrete example."
                },
                "runId": {
                  "type": "string",
                  "description": "Run ID for debugging/audit."
                },
                "payment": {
                  "type": "object",
                  "description": "Settlement summary (protocol, amount, currency)."
                },
                "duration": {
                  "type": "integer",
                  "description": "Run duration in seconds."
                }
              }
            }
          }
        }
      }
    },
    "category": "api",
    "discoverable": true
  },
  "eip2612GasSponsoring": {
    "info": {
      "version": "1",
      "description": "The facilitator accepts EIP-2612 gasless Permit to `Permit2` canonical contract."
    },
    "schema": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "from",
        "asset",
        "spender",
        "amount",
        "nonce",
        "deadline",
        "signature",
        "version"
      ],
      "properties": {
        "from": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "description": "The address of the sender."
        },
        "asset": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "description": "The address of the ERC-20 token contract."
        },
        "nonce": {
          "type": "string",
          "pattern": "^[0-9]+$",
          "description": "The current nonce of the sender."
        },
        "amount": {
          "type": "string",
          "pattern": "^[0-9]+$",
          "description": "The amount to approve (uint256). Typically MaxUint."
        },
        "spender": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]{40}$",
          "description": "The address of the spender (Canonical Permit2)."
        },
        "version": {
          "type": "string",
          "pattern": "^[0-9]+(\\.[0-9]+)*$",
          "description": "Schema version identifier."
        },
        "deadline": {
          "type": "string",
          "pattern": "^[0-9]+$",
          "description": "The timestamp at which the signature expires."
        },
        "signature": {
          "type": "string",
          "pattern": "^0x[a-fA-F0-9]+$",
          "description": "The 65-byte concatenated signature (r, s, v) as a hex string."
        }
      }
    }
  }
}

Provenance

Seen in the source catalog
2026-09-24 03:31Z
Last indexed by Roundhouse
2026-09-24 10:40Z
Last enriched (probe, favicon, geo)
2026-09-12 00:16Z
x402 version
2
Max timeout
300s
Liveness probe
HTTP 402
Report

Hand this page to an agent

Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.

GET api.roundhouseai.io/v0/endpoints

This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 30 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.

Open skill.md
Show the prompt
Using Roundhouse, look up the x402 service twitr.sh and tell me whether it is
worth paying: what a call costs, whether the endpoint answered when last probed, and what
its payment record actually shows.

curl -s 'https://api.roundhouseai.io/v0/endpoints?q=twitr.sh'
curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>'

Then call it: read the price from the live 402 at https://twitr.sh/api/tools/x_search, never from
a cached figure, and pay with an x402 client.

The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except
/v0/unified* and /v0/endpoints. Mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402,
or use an organization key from https://roundhouseai.io/dashboard/team.

If you do not have Roundhouse tools or skills installed, read
https://roundhouseai.io/skill.md first — it is the whole procedure.