elfa_token_news
Read-only
Retrieve token news and sentiment data for cryptocurrency analysis. Filter by symbols, chain, time periods, and sources to monitor market trends.
Instructions
Token news. Params: symbols (comma), chain, start, end, limit, cursor, sources.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbols | No | ||
| chain | No | ||
| start | No | ||
| end | No | ||
| limit | No | ||
| cursor | No | ||
| sources | No |
Implementation Reference
- mcp-server.js:199-209 (handler)The main handler function for the MCP tool 'elfa_token_news'. It processes input arguments into query parameters and delegates the HTTP request to the generic 'elfa_query' handler targeting the ELFA '/v2/data/token-news' endpoint.
"elfa_token_news": async (args, meta) => { const query = {}; if (args && args.symbols !== undefined) query.symbols = args.symbols; // "ETH,BTC" if (args && args.chain !== undefined) query.chain = args.chain; if (args && args.start !== undefined) query.start = args.start; if (args && args.end !== undefined) query.end = args.end; if (args && args.limit !== undefined) query.limit = args.limit; if (args && args.cursor !== undefined) query.cursor = args.cursor; if (args && args.sources !== undefined) query.sources = args.sources; return toolHandlers["elfa_query"]({ path: "/v2/data/token-news", method: "GET", query }, meta); }, - mcp-server.js:310-317 (registration)The tool registration entry in the 'tools' array, which defines the name, description, input schema, and annotations for 'elfa_token_news'. This is returned by tools/list.
{ name:"elfa_token_news", description:"Token news. Params: symbols (comma), chain, start, end, limit, cursor, sources.", inputSchema:{ type:"object", properties:{ symbols:{type:"string"}, chain:{type:"string"}, start:{type:"string"}, end:{type:"string"}, limit:{type:"number"}, cursor:{type:"string"}, sources:{type:"string"} }}, annotations:{ title:"ELFA: Token News", readOnlyHint:true, openWorldHint:true } }, - services/elfa.js:54-63 (helper)A utility helper function 'elfaTokenNews' that performs a safe GET request to ELFA '/v2/data/token-news' endpoint. Used in index.js for debug endpoints, similar logic to the MCP handler.
export const elfaTokenNews = async (opts) => { const { coinIds, page = 1, pageSize = 20, reposts = false } = opts; const params = { coinIds, page, pageSize, reposts }; if ('from' in opts && 'to' in opts && opts.from != null && opts.to != null) { params.from = opts.from; params.to = opts.to; } else { params.timeWindow = opts.timeWindow || '7d'; } return safeGet('/v2/data/token-news', params); };