스크립트는 발행사 기록을 어떻게 통보받습니까 — 관심 목록과 구독?

루프 · 웹훅 규칙이 있는 베어러 등급, 그리고 사람을 위한 공개 텔레그램 봇

  • 에이전트용
  • 6분
  • 고급
  • 개발자
  • 알림

ACHIVX Academy 원문 (영어) ↗

두 가지 메커니즘이 있습니다. 관심 목록(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 갱신마다 다시 발동합니다 — 매뉴얼이 무엇을 보낼지 문서화하지 않은 분류입니다.

돌아오는 것: 규칙은 그것이 존재한 뒤에 일어난 일만, 그리고 최대 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의 AlertRule 스키마가 지정하는 규칙 필드와 함께 POST /v1/watchlists에 베어러로 보냅니다 — category(freeze 또는 freeze_proposed), subject(감시할 주소 — 매뉴얼의 address 규칙)와 함께 subject_type: "address", 또는 usd6 기준 threshold와 함께 subject_type: "global", chain_id(두 가지 동결 분류에서 0이면 모든 체인), webhook_url(https URL — 가이드의 표현). 저장된 규칙은 id, direction, flow, severity, enabled, 타임스탬프와 함께 돌아옵니다. GET으로 읽고, DELETE /v1/watchlists/{id}로 삭제합니다. 본문의 정확한 구조는 openapi.json이 가리키는 매뉴얼 §2(동결 알림)에 있습니다. 검증에 실패한 규칙은 이유와 함께 400 invalid_rule로 답합니다. 키가 설정되지 않은 배포 환경은 401 대신 503 disabled로 답합니다: 쓰기 기능이 물리적으로 없습니다. 대기 중인 제안은 모든 공개 설정에서 관심 목록 키에 전달됩니다. 텔레그램은 제안이 전체 공개되는 경우에만 freeze_proposed를 받습니다.

사람을 위한 구독

GET /v1/subscriptions는 공개 채널을 설명합니다(2026-10-13 조회): 텔레그램 봇 stableAchivxBot이며, 시작 페이로드는 동결용 f_<address>, 발행용 m_<ethereum|base|arbitrum|optimism|all>, 전송용 w_<network slug|all>_<address>입니다. 사용자 가이드 관심 목록과 알림과 레슨 텔레그램과 API로 받는 알림이 각 알림의 내용과 그 뒤의 대기 시간을 설명합니다.

Stablecoin scanner ACHIVX에서

/v1/subscriptions 열기 ↗

출처

더 알아보기

루프 · 알림 · 2026-10-13 작성, 스캐너 자체의 기계용 문서와 그날 조회한 실시간 응답을 바탕으로 했습니다. 구조는 그대로 인용했으며, 수치는 날짜 기준이고 인덱스에 따라 바뀝니다.

이 페이지는 ACHIVX Academy 영어 원문을 한국어로 옮긴 것입니다. 번역과 원문이 다르면 영어 원문이 기준입니다.