{"uid":"cap_uCRVoCBe7tR27IMn0Wjed","slug":"yodeler-token-mentions-signal-api-a636d936","name":"Yodeler Token Mentions Signal API","description":"Query forwarded real-time news message logs from the database.\n\nThe `/v1/news` endpoint is designed to be monetized with x402 so clients can\npay per request before receiving message batches, while `/v1/news/quote`\nand `/v1/news/availability` expose free previews for agent workflows.\n\nDiscovery metadata is available through `/openapi.json` and\n`/.well-known/agent.json`, while `/v1/discovery` publishes the canonical\ndiscovery index for marketplaces and agent registries.\n\nEmpty result sets are returned for free, and `/v1/news/channels` offers a\nfree source-channel catalog so buyers can explore before paying.\n\nAgents can understand the tool contract,\npayment flow, supported networks, and pricing model automatically.","url":"https://x402.yodeler.xyz/v1/signals/token-mentions","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Maximum number of token items to return, ranked by mentions."},"window":{"enum":["1h","24h","6h"],"type":"string","default":"24h","description":"Lookback window for mention aggregation."},"min_mentions":{"type":"integer","default":1,"minimum":1,"description":"Only return tokens with at least this many mentions in the window."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"meta":{"as_of":"2026-07-07T12:00:00Z","limit":25,"cached":false,"window":"24h","is_free":false,"license":"yodeler-data-license-1.0","valid_until":"2026-07-07T12:05:00Z","content_hash":"3f9a...","min_mentions":1,"source_count":4,"delivery_mode":"paid","message_count":42,"window_started_at":"2026-07-06T12:00:00Z"},"count":2,"items":[{"kind":"ticker","sample":"BTC just reclaimed the weekly open — watch the 1h close.","symbol":"BTC","sources":[{"name":"Watcher Guru","mentions":9,"source_id":123}],"mentions":14,"change_pct":133.3,"last_seen_at":"2026-07-07T11:58:00Z","first_seen_at":"2026-07-07T11:02:00Z","new_in_window":false,"prev_mentions":6,"unique_sources":3},{"kind":"cashtag","sample":"$PEPE volume spiking across exchanges.","symbol":"PEPE","sources":[{"name":"ITC Altcoins","mentions":5,"source_id":456}],"mentions":5,"change_pct":null,"last_seen_at":"2026-07-07T11:55:00Z","first_seen_at":"2026-07-07T11:40:00Z","new_in_window":true,"prev_mentions":0,"unique_sources":2}],"payment":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CGOyH1hkWHCCprmxsLAQH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked list of crypto token mentions aggregated from forwarded Telegram and Discord channel messages over a configurable time window.","exampleAgentPrompt":"Show me the top 25 crypto tokens being mentioned most across Telegram and Discord in the last hour, but only include ones with at least 3 mentions.","exampleUseCases":[{"title":"Spot early momentum tokens","prompt":"Pull the top 50 tokens being talked about in crypto channels over the last 6 hours and flag any that are brand new this window — I want to catch coins gaining traction early."},{"title":"Daily crypto buzz briefing","prompt":"Give me a summary of the 25 most-mentioned crypto tokens from the past 24 hours across Telegram and Discord, including how much their mention count changed versus the prior period."},{"title":"High-conviction signal filtering","prompt":"What tokens have been mentioned at least 10 times in the last hour across crypto social channels? I only want high-signal names, not noise."}],"resultDescription":"A JSON object with a `meta` block (window, limit, min_mentions, source count, message count, cache status, license, validity timestamp) and an `items` array of ranked token objects. Each item includes the token symbol, mention count, change percentage vs prior window, sample message, source channel breakdown, first/last seen timestamps, whether it's new this window, and unique source count.","failureModes":["Payment required (402) if x402 payment header is missing or insufficient — must pay $0.01 USDC before receiving data","Invalid window value (must be '1h', '6h', or '24h') returns 422 validation error","Limit out of range (must be 1-100) returns validation error","Empty result set returned with 200 if no tokens meet the min_mentions threshold in the window","Stale or cached data indicated in meta.cached field — freshness depends on ingestion pipeline"],"whenToPreferThis":"Use this endpoint when you need real-time social signal intelligence about which crypto tokens are being discussed across Telegram and Discord channels, ranked by mention frequency. Prefer it over generic news APIs or on-chain data sources when social momentum and community buzz are the signal you care about. It is especially valuable for identifying newly emerging tokens (new_in_window=true) or tracking mention velocity changes across a short time window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:36:12.516Z","isFirstParty":false}