agentbox-twitter（Agent 箱推特）

Twitter Research

Paid Twitter/X data API at https://twitter.surf.cascade.fyi. Costs $0.003 USDC per call via x402 on Solana or Base. Use the x_payment tool for all requests.

Endpoints

Search Tweets

Find tweets matching a query with 50+ advanced operators.

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"from:elonmusk AI\", \"type\": \"Latest\", \"limit\": 20}"
})

Parameters:

Search operators:

Combine operators: from:elonmusk AI min_faves:100 -filter:replies within_time:7d

Response: {query, tweets[], count, hasMore, nextCursor, summary}

The summary object includes: totalLikes, totalRetweets, totalReplies, avgLikes, maxLikes, topTweetId.

Fetch Tweets

Get tweet(s) by ID or URL with optional thread, replies, and quotes.

x_payment({
  "url": "https://twitter.surf.cascade.fyi/tweet/1585841080431321088",
  "method": "GET",
  "params": "{\"include\": \"thread,replies\", \"limit\": 50}"
})

URL format: /tweet/{ref} where ref is:

• Tweet ID: 1585841080431321088
• Comma-separated IDs: 123,456,789 (batch fetch, no includes)

Parameters:

Include options (single tweet only):

• thread - author's self-reply chain in the conversation
• replies - replies from other users
• quotes - quote tweets of this tweet

Response: {tweets[], count, parent?, thread?, replies?, quotes?}

If the fetched tweet is a reply, parent is auto-included with the replied-to tweet.

Fetch Users

Get user profile(s) with optional tweets, followers, or following.

x_payment({
  "url": "https://twitter.surf.cascade.fyi/user/elonmusk",
  "method": "GET",
  "params": "{\"include\": \"tweets\", \"limit\": 20}"
})

URL format: /user/{ref} where ref is:

• Username: elonmusk or @elonmusk
• User ID: 44196397
• Comma-separated IDs: 123,456 (batch fetch, no includes)

Parameters:

Response (single): {user, tweets?, followers?, following?} Response (batch): {users[], count, hasMore}

Usage Patterns

Monitor a topic

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"x402 OR \\\"402 payment\\\" min_faves:5 within_time:24h\", \"type\": \"Latest\"}"
})

Get a tweet with full context

x_payment({
  "url": "https://twitter.surf.cascade.fyi/tweet/1585841080431321088",
  "method": "GET",
  "params": "{\"include\": \"thread,replies,quotes\", \"limit\": 20}"
})

Research a user

x_payment({
  "url": "https://twitter.surf.cascade.fyi/user/CoinbaseDev",
  "method": "GET",
  "params": "{\"include\": \"tweets\", \"limit\": 50}"
})

Paginate results

Use nextCursor from a previous response:

x_payment({
  "url": "https://twitter.surf.cascade.fyi/search",
  "method": "GET",
  "params": "{\"q\": \"from:elonmusk\", \"cursor\": \"DAABCgAB...\"}"
})

Cost

Every call costs $0.003 USDC on Solana mainnet or Base mainnet. Each paginated request is a separate call. Plan queries to minimize calls - use specific operators and reasonable limits.

Errors