Tg Scan
by api.cn402.com in Onchain & crypto
在一批公开 Telegram 频道里按关键词扫描并给出热度信号。传 preset 一键选内置币圈频道库(news 英文快讯/whale 链上鲸鱼/cn 中文媒体/all),或自传频道。返回命中帖子、按频道聚合命中数、signal 热度(high/medium/low/quiet + 最热频道)。用于叙事追踪、舆情情绪、聪明钱信号、空投上新。Scan public Telegram channels for keyword mentions with a heat signal. Use preset for a curated crypto channel list or pass your own. Returns matches, per-channel counts, and a snapshot heat signal. For narrative tracking, sentiment and smart-money signals. Accepts payment on Base or Solana — either network works.
GET https://api.cn402.com/tg/scan
Last 30 days
Status and outage history · Atom feed
- Uptime
- 100%
- Response time
- 523 ms typical, 605 ms slowest 5%
- Last check
- 3 h ago
- Next check
- any minute now
How to call it
GET https://api.cn402.com/tg/scan
Each call costs $0.02 in USDC on Base, paid with the request over x402.
Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.
Example request
From the listing.
GET https://api.cn402.com/tg/scan?channels=string&limitPerChannel=string&preset=string&query=string&windowHours=stringParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channels | string | No | Comma-separated list of public Telegram channel usernames to scan, e.g. durov,telegram (max 15). Leading @ and full t.me URLs are accepted. JSON arrays are also accepted in a POST body. Optional if preset is given. |
limitPerChannel | string | No | Recent messages to scan per channel, 1-50 (default 20). |
preset | string | No | Optional. Pick a curated built-in crypto channel list instead of naming channels: news (EN crypto news), whale (on-chain & whale alerts), cn (Chinese crypto media), or all. Comma-separated presets are merged (e.g. news,whale). Combine with channels= to add your own. |
query | string | Yes | Keyword(s) to match in post text, case-insensitive. Comma-separated terms are OR-matched (e.g. pepe,airdrop). If omitted, returns a merged newest-first feed with no filter (and a volume-based signal). |
windowHours | string | No | Optional. Only return posts published within the last N hours (1-720). |
Example response
The listing has no example response.
Call it from code
The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.02.
curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://api.cn402.com/tg/scan?channels=string&limitPerChannel=string&preset=string&query=string&windowHours=string'
# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://api.cn402.com/tg/scan?channels=string&limitPerChannel=string&preset=string&query=string&windowHours=string' \
| grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decodeJavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
// Pays at most $0.02 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.02" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);
// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.02 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.cn402.com%2Ftg%2Fscan
const res = await pay("https://api.cn402.com/tg/scan?channels=string&limitPerChannel=string&preset=string&query=string&windowHours=string");
console.log(res.status, await res.text());Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client
# Pays at most $0.02 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.02"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))
with x402_requests(client) as session:
res = session.get("https://api.cn402.com/tg/scan?channels=string&limitPerChannel=string&preset=string&query=string&windowHours=string")
print(res.status_code, res.text)Security scan
- No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.
Recent checks
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 3 h ago | Passed | 402 | 166 ms | $0.02 |
| 7 h ago | Passed | 402 | 507 ms | $0.02 |
| 11 h ago | Passed | 402 | 540 ms | $0.02 |
| 15 h ago | Passed | 402 | 523 ms | $0.02 |
| 19 h ago | Passed | 402 | 517 ms | $0.02 |
| 23 h ago | Passed | 402 | 543 ms | $0.02 |
| 26 h ago | Passed | 402 | 542 ms | $0.02 |
| 30 h ago | Passed | 402 | 509 ms | $0.02 |
| 34 h ago | Passed | 402 | 511 ms | $0.02 |
| 38 h ago | Passed | 402 | 518 ms | $0.02 |
| 41 h ago | Passed | 402 | 196 ms | $0.02 |
| 44 h ago | Passed | 402 | 516 ms | $0.02 |
| 2 days ago | Passed | 402 | 610 ms | $0.02 |
| 2 days ago | Passed | 402 | 564 ms | $0.02 |
| 2 days ago | Passed | 402 | 605 ms | $0.02 |