--- name: mesh.heurist.xyz description: mesh.heurist.xyz provides a collection of data-fetching skills spanning Solana token discovery, EVM wallet holdings, Twitter/X social monitoring, web scraping, and historical price data. It does not execute trades or stream live data; all skills return point-in-time snapshots or paginated historical records. The host is oriented toward research, monitoring, and pre-trade due diligence workflows. host: mesh.heurist.xyz --- # mesh.heurist.xyz Heurist Mesh is a multi-domain data aggregation host serving agents that need to combine on-chain token intelligence (Solana Pump.fun lifecycle, EVM wallet holdings, USDC flow on Base) with off-chain signals (Twitter timelines, mentions, trending token lists, web page summaries, and Yahoo Finance OHLCV). It is not a trading or execution host; it supplies the informational inputs that precede decisions. Its distinguishing characteristic is breadth across Solana-specific memecoin data, EVM portfolio snapshots, and social analytics in a single host. ## When to use this host Use mesh.heurist.xyz when an agent needs Solana memecoin lifecycle data (Pump.fun creation, graduation, token resolution), EVM wallet portfolio snapshots, USDC on-chain forensics on Base, Twitter account monitoring, trending token lists, Yahoo Finance OHLCV history, or LLM-assisted web scraping. Do not use this host for trade execution, swap quotes, or order routing — use a DEX aggregator or trading API instead. Do not use it for real-time streaming price feeds or live order book data; all outputs are point-in-time snapshots. For non-EVM chains other than Solana (e.g. Bitcoin, Cosmos), this host has no coverage. For hashtag or keyword-based Twitter search across all users, a dedicated Twitter search API is needed as the social skills here are account-specific only. ## Capabilities ### Solana Token Discovery Covers the full Pump.fun token lifecycle — from newly created tokens through graduation to DEX listing — and resolves any Solana token by address, symbol, or name with current market context. - **`fetch-pumpfun-recent-token-creations`** — Returns a paginated list of tokens recently created on Pump.fun (Solana), including name, symbol, mint address, block time, decimals, initial amount, and signer. - **`fetch-pumpfun-graduated-tokens`** — Returns recently graduated Pump.fun tokens on Solana with current USD price and market cap for each token, filtered by a configurable lookback window. - **`search-solana-token`** — Searches Solana tokens by mint address, symbol, or name and returns up to 5 candidates with price, liquidity, volume, and top DEX pair data. ### Trending Token Intelligence Identifies tokens currently gaining traction on CEXs and DEXs across chains, with contract addresses and social links, enabling agents to surface momentum plays or meme token activity. - **`fetch-trending-tokens`** — Returns a list of trending tokens most talked about and traded on CEXs and DEXs, optionally filtered by chain, with token addresses, names, symbols, and social links. ### EVM Wallet & On-Chain Analytics Provides current EVM wallet token holdings across multiple networks and a forensic USDC activity summary on Base, enabling portfolio snapshots and wallet-level due diligence. - **`fetch-wallet-tokens`** — Returns all token holdings for an EVM wallet address, including quantity, USD value, 24-hour price change, chain, and token contract address across multiple EVM networks. - **`fetch-usdc-base-snapshot`** — Returns a wallet's USDC activity snapshot on Base including first/last seen timestamps, transfer counts, and total in/out/net USDC flow. ### Historical Price Data Returns OHLCV candlestick data for stocks and major crypto assets over configurable time windows via Yahoo Finance, supporting trend analysis and backtesting inputs. - **`fetch-yahoo-price-history`** — Returns historical OHLCV candlestick data for stocks and major cryptocurrencies at 1h or 1d intervals via Yahoo Finance. ### Twitter/X Social Monitoring Retrieves a specific account's recent tweets with engagement metrics and fetches time-filtered mentions of an account, enabling activity monitoring, announcement tracking, and social sentiment inputs. - **`fetch-twitter-user-timeline`** — Fetches a Twitter/X user's recent posts including profile metadata, tweet text, engagement stats, and source URLs for a given handle or user ID. - **`fetch-smart-mentions-feed`** — Returns a time-filtered list of Twitter mentions for a given username, each with a timestamp, mention type, mentioning user URL, post URL, and post ID. ### Web Content Extraction Scrapes up to five URLs and uses an LLM to extract targeted information or produce a consolidated summary, useful for pulling facts from documentation, news articles, or project pages. - **`scrape-and-summarize-urls`** — Scrapes up to 5 URLs and uses an LLM to extract specific information or generate a consolidated summary from the scraped page contents. ## Workflows ### Pump.fun Memecoin Due Diligence *Use when an agent needs to evaluate a recently graduated Pump.fun token before taking a position or reporting on it.* 1. **`fetch-pumpfun-graduated-tokens`** — Retrieve recently graduated tokens to identify candidates by price and market cap. 2. **`search-solana-token`** — Resolve the selected token's mint address to confirm identity and retrieve current DEX pair data, liquidity, and 24h volume. 3. **`fetch-trending-tokens`** — Check whether the token appears in the current trending list to gauge broader market attention. ### New Token Launch Monitoring *Use when an agent needs to track newly created Pump.fun tokens and determine which ones have progressed to graduation.* 1. **`fetch-pumpfun-recent-token-creations`** — Pull the latest token creations on Pump.fun to build a candidate list. 2. **`fetch-pumpfun-graduated-tokens`** — Cross-reference against recently graduated tokens to identify which new launches have crossed the graduation threshold. 3. **`search-solana-token`** — Resolve confirmed graduates to get current price, liquidity, and top DEX pair details. ### Token Project Social & Web Research *Use when an agent needs to assess the social presence and public information of a token project before making a recommendation.* 1. **`fetch-trending-tokens`** — Identify the token and retrieve its associated social media links. 2. **`fetch-twitter-user-timeline`** — Fetch recent tweets from the project's Twitter account to assess activity and announcements. 3. **`fetch-smart-mentions-feed`** — Retrieve recent mentions of the project's Twitter handle to gauge community discussion volume. 4. **`scrape-and-summarize-urls`** — Scrape the project's website or documentation URLs to extract key technical or team details. ### EVM Wallet Profile & USDC Flow Analysis *Use when an agent needs a comprehensive view of an EVM wallet's current holdings and its USDC transaction history on Base.* 1. **`fetch-wallet-tokens`** — Retrieve all current token holdings across EVM chains with USD values and 24h price changes. 2. **`fetch-usdc-base-snapshot`** — Pull the wallet's USDC inflow, outflow, and net flow history on Base to assess stablecoin activity patterns. ## Skill reference ### `search-solana-token` **Solana Token Resolver** — Searches Solana tokens by mint address, symbol, or name and returns up to 5 candidates with price, liquidity, volume, and top DEX pair data. *Use when:* Use when an agent needs to resolve an ambiguous or unfamiliar Solana token — by mint address, ticker, or name — to confirm its identity and retrieve current market context such as price, 24h volume, and top trading pairs before executing a trade or displaying token info. *Not for:* Do not use to search for multiple tokens in a single call; issue one query per token. Not suitable for streaming price feeds or historical OHLCV data. **Inputs:** - `query` (string, required) — The search term: a Solana mint address, token symbol/ticker, or token name. - `chain` (string) — Blockchain identifier. Should be 'solana' for this endpoint. - `limit` (integer) — Maximum number of candidate tokens to return. Defaults to 5. - `type_hint` (string) — Optional hint about the query type to improve resolution accuracy (e.g. 'Solana mint address', 'symbol', 'token name'). - `debug` (boolean) — If true, enables debug output in the response. **Returns:** Returns a results array with up to 5 token candidates; each entry includes name, symbol, mint address, price_usd, and a top_pairs array with per-DEX volume, liquidity, 24h transaction counts, and price change percentages. **Example:** `{"query": "So11111111111111111111111111111111111111112", "chain": "solana", "limit": 5, "type_hint": "Solana mint address", "debug": false}` --- ### `fetch-yahoo-price-history` **Heurist Yahoo Price History** — Returns historical OHLCV candlestick data for stocks and major cryptocurrencies at 1h or 1d intervals via Yahoo Finance. *Use when:* Use when an agent needs historical price data (open, high, low, close, volume) for a stock ticker or crypto asset over a rolling window or specific date range. *Not for:* Do not use for real-time streaming price feeds or live quotes; this returns historical OHLCV snapshots only. Not suitable for assets without a Yahoo Finance ticker. **Inputs:** - `symbol` (string, required) — Stock ticker (e.g. AAPL) or crypto symbol with -USD suffix (e.g. BTC-USD). - `interval` (string) — Candlestick interval. Allowed values: '1h' or '1d'. Defaults to '1d'. Intraday (1h) is limited to the last 60 days. - `period` (string) — Rolling window shorthand: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max. Ignored if start_date or end_date is provided. Defaults to '6mo'. - `start_date` (string) — Start of the date range (takes precedence over period when provided). - `end_date` (string) — End of the date range (takes precedence over period when provided). - `debug` (boolean) — Debug mode flag. Always set to false in production. **Returns:** Returns a result object containing historical OHLCV data for the requested symbol and interval, or a status message when debug mode is enabled. **Example:** `{"symbol": "AAPL", "interval": "1d", "period": "3mo", "debug": false}` --- ### `scrape-and-summarize-urls` **Heurist ExaSearch Digest** — Scrapes up to 5 URLs and uses an LLM to extract specific information or generate a consolidated summary from the scraped page contents. *Use when:* Use when an agent needs to extract structured information or a concise digest from one to five web pages, such as pulling key facts, technical details, or summaries from documentation, news, or blog pages. *Not for:* Do not use for real-time data feeds, more than 5 URLs per call, or tasks requiring structured data extraction from APIs rather than web pages. Not suitable for authenticated or paywalled pages that cannot be scraped. **Inputs:** - `urls` (array, required) — List of source URLs to scrape. Maximum 5 URLs per batch. - `extract_prompt` (string) — Instruction to the LLM for processing scraped contents. Max 3 sentences. Use to extract specific information; if omitted, a summary is returned instead. - `debug` (boolean) — Debug mode flag. Always set to false in production use. **Returns:** Returns a result object with status='success' and a processed_summary string containing an LLM-generated digest with inline source citations for each scraped URL. **Example:** `{"urls": ["https://solana.com/news", "https://docs.solana.com/", "https://blog.solana.com/"], "debug": false, "extract_prompt": "Extract the main thesis and key technical points from each page, then produce a concise consolidated summary."}` --- ### `fetch-usdc-base-snapshot` **Heurist USDC Base Snapshot** — Returns a wallet's USDC activity snapshot on Base including first/last seen timestamps, transfer counts, and total in/out/net USDC flow. *Use when:* Use when an agent needs a quick forensic summary of a wallet's USDC history on Base — total transaction count, inbound/outbound counts, cumulative USDC received and sent, and net flow — without querying raw on-chain data. *Not for:* Do not use for non-USDC token balances or activity; use a general token analytics endpoint instead. Not suitable for real-time streaming or multi-chain USDC analysis beyond Base. **Inputs:** - `address` (string, required) — Wallet address to look up, starting with 0x. - `debug` (boolean) — Debug mode flag. Always use false in production. **Returns:** Returns a result object with status='success' and a data block containing the normalized address, first/last seen timestamps, total/in/out transaction counts, and total_in_usdc, total_out_usdc, net_flow_usdc (null when no activity exists). **Example:** `{"address": "0x7f9b2a4c3d1E8B6f1cA2B7a9C0dE3f4A5b6C7d8E", "debug": false}` --- ### `fetch-twitter-user-timeline` **Heurist X User Timeline** — Fetches a Twitter/X user's recent posts, profile metadata, and engagement stats given a username, returning up to a specified number of items with pagination support. *Use when:* Use when an agent needs a Twitter/X user's latest tweets, retweets, or quote-tweets — including text, timestamps, engagement metrics, and source URLs — to summarize activity, track announcements, or monitor a public figure's feed. *Not for:* Do not use for keyword or hashtag searches across all users; use a Twitter search API instead. Not suitable for fetching replies to a specific tweet or DMs. **Inputs:** - `username` (string, required) — Twitter/X username (without @ prefix) whose timeline to fetch. - `identifier` (string) — Twitter/X handle with @ prefix, used as an alternate identifier alongside username. - `limit` (integer) — Maximum number of timeline items to return. - `cursor` (string) — Pagination cursor for fetching the next page of results. Pass empty string for the first page. - `debug` (boolean) — If true, enables debug mode for the request. **Returns:** Returns result.status='success' with a profile object (username, name, description, verified, followers) and an items array of recent tweets/retweets each containing text, created_at, source URL, author, type, and engagement counts (likes, replies, retweets, quotes, views). **Example:** `{"username": "vitalikbuterin", "identifier": "@vitalikbuterin", "limit": 100, "cursor": "", "debug": false}` --- ### `fetch-pumpfun-recent-token-creations` **Pump.fun Recent Tokens** — Returns a paginated list of tokens recently created on Pump.fun (Solana), including name, symbol, mint address, block time, decimals, initial amount, and signer. *Use when:* Use when an agent needs to discover or list tokens recently launched on Pump.fun on Solana, filtered by time interval, with support for pagination via limit and offset. *Not for:* Do not use for token price data, trading history, or market cap information — this endpoint returns creation metadata only, not market or trading data. **Inputs:** - `query` (string) — Search or context query string to scope the token creation lookup. - `limit` (integer) — Maximum number of token records to return. - `offset` (integer) — Number of records to skip for pagination. - `interval` (string) — Time interval granularity for grouping or filtering recent creations (e.g. 'hours'). - `debug` (boolean) — If true, enables debug mode for the request. **Returns:** Returns result.tokens array where each entry contains block_time, token_info (name, symbol, mint_address, program_address, decimals), amount, and signer for each recently created Pump.fun token. **Example:** `{"query": "pump.fun solana", "limit": 25, "offset": 2, "interval": "hours", "debug": false}` --- ### `fetch-trending-tokens` **Heurist Trending Tokens** — Returns a list of trending tokens most talked about and traded on CEXs and DEXs, optionally filtered by chain, with token addresses, names, symbols, and social links. *Use when:* Use when an agent needs to identify currently trending tokens on a specific blockchain or across markets, including meme tokens, with associated contract addresses and social media links. *Not for:* Do not use for historical price data, token swap quotes, or portfolio tracking; use a price feed or DEX quote API instead. **Inputs:** - `chain` (string) — Filter trending tokens by blockchain (e.g. 'solana', 'ethereum'). Omit to get cross-chain trending tokens. - `debug` (boolean) — Enable debug mode for additional diagnostic output. - `include_memes` (boolean) — When true, includes meme tokens in the trending results. **Returns:** Returns result.status='success' and result.data.solana_trending containing a chain name, last_updated timestamp, and a tokens array with address, name, symbol, and social links for each trending token. **Example:** `{"chain": "solana", "debug": false, "include_memes": true}` --- ### `fetch-pumpfun-graduated-tokens` **PumpFun Graduates (Heurist)** — Returns recently graduated Pump.fun tokens on Solana with their current USD price and market cap, filtered by timeframe and optional keyword query. *Use when:* Use when an agent needs a list of Pump.fun tokens that have recently crossed the graduation market cap threshold, including their price and market cap data, to analyze trending or newly liquid Solana memecoins. *Not for:* Do not use for real-time price streaming or historical price charts; this is a single-shot snapshot of recently graduated tokens only. Not suitable for tokens that have not yet graduated from Pump.fun. **Inputs:** - `query` (string) — Optional keyword to filter graduated tokens by name or symbol. - `limit` (integer) — Maximum number of graduated tokens to return. - `timeframe` (integer) — Lookback window in hours for recently graduated tokens. - `debug` (boolean) — If true, enables debug mode for the request. **Returns:** Returns a result object containing a graduated_tokens array where each entry includes price_usd, market_cap_usd, and token_info (name, symbol, mint_address) for each recently graduated Pump.fun token. **Example:** `{"query": "solana", "limit": 10, "timeframe": 24, "debug": false}` --- ### `fetch-twitter-user-timeline` **Heurist Twitter Timeline** — Fetches a Twitter/X user's recent posts including profile metadata, tweet text, engagement stats, and source URLs for a given handle or user ID. *Use when:* Use when an agent needs to retrieve recent tweets from a specific Twitter/X account, including retweets, quotes, and original posts with engagement metrics such as likes, replies, retweets, and views. *Not for:* Do not use for searching tweets by keyword or hashtag; use a Twitter search API instead. Not suitable for fetching replies to a specific tweet or streaming live tweets. **Inputs:** - `identifier` (string, required) — Twitter/X user handle (with or without @) or numeric user_id identifying the account to fetch the timeline for. - `limit` (integer) — Maximum number of tweets to return in the response. - `cursor` (string) — Pagination cursor from a prior call to retrieve the next page of results. - `debug` (boolean) — Debug mode flag. Always set to false in production use. **Returns:** Returns a success status with a profile object (username, name, verified, followers) and an items array of recent tweets each containing text, date, source URL, tweet type, and engagement metrics. **Example:** `{"identifier": "vitalikbuterin", "limit": 20, "debug": false}` --- ### `fetch-smart-mentions-feed` **Heurist Smart Mentions Feed** — Returns a time-filtered list of Twitter mentions for a given username, each with a timestamp, mention type, mentioning user URL, post URL, and post ID. *Use when:* Use when an agent needs to retrieve recent Twitter mentions of a specific account within a date range, for monitoring, analytics, or summarizing who is talking about a user on Twitter. *Not for:* Do not use for fetching a user's own tweets or replies; use a timeline endpoint instead. Not suitable for real-time streaming of mentions — this is a paginated historical query. **Inputs:** - `username` (string, required) — Twitter username without the @ symbol. - `limit` (integer) — Maximum number of mentions to return. Defaults to 100. - `fromDate` (integer) — Unix timestamp of the earliest mention to include. - `toDate` (integer) — Unix timestamp of the most recent mention to include. - `debug` (boolean) — Debug mode flag. Always use false in production. **Returns:** Returns a result object with the queried username and a data.items array of mention events, each containing a Unix timestamp, event type 'NEW_MENTION', the mentioning user's profile URL, the tweet URL, and the tweet ID. **Example:** `{"username": "vitalikbuterin", "limit": 10, "fromDate": 1714521600, "toDate": 1715136000, "debug": false}` --- ### `fetch-pumpfun-graduated-tokens` **Heurist Pump.fun Graduated Tokens** — Returns recently graduated Pump.fun tokens on Solana with current USD price and market cap for each token, filtered by a configurable lookback window. *Use when:* Use when an agent needs a list of Pump.fun tokens that have recently graduated to a DEX, including their current price, market cap, name, symbol, and mint address, within a specified number of hours. *Not for:* Do not use for tokens that have not yet graduated from Pump.fun, for real-time streaming price feeds, or for non-Solana token data. **Inputs:** - `debug` (boolean) — Debug mode flag. Should always be set to false in production use. - `timeframe` (number) — Timeframe in hours to look back for graduated tokens. Defaults to 24. **Returns:** Returns a result object containing a graduated_tokens array, each entry with price_usd, market_cap_usd, and token_info (name, symbol, mint_address) for recently graduated Pump.fun tokens on Solana. **Example:** `{"debug": false, "timeframe": 24}` --- ### `fetch-wallet-tokens` **EVM Wallet Token Holdings** — Returns all token holdings for an EVM wallet address, including quantity, USD value, 24-hour price change, chain, and token contract address across multiple EVM networks. *Use when:* Use when an agent needs a snapshot of an EVM wallet's current token portfolio, including per-token USD values, quantities, 24h price changes, and which chains the tokens are held on. *Not for:* Do not use for non-EVM wallets (e.g. Solana, Bitcoin). Not suitable for real-time streaming price feeds or historical portfolio data — this is a single-shot current holdings snapshot. **Inputs:** - `wallet_address` (string, required) — The EVM wallet address (starting with 0x, 42 characters long) to analyze. Use 'SELF' to reference the user's own wallet address. - `debug` (boolean) — Debug mode flag. Always set to false in production use. **Returns:** Returns a result object with total_value (USD), token_count, and a tokens array where each entry includes name, symbol, quantity, USD value, current price, 24h change percent, chain, and token contract address (null for native assets). **Example:** `{"wallet_address": "0x402Feee072D655B85e08f1751AF9ddbCd249521f", "debug": false}` ---