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.

MediaLiveeip155:8453Uptovia cdp
https://twitr.sh/api/tools/x_timeline
Calls · 30d
12↑ 118%
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.120
Listed price
As published in the catalog. Always read the live 402 before paying.
16
Calls · 30d
Upstream's own call count for this endpoint, not ours.
3
Unique payers · 30d
Last called 2026-09-24 00:56Z
—
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.12USDC≈ $0.12 USD
on Base · upto scheme

Pay 0.12 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
120000 smallest units
The catalog’s raw entry
[
  {
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "extra": {
      "name": "USD Coin",
      "version": "2",
      "facilitatorAddress": "0x67B9CE703d9ce658d7C4ac3c289cEa112fE662Af",
      "assetTransferMethod": "permit2"
    },
    "payTo": "0xb5194A98DbDBb7028B585Db26B972e7F0F3f826A",
    "amount": "120000",
    "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": {
          "id": "elonmusk",
          "kind": "user-tweets",
          "resultsLimit": 100
        },
        "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.120000",
            "currency": "USD",
            "protocol": "x402"
          },
          "duration": 3
        }
      }
    },
    "tags": [
      "twitter",
      "x",
      "timeline",
      "user-tweets",
      "feed",
      "replies",
      "quotes",
      "retweeters",
      "mentions",
      "history",
      "social",
      "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",
              "required": [
                "kind",
                "id",
                "resultsLimit"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "description": "User ID/username or tweet ID (depends on kind)."
                },
                "kind": {
                  "enum": [
                    "user-tweets",
                    "user-replies",
                    "user-likes",
                    "user-media",
                    "user-mentions",
                    "followers",
                    "following",
                    "verified-followers",
                    "tweet-replies",
                    "tweet-quotes",
                    "tweet-thread",
                    "tweet-favoriters",
                    "tweet-retweeters"
                  ],
                  "type": "string",
                  "description": "Which timeline to fetch."
                },
                "language": {
                  "type": "string"
                },
                "minFaves": {
                  "type": "integer"
                },
                "mediaType": {
                  "enum": [
                    "images",
                    "videos",
                    "gifs",
                    "media"
                  ],
                  "type": "string"
                },
                "resultsLimit": {
                  "type": "integer",
                  "maximum": 10000,
                  "minimum": 1,
                  "description": "MANDATORY: max items returned, billed per item."
                },
                "verifiedOnly": {
                  "type": "boolean"
                },
                "includeReplies": {
                  "type": "boolean"
                },
                "includeParentTweet": {
                  "type": "boolean"
                }
              }
            },
            "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 00:56Z
Last indexed by Roundhouse
2026-09-24 08:40Z
Last enriched (probe, favicon, geo)
2026-09-12 11:15Z
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_timeline, 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.