제품 가이드 - Telegram 알림

Telegram 알림

가격 스파이크와 신규 차익거래 진입을 알려주는 개인 푸시 알림입니다. 직접 소유한 Telegram 봇이 전달하며, 전적으로 사용자의 임계값에 맞춰 조정됩니다.

Web3Map Telegram 알림은 두 종류의 신호를 휴대폰으로 바로 푸시합니다. 가격 스파이크(Price Spikes)는 하나 이상의 시간 윈도우에서 어떤 베뉴(venue)의 가격이 비정상적으로 움직일 때, 신규 진입(New Entries)은 사용자의 최소 스프레드를 넘는 새로운 차익거래 갭이 방금 나타났을 때 발생합니다. 두 알림 모두 사용자와 사용자 소유의 봇 사이의 1:1 개인 Telegram 채팅으로 도착합니다. Web3Map은 하나의 봇을 여러 사용자가 공유하게 하지 않습니다. 봇은 BotFather로 직접 만들어 직접 보유하며, Web3Map은 알림 파이프라인이 채팅에 메시지를 전송할 수 있도록 토큰을 암호화된 형태로만 저장합니다.

필요 조건: 활성 상태의 Pro(또는 그 이상) 플랜과 Telegram 계정이 필요합니다. 이 기능 전체가 프리미엄 이용 권한으로 게이트되어 있습니다. My Page에서 Free 계정에는 Premium alerts 카드 자체가 표시되지 않고, Pro 기간이 만료된 계정에는 설정 카드 대신 Upgrade to Pro to enable private Telegram alerts.가 표시되며, 서버는 등록과 연결 요청을 Premium entitlement required로 거부합니다.

전체 흐름을 한 문단으로 요약하면: @BotFather로 전용 봇을 만들고 그 HTTP API 토큰을 My Page의 Premium alerts 카드에 붙여넣습니다. Web3Map이 토큰을 검증하고 봇의 웹훅과 슬래시 명령어 메뉴를 구성한 뒤, 일회용 딥링크를 발급합니다. 딥링크를 열어 개인 채팅에서 /start를 보내면 해당 채팅이 Web3Map 계정에 연결됩니다. 이후 알림은 그 채팅으로 푸시되며, 같은 채팅이 설정 콘솔 역할도 겸합니다. 인라인 메뉴와 슬래시 명령어로 웹사이트를 열지 않고도 신호를 켜고 끄고, 임계값을 수정하고, 뮤트 리스트를 관리할 수 있습니다.

설정 안내

모든 과정은 My Page의 Premium alerts 카드(사이드바 항목 Premium Alerts)에서 진행됩니다. 카드 키커는 Telegram, 부제는 Receive premium price spikes and new entries in your private Telegram chat.입니다. 카드는 아래 단계와 일치하는 세 개의 번호가 매겨진 패널로 구성됩니다.

1. 봇을 연결합니다.

   Step 1 패널의 제목은 Connect your bot이고 설명은 Create a dedicated bot with BotFather and register its token.입니다. 패널에는 다음 세 가지 안내가 그대로 표시됩니다:

   1. Talk to @BotFather on Telegram and send /newbot.
   2. Copy the HTTP API token and paste it below. It is encrypted at rest.
   3. Open the generated deep link and send /start in the private chat.

   Telegram에서 @BotFather에게 메시지를 보내 /newbot을 전송하고, 봇의 표시 이름과 고유한 사용자명을 정하면 BotFather가 123456:ABC-DEF... 형태의 HTTP API 토큰으로 응답합니다. 이 토큰을 BotFather token 라벨이 붙은 입력란(플레이스홀더 123456:ABC-DEF...와 힌트 Stored encrypted. Rotate anytime.가 있는 비밀번호 형식 입력란)에 붙여넣고 Register bot을 누릅니다.

   서버는 무엇이든 저장하기 전에 Telegram을 통해 토큰을 직접 확인합니다:

   - 토큰은 실제 봇의 것이어야 합니다. 그렇지 않으면 등록이 Telegram token does not belong to a bot으로 실패합니다.
   - 봇이 이미 다른 서비스를 위해 동작 중이면 안 됩니다. 다른 곳을 가리키는 웹훅이 있으면 등록이 Telegram bot already has a foreign webhook으로 실패합니다.
   - Web3Map 계정당 봇은 하나입니다. 계정에 이미 등록된 봇이 있으면 A Telegram bot is already registered for this account. Use Rotate or Unlink before registering a new bot.이 표시됩니다.
   - 봇 토큰당 계정도 하나입니다. 다른 Web3Map 계정에서 이미 사용 중인 토큰은 This Telegram bot token is already connected to another Web3Map account. Unlink it from that account first, or create a new bot with BotFather and register the new bot token.으로 거부됩니다.

   검증을 통과하면 Web3Map은 봇의 웹훅을 설정하고(봇별 시크릿 포함), 전체 슬래시 명령어 메뉴를 봇에 설치하고, 봇의 메뉴 버튼을 그 명령어 목록으로 전환한 뒤, 토큰을 암호화하여 저장합니다. 아직 개인 채팅이 연결되지 않았으므로 자격 증명은 pending_chat 상태로 시작합니다. 토큰 등록은 5분당 5회 시도로 제한됩니다.

2. 딥링크를 열고 /start를 보냅니다.

   등록 직후 카드에는 키커 Deep link ready, 현지 시간 기준의 Expires 타임스탬프, 그리고 https://t.me/your_bot?start=... 형태의 전체 링크가 담긴 박스가 표시됩니다. 링크는 10분 후 만료되며 최대 5회 시도를 허용합니다. 만료되었다면 Step 2 패널에서 New deep link를 눌러 새 링크를 발급하세요(새 링크를 발급하면 이전의 대기 중 링크는 무효화됩니다).

   딥링크를 엽니다. Telegram이 봇과의 개인 채팅을 열고 링크 토큰이 첨부된 /start를 전송합니다. 성공하면 봇이 확인 메시지로 응답하면서 곧바로 설정 메뉴를 보여줍니다:

   W

   my_web3map_alerts_bot

   bot

   /start14:02

   Web3Map premium Telegram alerts linked.
   
   Telegram alert settings
   
   Price spikes: on
   Sell Rise: on
   Buy Drop: on
   New entries: on
   New entries min spread: 1%
   
   Choose a section below. 14:02

   Price spikesNew entries

   Refresh

   연결되면 자격 증명이 active로 전환되고, 개인 채팅이 기록되며, 기본 알림 설정(모든 신호 유형 켜짐, 기본 윈도우와 임계값)이 생성됩니다. 이제 알림을 받기 시작합니다.

3. 알림 규칙을 조정합니다.

   Step 3 패널 Alert rules(Tune which signals are delivered to your Telegram chat.)에서는 어떤 신호를 발동시킬지, 윈도우별 스파이크 임계값, 신규 진입 스프레드 하한, 뮤트 리스트를 설정합니다. 자세한 내용은 알림 규칙 (웹)에서 다룹니다. Telegram 채팅 안에서도 모든 것을 변경할 수 있습니다. 명령어 레퍼런스와 인라인 메뉴를 참고하세요.

전송 상태 패널

Step 2 패널의 제목은 Delivery status이고 설명은 Live state of your Telegram credential and private chat.입니다. 세 개의 행과 두 개의 버튼이 표시됩니다. 패널은 30초마다, 그리고 브라우저 탭으로 돌아올 때마다 새로고침됩니다.

Delivery 행

"지금 알림을 받고 있는가"에 대한 단 하나의 답입니다. 프리미엄 이용 권한이 유효하고, 봇 자격 증명이 active이고, 개인 채팅이 연결되어 active인 세 조건이 동시에 성립할 때만 Active가 표시됩니다. 그 외에는 모두 Inactive입니다.

Credential 행

봇을 @bot_username 형태로, 원시 상태 배지와 함께 보여줍니다. 토큰을 등록한 직후 /start를 보내기 전에는 상태가 pending_chat입니다. 연결 후에는 active가 됩니다. 아직 등록된 봇이 없으면 Not registered가 표시됩니다.

Private chat 행

1:1 채팅 연결의 상태입니다. 딥링크를 열고 /start를 보내기 전에는 Not linked, 연결되면 active, 전송이 일시정지되면(/pause를 실행했거나 Telegram에서 봇을 차단한 경우) paused가 표시됩니다.

New deep link 버튼

등록된 봇에 대해 새 10분짜리 딥링크를 발급하고, 기존의 대기 중 링크를 무효화합니다. 원래 링크가 만료되었거나, 5회 시도 한도에 도달했거나, 토큰 로테이션 이후에 사용하세요. 봇 자격 증명이 있을 때만 사용할 수 있으며, 없으면 서버가 No reconnectable Telegram bot credential로 응답합니다. 딥링크 발급은 5분당 10회 요청으로 제한됩니다.

Unlink 버튼

완전한 연결 해제입니다. 자격 증명, 채팅 연결, 대기 중인 딥링크를 모두 무효화하고, 저장된 암호화 토큰을 삭제하며, 봇에서 웹훅을 제거합니다. 연결 해제 후 봇은 Web3Map 구성이 전혀 남지 않은 온전한 사용자 소유가 됩니다. 다시 시작하려면 Step 1에서 토큰을 재등록합니다.

알림 유형과 메시지 구조

두 알림 패밀리는 같은 전송 파이프라인과 같은 서식 규칙을 공유합니다:

Price Spikes 메시지

가격 스파이크 알림은 베뉴의 가격이 여섯 개 폴링 윈도우 중 하나 안에서 사용자의 임계값 이상으로 움직일 때 발동합니다. 한 자산에 대한 첫 알림은 다음과 같습니다:

Buy  | $0.0512 -> $0.0721
Sell | $0.0509 -> $0.0718

Buy  | $0.0510 -> $0.0703
Sell | $0.0508 -> $0.0699

Buy  | $0.0489 -> $0.0721
Sell | $0.0486 -> $0.0718

줄별 설명:

헤더 줄

방향 아이콘(Sell Rise는 상승 차트, Buy Drop은 하락 차트), 대괄호 안의 발동 윈도우(예: [Sell Rise 30s, 5m]), Web3Map 그래프로 연결되는 자산 심볼 링크, 부호가 붙은 스파이크 크기 순서입니다. Sell Rise는 양수 퍼센트를, Buy Drop은 음수 퍼센트를 보여줍니다(예: [Buy Drop 1h] SYMBOL -45.00%). 이미 알림을 받은 에피소드의 연속 알림이라면 에피소드 시작 후 경과 시간이 뒤에 붙습니다(예: (13m 20s)).

윈도우 서브헤더

두 개 이상의 윈도우가 동시에 발동하면 각 윈도우는 모래시계 아이콘이 붙은 굵은 서브헤더(예: 5m:)를 갖고, 윈도우 길이 오름차순으로 나열됩니다. 단일 윈도우 알림은 서브헤더를 생략합니다.

베뉴 줄

베뉴당 한 줄의 굵은 텍스트입니다. 베뉴 이름, 파이프, 이탤릭체 체인, 해당 베뉴의 변동 순서입니다(예: uniswap | eth: +32.10%). 각 윈도우 블록은 스파이크가 발생한 모든 CEX와 perp 베뉴, 그리고 체인별 최고 DEX를 나열하며, 윈도우당 8개 베뉴로 제한됩니다.

D/W 마커가 붙은 CEX 체인 라벨

CEX 베뉴의 체인 목록에는 입출금 마커가 붙습니다(예: eth(D/W), ton(D)). D는 해당 체인에서 입금이 열려 있다는 뜻이고, W는 출금이 열려 있다는 뜻입니다. 체인은 상태가 활성화되어 있고 동시에 최신(최근 5분 이내 갱신)일 때만 나열되므로, 보이는 정보는 오래된 거래소 메타데이터가 아니라 실제로 활용 가능한 정보입니다.

Buy/Sell 가격 블록

Buy와 Sell 두 행으로 이루어진 고정폭 블록이며, 각 행은 이전 가격과 현재 가격을 보여줍니다(예: $0.0512 -> $0.0721). 양쪽을 모두 보여주므로 스프레드 자체가 벌어졌는지, 호가 전체가 움직였는지 알 수 있습니다.

CA: 줄

토큰 컨트랙트 주소이며, 탭하여 복사할 수 있는 고정폭 글꼴로 표시됩니다. 멀티체인 CEX 베뉴의 경우 CA: 헤더 뒤에 체인별로 이탤릭체 체인 라벨과 주소가 한 줄씩 표시되고, 각 주소마다 별도의 링크 행이 붙습니다.

Pool: 줄

DEX 베뉴 전용입니다. 견적이 나온 풀 주소이며, 역시 탭하여 복사할 수 있습니다.

링크 행 CMC | DS | GMGN

고정된 순서의 굵은 외부 링크입니다. CMC는 CoinMarketCap(슬러그가 알려진 경우 통화 페이지, 아니면 CoinMarketCap의 DEX 토큰 페이지)을, DS는 DEXScreener를, GMGN은 gmgn.ai를 엽니다. 각 링크는 해당 서비스가 그 체인을 지원할 때만 표시되므로 일부 행은 링크가 적게 보입니다. 네이티브 코인에는 링크 행이 없습니다.

Time 줄

Time: 2026-06-12 14:02:31 UTC. 알림 스냅샷의 UTC 타임스탬프입니다.

한 에피소드의 두 번째 알림부터는 윈도우 블록에 에피소드 전체 요약과 가격 추이가 추가됩니다:

Buy  | $13.00 -> $16.92
Sell | $12.97 -> $16.90

요약 줄(순환 화살표 아이콘)

+69.00% from start ($10.00 → $16.90)은 에피소드가 시작된 가격에서 가장 최근 알림 가격까지, 에피소드 전체의 누적 변동을 보여줍니다. 같은 에피소드에서 한 윈도우가 두 번 이상 알림을 보낸 시점부터 나타납니다.

PA: 가격 추이(차트 아이콘)

에피소드의 가격 진행 과정으로, 알림당 한 지점(각 단계에서 그 윈도우의 극값)이 최대 6개까지 표시됩니다. 마지막 구간만 굵게 표시되어 가장 최근 변동에 시선이 가도록 합니다. PA는 price action의 약자입니다.

New Entries 메시지

신규 진입 알림은 차익거래 페어가 사용자의 최소 스프레드를 넘어 실시간 기회 목록에 진입할 때 발동합니다. 메시지는 기회 전체에 대한 압축 브리핑입니다. 무엇이 움직였는지, 실행 가능한 최적 경로, 호가 양쪽, 대체 경로, 컨트랙트 주소를 담습니다.

Venue     | Price   | Gap    | Chain(W)
uniswap   | $0.0512 | +12.3% | eth
binance   | $0.0518 | +11.0% | eth, ton
gate [FB] | $0.0524 | +9.7%  | -
+2 more venues

Venue     | Price   | Gap    | Chain(D)
binance   | $0.0575 | +12.3% | ton
okx       | $0.0561 | +9.6%  | eth
binance.P | $0.0566 | +10.5% | -

Route                 | Gap    | Bridge
eth -> ton            | +12.3% | stargate
eth                   | +9.6%  | -
eth -> Binance -> ton | +6.0%  | Binance
arb -> base           | +5.5%  | Unknown

줄별 설명:

헤더 줄

[NEW ENTRY], 그래프 링크로 연결되는 자산 심볼, 아래 베뉴 테이블에서 발견된 가장 큰 갭 순서입니다.

Gap maintained: 줄(지속 진입)

갭이 여전히 열려 있지만 최근에 가격이 움직이지 않은 경우, 메시지는 mover 블록 대신 Gap maintained: 1h 5m 같은 굵은 한 줄로 스프레드가 얼마나 오래 유지되었는지 알려줍니다.

Mover: 블록(신규 진입)

진입이 막 발생한 경우, 굵은 줄이 움직인 베뉴, 방향 삼각형, 30초 변동, 영향을 받은 호가 측면을 알려줍니다. 위쪽 삼각형은 SELL 측 가격 상승을, 아래쪽 삼각형은 BUY 측 가격 하락을 뜻합니다. 두 번째 줄은 이전 가격과 현재 가격을 이탤릭체 체인과 함께 보여줍니다. mover가 DEX이면 탭하여 복사할 수 있는 CA:와 Pool: 줄이 이어집니다. 막 발생한 진입이라도 갭이 5분 넘게 열려 있었다면 Gap maintained: 줄이 추가됩니다.

Best Route: 인용 블록(별 아이콘)

최대 네 줄로 이루어진 굵은 인용 블록입니다. Buy:는 베뉴, 체인, 가격을, Sell:은 베뉴, 체인, 가격을, Bridge:는 두 레그 사이에서 자산이 이동하는 방법을, Gap:은 이 특정 경로의 스프레드를 보여줍니다. 브릿지는 stargate(eth->ton) 같은 프로토콜일 수도 있고, 거래소가 직접 체인 간에 자산을 옮기는 CEX 릴레이(Binance(eth->ton)처럼 표기)일 수도 있으며, 알려진 경로가 없으면 unknown입니다. 두 레그가 같은 토큰과 같은 체인에 있으면 Bridge: 줄은 완전히 생략됩니다. 경로 탐색은 토큰 수준 브릿지 토폴로지와 CEX 입출금 릴레이를 함께 탐색하며, 상태가 최신이고 활성화된 입출금 레그만 인정합니다.

Price: 섹션, BUY와 SELL 테이블

같은 열 너비를 공유하는 두 개의 고정폭 테이블입니다. 매수 측은 Venue | Price | Gap | Chain(W), 매도 측은 Venue | Price | Gap | Chain(D)입니다. Chain(W)는 그 베뉴에서 매수한 뒤 출금할 수 있는 체인을, Chain(D)는 그 베뉴에서 매도하기 전에 입금할 수 있는 체인을 나열합니다. 최신이고 활성화된 체인만 표시됩니다. -는 지금 조건을 충족하는 체인이 없다는 뜻이고, perp 베뉴는 온체인으로 옮길 것이 없으므로 항상 -를 표시합니다. 베뉴 이름 뒤의 [FB]는 폴백 가격 표시로, 1차 견적 소스를 사용할 수 없어 2차 소스를 사용했다는 뜻입니다. 각 측은 최대 12개 베뉴(모든 CEX와 체인별 최고 DEX가 우선)를 나열하고, 목록이 더 깊으면 +N more venues 줄이 붙습니다. 페어를 구성하지 못했지만 가격이 최신인 거래소도 비교용으로 포함되며, 그 갭은 전체 최적 상대 베뉴를 기준으로 계산됩니다.

Route: 테이블(지구본 아이콘)

갭 순으로 정렬된 대체 경로이며 Route | Gap | Bridge 형식입니다. 체인 id 하나만 있으면 브릿지가 없는 동일 체인 경로(-)입니다. 멀티홉 경로는 전체 경로를 보여줍니다. 예를 들어 eth -> Binance -> ton은 Bridge 열에 해당 CEX가 표시되고, arb -> base처럼 두 레그를 잇는 알려진 브릿지가 없으면 Unknown이 표시됩니다. 갭이 5% 이상인 경로만 최대 8행까지 나열됩니다.

CA: 섹션

마지막 섹션은 체인당 하나의 컨트랙트 주소를 나열합니다. 체인은 이탤릭체, 주소는 탭하여 복사할 수 있는 고정폭 글꼴입니다. Best Route 레그에 속한 토큰이 해당 체인의 자리를 먼저 차지합니다. 각 주소에는 별도의 외부 링크 행이 붙습니다.

외부 링크 CMC | DS | GMGN

순서는 고정입니다. CMC는 CoinMarketCap, DS는 DEXScreener, GMGN은 gmgn.ai입니다. 링크는 해당 서비스가 그 체인을 지원할 때만 표시됩니다. 위의 ton 주소에 CMC만 보이는 이유입니다. 네이티브 코인에는 링크 행이 전혀 없습니다.

알림이 발동하는 시점과 반복되는 시점

알림 양은 단순한 시간 쿨다운이 아니라 에피소드 로직으로 제어됩니다. 목표는 같은 정보를 두 번 보내지 않으면서, 변동이 계속 진행 중일 때 침묵하지 않는 것입니다.

Price Spikes: 사용자별 에피소드

각 스파이크 에피소드는 사용자별, 자산별로 추적되며 윈도우와 베뉴별 앵커를 갖습니다. 앵커는 전역 시장 기준값이 아니라 사용자가 실제로 마지막에 알림을 받은 가격입니다:

• 첫 알림: 어떤 윈도우의 실시간 변동이 그 윈도우의 임계값에 도달했고 아직 진행 중인 에피소드가 없을 때 발동합니다.
• 후속 알림: 마지막으로 알림을 받은 가격을 기준으로, 같은 방향으로, 다시 임계값 이상 가격이 움직였을 때만 발동합니다. 후속 알림은 그 앵커를 이전 가격으로 보여주고, 그 기준 대비 퍼센트와 에피소드 시작 후 경과 시간을 헤더에 표시합니다(예: (13m 20s)).
• 에피소드 만료: 추가로 조건을 충족하는 변동 없이 1시간이 지나면 에피소드가 종료됩니다. 그 자산의 다음 스파이크는 새 에피소드의 새 첫 알림으로 시작합니다.
• 윈도우는 독립적입니다: 같은 자산의 30s 에피소드와 5m 에피소드는 따로 발동할 수 있고, 여러 윈도우가 같은 순간에 조건을 충족하면 윈도우별 서브헤더가 있는 하나의 메시지로 병합됩니다.
• 중복 내용 없음: 전송 게이트는 내용의 새로움입니다. 베뉴 레그와 추이의 끝점이 이미 받은 것과 동일한 메시지는 억제되고, 실제로 진행된 에피소드나 다른 윈도우는 즉시 통과합니다. 앵커는 알림이 실제로 사용자에게 예약될 때만 전진하므로, 전송 실패가 알림을 조용히 삼키는 일은 없습니다.

이 때문에 횡보 구간에서 동일한 메시지를 열 번 받지 않습니다. 모든 후속 알림은 마지막으로 본 정확한 가격에서 다시 임계값 크기만큼의 추가 변동을 요구합니다.

New Entries: 최신성 게이트와 쿨다운

• 첫 알림: 조건을 충족하는 페어가 최근 1시간 안에 기회 목록에 진입했을 때 전송됩니다. 그보다 오래된 진입은 신규로 알림되지 않습니다.
• 재알림: 진입이 신선한 상태(갭이 5분 이내에 나타났거나, 어떤 베뉴가 1% 이상의 30초 변동을 기록한 경우)인 동안에는 최대 1시간에 한 번 재알림될 수 있습니다. 지속 상태(새 움직임 없이 갭이 살아 있는 상태)가 되면 재알림은 최대 2시간에 한 번으로 느려지고, 메시지에는 mover 대신 Gap maintained: 줄이 표시됩니다.
• 팬텀 가드: 최적 매수와 최적 매도가 같은 베뉴라면 알림이 아예 전송되지 않습니다.

웹에서의 알림 규칙

Step 3 패널 Alert rules(Tune which signals are delivered to your Telegram chat.)는 봇이 전달하는 모든 것을 제어하는 전체 폭 설정 영역입니다. 변경 사항은 로컬에 모였다가 Save changes를 누를 때만 적용되며, 푸터에 Changes apply only after you save.라는 안내가 표시됩니다.

신호 유형

네 개의 마스터 토글이 있으며 모두 기본적으로 켜져 있습니다:

Price spikes

화면 설명: Abnormal movement across polling windows. 스파이크 패밀리 전체의 마스터 스위치입니다. 끄면 윈도우 설정과 무관하게 스파이크 알림이 오지 않습니다.

Sell Rise

Notify when sell-side prices rise sharply. 방향 토글: 매도 가격이 급등한 알림(높은 가격에 매도할 기회)입니다.

Buy Drop

Notify when buy-side prices drop sharply. 방향 토글: 매수 가격이 급락한 알림(낮은 가격에 매수할 기회)입니다.

New entries

Fresh arbitrage opportunities above the spread floor. 신규 진입 알림의 마스터 스위치입니다.

스파이크 윈도우

윈도우당 하나씩 여섯 개의 셀이 있으며, 각 셀에는 on/off 체크박스와 퍼센트 임계값 입력란(최소 10)이 있습니다. 윈도우 라벨은 30 s window, 1 min window, 5 min window, 15 min window, 30 min window, 1 hour window입니다.

기본값의 구조는 의도된 것입니다. 짧은 윈도우는 격렬한 변동이어야 의미가 있고(30초에 30%), 1시간 윈도우는 거의 두 배에 가까운 변동(95%)에서만 알립니다. 10% 미만의 임계값은 서버가 Price spike threshold must be >= 10으로 거부합니다. 숫자가 아닌 값을 입력하면 카드에 Spike threshold for {window} must be a valid number.이 표시됩니다.

New Entries 최소 스프레드

New entries minimum spread 라벨이 붙은 입력란은 하한 1의 퍼센트 값을 받습니다(기본 1%). 하한 미만의 진입은 절대 전송되지 않습니다. 1 미만의 값은 Telegram new entries min spread must be >= 1로 거부되고, 숫자가 아닌 입력에는 New entries min spread must be a valid number.이 표시됩니다.

뮤트 리스트

알림 패밀리당 하나씩 두 개의 접이식 그룹이 있으며, 서로 완전히 독립적입니다:

New entries 그룹

설명: Suppress new-entry alerts by token, CEX, or chain. 토큰 입력란 아래 힌트: Enter one exact token symbol at a time. Mutes new-entry alerts only, not price spikes.

Price spikes 그룹

설명: Suppress price-spike alerts by token, CEX, or chain. 힌트: Price-spike mutes start empty and do not inherit new-entry mutes. 토큰을 신규 진입에서 뮤트해도 그 토큰의 스파이크 알림에는 아무 영향이 없으며, 반대도 마찬가지입니다.

각 그룹에는 Tokens, CEX, Chains 세 개의 탭이 있고, 탭별 개수 배지와 칩 태그 TKN, CEX, NET이 있습니다. 그룹 헤더는 None 또는 {n} muted를 보여주고, 저장되지 않은 수정이 있는 동안에는 Unsaved 배지가 표시됩니다. 입력은 정확히 일치하는 값만 허용됩니다:

• Tokens: 플레이스홀더 Exact token symbol. 심볼은 정확히 하나의 자산으로 해석되어야 합니다. 오타, 알 수 없는 심볼, 모호한 심볼은 Enter the exact token symbol.을 반환합니다.
• CEX: 플레이스홀더 binance. 알 수 없는 거래소 id는 Unknown CEX id로 거부됩니다.
• Chains: 플레이스홀더 polygon. 알 수 없는 체인 id는 Unknown chain id로 거부됩니다.

Hide(또는 Enter)를 눌러 추가하고, 칩의 Unhide를 눌러 제거합니다. 빈 탭에는 Nothing muted yet.이 표시됩니다. 리스트별 한도: 토큰 1000개, CEX 100개, 체인 200개. 토큰 한도를 초과하면 Hidden asset limit reached.가 표시됩니다.

저장

Save changes 버튼은 모든 변경을 한 번에 적용한 뒤 30초의 쿨다운에 들어가며, 그동안 푸터에 Next save available in {n}s.가 표시됩니다. 저장하기 전에는 아무것도 적용되지 않습니다.

명령어 레퍼런스

명령어 목록 대부분은 등록 시점에 봇에 설치되므로 Telegram의 명령어 메뉴(/ 버튼)에서 자동 완성됩니다. 일부 명령어(/start, /settings, /help, /cancel, /spikes, /newentries, /unlink)는 입력하면 인식되지만 자동 완성 메뉴에는 표시되지 않습니다. 봇이 인식하지 못하는 모든 입력에는 도움말 텍스트로 응답합니다.

세션과 탐색

전송 제어

Price Spikes 설정

윈도우 인자는 초 단위로 입력합니다: 30, 60, 300, 900, 1800, 3600(30s, 1m, 5m, 15m, 30m, 1h). 성공한 모든 명령어는 현재 설정 요약으로 응답합니다.

형식이 잘못된 입력에는 사용법 한 줄로 응답합니다: Usage: /spikes on|off, /spikes rise on|off, /spikes drop on|off, /spikes window <seconds> on|off, /spikes threshold <seconds> <pct>.

New Entries 설정

같은 명령어가 뮤트 서브커맨드도 처리합니다(/newentries hide SOL은 /hide SOL과 동일하게 동작합니다). 형식이 잘못된 입력에는 Usage: /newentries on|off, /newentries min <pct>, /newentries hide <SYMBOL>, /newentries unhide <SYMBOL>, /newentries hidden으로 응답합니다.

New Entries 뮤트 명령어

Price Spikes 뮤트 명령어

spike_ 접두사는 별도의 가격 스파이크 리스트를 관리합니다. 응답은 hidden for price spikes. 문구를 사용하는 동일한 패턴을 따르며, 리스트 제목은 Price spike Hidden List, Price spike Hidden CEX List, Price spike Hidden chain List입니다.

실제 사용 예 몇 가지:

인라인 메뉴

연결된 채팅에서 /menu, /settings, /start를 보내면 인라인 키보드로 구성된 대화형 설정 콘솔이 열립니다. 텍스트 명령어와 달리 메뉴 변경은 초안에 보류됩니다. 토글과 수정된 숫자는 Save changes를 누를 때까지 누적됩니다. 초안이 있는 동안 모든 화면에 Draft changes pending. 줄이 표시되고 Save changes와 Discard draft 버튼이 추가됩니다.

루트 설정 메뉴

Price spikes / New entries

두 개의 설정 하위 화면을 엽니다.

Save changes

초안을 적용하고 Changes saved.로 응답합니다. 저장은 30초당 한 번으로 제한되며, 너무 빠르면 Save is rate limited. Try again in {n}s.로 응답합니다. 보류된 변경이 없을 때 누르면 No draft changes to save.로 응답합니다.

Discard draft

보류된 모든 변경을 버리고 Draft discarded.로 응답합니다.

Refresh

마지막으로 저장된 상태로 메뉴를 다시 그립니다.

Price Spikes 설정 화면

Toggle all price spikes

마스터 스위치 전환을 초안에 보류합니다.

Sell Rise on / Buy Drop on

방향 토글입니다. 라벨은 항상 현재 상태(on 또는 off)를 보여주고, 누르면 반대 상태가 초안에 보류됩니다.

윈도우 행, 예: 30s on + Edit threshold

여섯 개 윈도우 각각에 행이 하나씩 있습니다. 왼쪽 버튼은 초안에서 윈도우를 토글하고, 오른쪽 버튼은 임계값 숫자 프롬프트를 엽니다. 윈도우가 꺼져 있으면 오른쪽 버튼이 Edit threshold (off)로 표시되고, 누르면 {window} is off. Turn it on before editing the threshold.로 응답합니다. 먼저 윈도우를 켠 다음 수정하세요.

Hidden tokens / Hide token, Hidden CEX / Hide CEX, Hidden chain / Hide chain

왼쪽 버튼은 가격 스파이크 hidden list 화면을 열고, 오른쪽 버튼은 항목 추가를 위한 텍스트 프롬프트를 시작합니다. 이 프롬프트에서의 뮤트 변경은 즉시 적용되며 초안에 포함되지 않습니다.

Back

루트 메뉴로 돌아갑니다. 초안은 화면 이동 후에도 유지됩니다.

New Entries 설정 화면

첫 번째 버튼의 라벨은 상태에 따라 바뀝니다(켜져 있는 동안에는 Turn off new entries). Edit minimum spread는 Send the new entries minimum spread as a percentage number. 텍스트와 예시 Example: 7.5, 그리고 Send /cancel to stop.이 있는 숫자 프롬프트를 엽니다.

숫자 입력 프롬프트

숫자가 아닌 입력에는 Please send a valid number.로 응답하고 프롬프트를 다시 보여줍니다. 범위를 벗어난 값에는 검증 메시지(예: Price spike threshold must be >= 10)로 응답하고 다시 프롬프트를 띄웁니다. 유효한 값은 초안에 들어가고 설정 화면이 다시 그려지며, Save changes를 누르기 전까지는 아무것도 라이브로 적용되지 않습니다.

텍스트 입력 프롬프트 (hide와 unhide)

Hide token, Hide CEX, Hide chain 버튼은 정확한 값 하나를 묻는 프롬프트를 띄웁니다. 예를 들어 Send one exact token symbol to hide from new-entry alerts.와 Example: SOL, Send /cancel to stop.입니다. 이 프롬프트에는 Cancel 버튼이 있는 일회용 응답 키보드와 Exact token symbol (e.g. SOL), Exact CEX id (e.g. binance), Exact chain id (e.g. polygon) 같은 입력 플레이스홀더가 붙습니다. 토글이나 임계값과 달리, 이 프롬프트의 hide와 unhide 동작은 즉시 적용되며 해당 hidden list 화면으로 돌아갑니다.

Hidden list 화면

CEX와 체인 변형은 동작 버튼을 Hide CEX / Unhide CEX와 Hide chain / Unhide chain으로 바꿉니다. 가격 스파이크 버전의 화면은 Back to new entries 대신 Back to price spikes를 사용합니다.

뮤트 리스트

뮤트 리스트는 정확히 여섯 개가 있으며 모두 서로 독립적입니다. 신규 진입 리스트와 가격 스파이크 리스트는 항목을 공유하지 않습니다. 토큰을 신규 진입에서 뮤트해도 그 토큰의 스파이크는 조용해지지 않으며, 가격 스파이크 리스트는 아무것도 상속하지 않고 비어 있는 상태로 시작합니다.

뮤트가 수신 내용을 바꾸는 방식: 뮤트된 토큰은 그 자산의 메시지 전체를 제거합니다. 뮤트된 CEX나 체인은 메시지를 없애지 않고, 일치하는 베뉴 또는 체인 행만 제거하여 알림이 그 행들 없이 재구성됩니다.

모든 리스트는 세 곳에서 관리할 수 있고, 셋 모두 같은 데이터에 기록합니다:

• 웹 카드: My Page Alert rules의 Mute lists 그룹(보류 후 Save changes로 적용).
• 봇 명령어: 위 표의 슬래시 명령어(즉시 적용).
• 인라인 메뉴: Hide token / Hide CEX / Hide chain 프롬프트와 hidden list 화면(즉시 적용).

일시정지, 중단, 복구

전송이 멈출 수 있는 모든 경우와 정확한 복구 방법입니다:

보안 모델

문제 해결

마주칠 수 있는 정확한 메시지와 그 의미, 대처 방법입니다: