X Data Gateway

Endpoints (25 live)

• GET /v1/health/paid — Cheap end-to-end x402 test. Returns { ok: true, ts }. GET /v1/health/paid (0.001 USDC on Base)
• GET /users/by/id — Look up a public X user by numeric ID. Same fields as username lookup. e.g. GET /users/by/id?id=44196397 (0.004 USDC on Solana)
• GET /tweets — Up to 50 tweets by comma-separated IDs. e.g. GET /tweets?ids=20,21,22 (0.007 USDC on Solana)
• GET /v1/gas/base — Current gas price on Base from public RPC (wei + gwei). Optional query network=base for schema probes. e.g. GET /v1/gas/base (0.001 USDC on Base)
• GET /users/followers — One page of followers by numeric user ID. e.g. GET /users/followers?id=44196397 (0.008 USDC on Base)
• GET /tweets/user — Recent posts from a user (newest first) with author and metrics. e.g. GET /tweets/user?username=elonmusk (0.007 USDC on Base)
• GET /tweets/search — Search posts. At least one of: words, phrase, hashtags, from, minLikes, since, until. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100 (0.005 USDC on Base)
• GET /users/by/username — Look up a public X/Twitter user by handle. Returns id, username, display name, bio, location, followers/following/statuses counts, verified flag, createdAt, profile image. Query: username (required, no @). e.g. GET /users/by/username?username=elonmusk (0.004 USDC on Solana)
• GET /users/search — Search public accounts by keyword. e.g. GET /users/search?query=bitcoin (0.008 USDC on Base)
• GET /v1/token/pairs — Top liquidity pairs for a token address from DexScreener. e.g. GET /v1/token/pairs?address=0x... (0.004 USDC on Solana)
• GET /users/following — One page of accounts followed by numeric user ID (GraphQL Following when available). e.g. GET /users/following?id=44196397 (0.008 USDC on Base)
• GET /v1/defi/tvl — Current TVL for a protocol slug from DefiLlama free API. e.g. GET /v1/defi/tvl?slug=aave (0.003 USDC on Base)
• GET /tweets/by/id — One post by numeric ID: text, author, metrics (likes, retweets, replies, quotes, views). e.g. GET /tweets/by/id?id=20 (0.002 USDC on Solana)
• GET /mcp — MCP tools/call gas_base: Current gas price on Base from public RPC (wei + gwei). Optional query network=base for schema probes. e.g. GET /v1/gas/base (0.001 USDC on Base)
• GET /v1/x402/probe — Unauthenticated GET to resourceUrl; checks HTTP 402, accepts[], price sanity. Query: url (required). e.g. GET /v1/x402/probe?url=https://... (0.005 USDC on Solana)
• GET /v1/price/spot — USD spot via DexScreener search for symbol (e.g. ETH, BTC, SOL). Returns priceUsd, confidence, sources. e.g. GET /v1/price/spot?symbol=ETH (0.002 USDC on Base)
• GET /tweets/replies — Replies to a post by numeric ID. e.g. GET /tweets/replies?id=20 (0.008 USDC on Solana)
• GET /tweets/quotes — Posts that quote a given tweet ID (via search quoted filter). e.g. GET /tweets/quotes?id=20 (0.008 USDC on Solana)
• GET /v1/token/meta — Metadata for a token contract (prefers Base). name/symbol/priceUsd always refer to the *requested* address — not the other side of a DEX pair. Stables fall back to registry if Dex is rate-limited. e.g. GET /v1/token/meta?address=0x8335...USDC (0.004 USDC on Base)
• GET /workflows/profile-digest — Profile + recent tweets + avg engagement in one call. e.g. GET /workflows/profile-digest?username=elonmusk&tweet_count=20 (0.04 USDC on Solana)

+5 more endpoints.

MCP tools (24)

X Data Gateway — X + Base market for agents https://x-data-gateway.annushka1190.workers.dev/mcp

• defi_tvl — DefiLlama protocol TVL. Current TVL for a protocol slug from DefiLlama free API. e.g. GET /v1/defi/tvl?slug=aave Price: $0.003 USDC via x402.
• gas_base — Base L2 gas tip. Current gas price on Base from public RPC (wei + gwei). Optional query network=base for schema probes. e.g. GET /v1/gas/base Price: $0.001 USDC via x402.
• health_paid — Paid ping. Cheap end-to-end x402 test. Returns { ok: true, ts }. GET /v1/health/paid Price: $0.001 USDC via x402.
• json_repair — Repair broken JSON. Best-effort repair of truncated/malformed JSON strings. Body: { "text": "{..." } or { "json": "..." } Price: $0.002 USDC via x402.
• price_spot — Spot price by symbol. USD spot via DexScreener search for symbol (e.g. ETH, BTC, SOL). Returns priceUsd, confidence, sources. e.g. GET /v1/price/spot?symbol=ETH Price: $0.002 USDC via x402.
• profile_digest — Profile + activity digest. Profile + recent tweets + avg engagement in one call. e.g. GET /workflows/profile-digest?username=elonmusk&tweet_count=20 Price: $0.04 USDC via x402.
• scam_scan — Scam/phishing text heuristics. Heuristic scan of text for common scam patterns (seed phrases, urgency, fake support). Body: { "text": "..." } Price: $0.003 USDC via x402.
• search_tweets — Advanced tweet search. Search posts. At least one of: words (or query alias), phrase, hashtags, from, minLikes, since, until. e.g. GET /tweets/search?words=bitcoin or ?query=bitcoin Price: $0.005 USDC via x402.
• search_users — Search user accounts. Search public accounts by keyword. e.g. GET /users/search?query=bitcoin Price: $0.008 USDC via x402.
• token_meta — Token metadata by address. Metadata for a token contract (prefers Base). name/symbol/priceUsd always refer to the *requested* address — not the other side of a DEX pair. Stables fall back to registry if Dex is rate-limited. e.g. GET /v1/token/meta?address=0x8335...USDC Price: $0.004 USDC via x402.
• token_pairs — DEX pairs for token. Top liquidity pairs for a token address from DexScreener. e.g. GET /v1/token/pairs?address=0x... Price: $0.004 USDC via x402.
• token_verdict — Base token AI-style verdict card. Send a Base token contract address, get a structured verdict: onchain metrics (price, liquidity, volume, pair count), a plain-language take, risk label, and a shareable verdict card. Body JSON: { "address": "0x..." } (alias: resource). Entertainment / research helper — not trading advice. e.g. POST /v1/token/verdict {"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"} Price: $0.015 USDC via x402.
• trending_base — Trending Base tokens. Ranked Base-related tokens from DexScreener boosts/search with simple momentum/risk heuristics. e.g. GET /v1/trending/base Price: $0.006 USDC via x402.
• tweet_by_id — Single tweet by ID. One post by numeric ID: text, author, metrics (likes, retweets, replies, quotes, views). e.g. GET /tweets/by/id?id=20 Price: $0.002 USDC via x402.
• tweet_quotes — Quote tweets of a post. Posts that quote a given tweet ID (via search quoted filter). e.g. GET /tweets/quotes?id=20 Price: $0.008 USDC via x402.
• tweet_replies — Replies to a tweet. Replies to a post by numeric ID. e.g. GET /tweets/replies?id=20 Price: $0.008 USDC via x402.
• tweets_bulk — Bulk tweet lookup. Up to 50 tweets by comma-separated IDs. e.g. GET /tweets?ids=20,21,22 Price: $0.007 USDC via x402.
• user_by_id — User profile by numeric ID. Look up a public X user by numeric ID. Same fields as username lookup. e.g. GET /users/by/id?id=44196397 Price: $0.004 USDC via x402.
• user_by_username — User profile by username. Look up a public X/Twitter user by handle. Returns id, username, display name, bio, location, followers/following/statuses counts, verified flag, createdAt, profile image. Query: username (required, no @). e.g. GET /users/by/username?username=elonmusk Price: $0.004 USDC via x402.
• user_followers — Followers of a user. One page of followers by numeric user ID. e.g. GET /users/followers?id=44196397 Price: $0.008 USDC via x402.
• user_following — Accounts a user follows. One page of accounts followed by numeric user ID (GraphQL Following when available). e.g. GET /users/following?id=44196397 Price: $0.008 USDC via x402.
• user_timeline — User timeline. Recent posts from a user (newest first) with author and metrics. e.g. GET /tweets/user?username=elonmusk Price: $0.007 USDC via x402.
• wallet_intel — Base wallet intel. EOA vs contract, ETH balance, USDC balance on Base via public RPC. Body JSON: { "address": "0x..." } Price: $0.008 USDC via x402.
• x402_probe — x402 endpoint probe. Unauthenticated GET to resourceUrl; checks HTTP 402, accepts[], price sanity. Query: url (required). e.g. GET /v1/x402/probe?url=https://... Price: $0.005 USDC via x402.