# 스크립트는 발행사 기록을 어떻게 통보받습니까 — 관심 목록과 구독? 루프 · 웹훅 규칙이 있는 베어러 등급, 그리고 사람을 위한 공개 텔레그램 봇 *에이전트용 · 6분 · 고급 · 개발자 · 알림* 두 가지 메커니즘이 있습니다. 관심 목록(watchlist)은 유일하게 인증이 필요한 인터페이스입니다: `POST /v1/watchlists`가 규칙을 만들고(`GET`은 나열, `DELETE /v1/watchlists/{id}`는 삭제), 매뉴얼이 문서화한 두 가지 동결 분류가 있습니다. `freeze`(감시 중인 주소를 지목한 확정된 발행사 기록마다 한 번, 또는 usd6 기준 `threshold`를 넘는 전역 알림)와 `freeze_proposed`(대기 중인 제안마다 한 번 — 조기 경보)입니다. 베어러 서비스 키가 없으면 호스트는 `401` *valid bearer service key required*로 답하며, 키는 운영자가 설정하는 것으로 셀프서비스가 아닙니다. 사람을 위한 구독은 공개 텔레그램 봇이며, `GET /v1/subscriptions`가 이를 설명합니다. ## 관심 목록: 무엇을 보냅니까 매뉴얼(§2, *동결 알림*): *`POST /v1/watchlists`는 두 가지 동결 분류를 받습니다. `freeze`는 감시 중인 `address`를 지목한 확정된 발행사 기록 — 동결, 동결 해제 또는 소각 — 마다 한 번 발동합니다. `subject_type: "global"`이면 기록 시점의 가치(소각의 금액, 동결의 `balance_at`)가 usd6 기준 `threshold`에 도달하는 모든 기록에서 발동합니다. `freeze_proposed`는 제안이 아직 **대기 중**인 동안 제안마다 한 번 발동합니다 — `freeze`보다 수십 분 앞선 조기 경보입니다. 전역 규칙은 `balance_at_submission`을 비교합니다.* 이 두 분류에서 `chain_id: 0`(또는 없음)은 모든 체인을 뜻하며, 다른 모든 분류는 이를 베이스(Base)로 읽습니다. *규칙의 체인은 결코 대상에서 추론되지 않습니다*. 방법론의 정의 `watchlist_alerts`: 규칙은 *분류 x 대상 x 방향 x 임계값 x 심각도*입니다. 발동은 멱등적인 웹훅 전달을 대기열에 넣으며(`dedup_key`, 최소 한 번 전달), 제재 분류는 [OFAC](https://achivx.kr/academy/how-it-works/what-is-the-ofac-sdn-list/) 갱신마다 다시 발동합니다 — 매뉴얼이 무엇을 보낼지 문서화하지 않은 분류입니다. 돌아오는 것: *규칙은 그것이 존재한 뒤에 일어난 일만, 그리고 최대 7일 전까지만 보고합니다. 웹훅 페이로드에는 이벤트 자체의 `chain_id`와 원시 최소 단위가 담기며, `freeze` 페이로드는 `balance_at`이 어디서 왔는지 `balance_at_source`에 밝힙니다: `archive`는 정확합니다 … `derived`는 아직 동결된 주소의 현재 잔액입니다(트론) — 상한값이므로, 기록 시점 잔액이 더 낮았던 기록에서도 전역 임계값이 발동할 수 있습니다.* 그리고: *아직 확정되지 않은 값은 0으로 계산되므로, 그런 기록이나 제안은 읽히기 전까지 어떤 양의 임계값에도 도달하지 않습니다.* 시간 초과된 쓰기는 `Retry-After` 없이 `503 timeout`으로 답합니다: *적용되었을 수도, 아닐 수도 있으므로 반복하기 전에 그 효과를 확인하십시오.* ## 작동에 필요한 것 키입니다. 매뉴얼 첫머리: *선택적 베어러 등급이 하나 있습니다 — `/v1/watchlists`를 통한 관심 목록과 알림 웹훅 … `401`은 키가 설정되어 있으며 당신의 키가 틀렸거나 없다는 뜻입니다 — 이 호스트에는 키가 있으므로, 베어러 없이는 `401`을 예상하십시오. 키는 운영자가 설정하는 단일 서비스 자격 증명이며 — 셀프서비스 발급은 없습니다 — 아래의 어떤 것도 키를 요구하지 않습니다.* 2026-10-13 확인: 베어러 없는 `GET /v1/watchlists`는 `{"error": {"code": "unauthorized", "message": "valid bearer service key required", …}}`, `Cache-Control: no-store`와 함께 `401`로 답했습니다. 따라서 작동하는 순서는 다음과 같습니다: 운영자에게서 서비스 키를 받습니다. [openapi.json](https://stablescan.achivx.com/openapi.json)의 `AlertRule` 스키마가 지정하는 규칙 필드와 함께 `POST /v1/watchlists`에 베어러로 보냅니다 — `category`(`freeze` 또는 `freeze_proposed`), `subject`(감시할 주소 — 매뉴얼의 *`address` 규칙*)와 함께 `subject_type: "address"`, 또는 usd6 기준 `threshold`와 함께 `subject_type: "global"`, `chain_id`(두 가지 [동결](https://achivx.kr/academy/how-it-works/how-does-a-freeze-happen/) 분류에서 0이면 모든 체인), `webhook_url`(`https` URL — 가이드의 표현). 저장된 규칙은 `id`, `direction`, `flow`, `severity`, `enabled`, 타임스탬프와 함께 돌아옵니다. `GET`으로 읽고, `DELETE /v1/watchlists/{id}`로 삭제합니다. 본문의 정확한 구조는 `openapi.json`이 가리키는 매뉴얼 §2(*동결 알림*)에 있습니다. 검증에 실패한 규칙은 이유와 함께 `400 invalid_rule`로 답합니다. 키가 설정되지 않은 배포 환경은 `401` 대신 `503 disabled`로 답합니다: *쓰기 기능이 물리적으로 없습니다*. [대기 중인 제안](https://achivx.kr/academy/reference/glossary/#g-pending-proposal)은 모든 공개 설정에서 [관심 목록](https://achivx.kr/academy/guides/watchlists-and-alerts/) 키에 전달됩니다. 텔레그램은 제안이 전체 공개되는 경우에만 `freeze_proposed`를 받습니다. ## 사람을 위한 구독 `GET /v1/subscriptions`는 공개 채널을 설명합니다(2026-10-13 조회): [텔레그램 봇](https://achivx.kr/academy/guides/watchlists-and-alerts/) `stableAchivxBot`이며, 시작 페이로드는 [동결](https://achivx.kr/academy/how-it-works/how-does-a-freeze-happen/)용 `f_
`, 발행용 `m_`, 전송용 `w__
`입니다. 사용자 가이드 *관심 목록과 알림*과 레슨 *텔레그램과 API로 받는 알림*이 각 알림의 내용과 그 뒤의 대기 시간을 설명합니다. ## Stablecoin scanner ACHIVX에서 [/v1/subscriptions 열기 ↗](https://stablescan.achivx.com/v1/subscriptions) - 공개 채널: [/v1/subscriptions](https://stablescan.achivx.com/v1/subscriptions). [텔레그램 봇](https://t.me/stableAchivxBot). - 매뉴얼 §2와 첫머리의 베어러 등급: [/agents.md](https://stablescan.achivx.com/agents.md). [/openapi.json](https://stablescan.achivx.com/openapi.json)의 세 경로, 태그 *watchlists*. ## 출처 - [에이전트 매뉴얼 — agents.md (버전 2026-10-05)](https://stablescan.achivx.com/agents.md) - [REST 인터페이스의 OpenAPI 3.1 명세 (API 1.4.0)](https://stablescan.achivx.com/openapi.json) - [GET /v1/methodology (stablscan-methodology-v0.4.0)](https://stablescan.achivx.com/v1/methodology) - [베어러 없는 GET /v1/subscriptions와 GET /v1/watchlists (2026-10-13 조회)](https://stablescan.achivx.com/v1/subscriptions) ## 더 알아보기 - [가이드: 관심 목록과 알림](https://achivx.kr/academy/guides/watchlists-and-alerts/) - [동결 알림은 어떻게 작동합니까?](https://achivx.kr/academy/how-it-works/how-do-freeze-alerts-work/) - [동결 전에 경고가 있습니까?](https://achivx.kr/academy/how-it-works/is-there-any-warning-before-a-freeze/) - [레슨: 텔레그램과 API로 받는 알림](https://achivx.kr/academy/courses/freezes-and-alerts/freezes-and-alerts-04-alerts/) ## 관련 질문 - [get-address-compliance는 무엇을 반환합니까?](https://achivx.kr/academy/for-agents/get-address-compliance/) - [한도는 무엇이며, 거부는 어떤 모습입니까?](https://achivx.kr/academy/for-agents/what-are-the-limits-and-refusals/) - [사람이 개입하지 않는 일반적인 루프는 무엇입니까?](https://achivx.kr/academy/for-agents/the-typical-loop-with-no-human/) 루프 · 알림 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다. --- 출처: https://achivx.kr/academy/for-agents/watching-an-address-from-a-script/ · 영어 원문: https://achivx.com/academy/for-agents/watching-an-address-from-a-script.html