ACHIVX모든 엔드포인트, 모든 매개변수: 참고 문서
참고 · 2026-10-24 openapi.json에서 읽은 공개 REST 인터페이스 전체를 한 페이지에
- API 가이드
- 12분
- 고급
- 개발자
- 라우트 38개
Stablecoin scanner ACHIVX의 공개 REST 인터페이스입니다. https://stablescan.achivx.com 아래의 라우트 38개를 openapi.json(API 1.4.0)에서 읽고 2026-10-24에 호출했으며, 모든 매개변수와 그 기본값 및 범위, 라우트별 Cache-Control, 그리고 응답을 설명하는 이 섹션의 페이지를 함께 정리했습니다. chain을 받는 모든 라우트에서 chain은 ID, 문자열 ID, 슬러그, CAIP-2 ID를 받으며, 지정하지 않을 때의 기본값은 베이스(Base)입니다. 유일하게 bearer 키를 쓰는 관심 목록(watchlist)은 의도적으로 제외했습니다. 키는 운영자가 발급하며 그 밖에는 키가 필요한 곳이 없습니다.
이 페이지의 표기 규칙
chain은 전달하십시오라는 뜻입니다. ID(1), 문자열("1"), 슬러그(ethereum), CAIP-2(eip155:1) 모두 됩니다. 이것이 없으면 행에 달리 적혀 있지 않은 한 라우트는 베이스에 대해 답합니다. strict는 알 수 없는 매개변수를 400 unknown_param으로 거부하는 네 개 라우트를 표시하며, 나머지는 무시합니다. max-age는 2026-10-24에 전송된 Cache-Control 값입니다. 모든 라우트는 하나의 오류 형식 {"error": {"code", "message", "request_id"}}로 답합니다.
가용성 확인
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /health | — | no-store | 서비스 상태 |
GET /ready | — | no-store; 데이터베이스가 응답하지 않으면 503 not_ready | 서비스 상태 |
주소
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/addresses/{address} | chain | 60 | 개요 |
GET /v1/addresses/{address}/risk | chain; from(송금하려는 주소, new_counterparty 추가) | 60; time_budget으로 잘린 뒤에는 10 | 위험 |
GET /v1/addresses/{address}/exposure | chain; hops(정수, 기본값 3; 파싱할 수 없으면 기본값 유지) | 60; 잘린 뒤에는 10 | 노출 |
GET /v1/addresses/{address}/balances | chain | 30 | 잔액과 거래량 |
GET /v1/addresses/{address}/volume | chain; days 1–3650, 기본값 30 | 60 | 잔액과 거래량 |
GET /v1/addresses/{address}/approvals | chain | 60 | 승인과 휴리스틱 |
GET /v1/addresses/{address}/heuristics | chain | 60 | 승인과 휴리스틱 |
GET /v1/addresses/{address}/graph | chain; token(전달하십시오, 없으면 네트워크 기본 스테이블코인); hops 0–4, 기본값 1; frontier(상한, 기본값 500); window 1h/24h/7d/30d/90d/1y/all, 기본값 all | 60; 무거운 빌드에서는 Retry-After: 5와 함께 202 building | 그래프와 탐색 |
GET /v1/addresses/{address}/walk | chain; token; hops 0–4, 기본값 2; frontier_cap 1–500, 기본값 500; stop_at_attributed true/false, 기본값 true; stop_on_sanctioned true/false, 기본값 false; window는 위와 같음 | 60 | 그래프와 탐색 |
{address}는 네트워크 고유의 표기로 씁니다. 다른 종류의 체인 표기는 address_respelled: true로 답하며, 솔라나(Solana)에 대해 0x…/T… 주소를 물으면 예외적으로 400 invalid_address입니다. 무거운 조회 여섯 개 — 개요, /risk, /exposure, /graph, /walk, /llms-full.txt — 는 정해진 수의 슬롯을 공유하며 503 busy를 답할 수 있습니다.
전송과 거래
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/transfers strict | chain; payer; recipient; token(심볼 또는 컨트랙트); tx; block(≥ 1); finality final/pending; dir older/newer, 기본값 older; limit 1–200, 기본값 50; cursor; offset(레거시) | 15 | 피드 |
GET /v1/verify strict | tx(필수; chain은 거부됨 — 모든 네트워크를 검색) | 15; 불완전하면 no-store | 거래 찾기 |
GET /v1/sync/status | chain | 5 | 동기화 상태 |
발행사 동결
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/freezes | chain; tx(필수) — 거래 하나가 발생시킨 기록 | 3600 | 기록 원장 |
GET /v1/freezes/acts strict | chain(없으면 모든 네트워크; 있는데 비어 있으면 거부); token(정확한 심볼 또는 컨트랙트); kind freeze/unfreeze/seize; address(대상; T…/솔라나 주소는 해당 네트워크를 선택); limit 1–200, 기본값 50; cursor | 30 | 기록 원장 |
GET /v1/freezes/proposals strict | chain(없으면 모든 체인); status pending/executed/failed/revoked/superseded/stale; limit 1–500, 기본값 100(범위 밖은 100으로 읽힘); cursor; dir older/newer; tx(제출 또는 실행 해시; cursor나 dir과 함께 쓸 수 없음) | 30 | 제안 |
GET /v1/freezes/guide | chain | 300 | 동결 권한 |
GET /v1/freezes/networks | — | 60 | 동결 권한 |
GET /v1/tokens/{token}/freezes | {token}은 레지스트리 심볼, 정확히 일치(USDT는 USDT0을 제외) | 300 | 동결 권한 |
레지스트리와 검색
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/networks | — | 300(+ stale-while-revalidate=60, stale-if-error=3600) | 네트워크와 토큰 |
GET /v1/tokens | chain | 300(동일) | 네트워크와 토큰 |
GET /v1/tokens/{address}/contract | chain; {address}는 토큰 컨트랙트 | 3600 | 네트워크와 토큰 |
GET /v1/search | q(필수, 2–64자) | 60 | 검색 |
GET /v1/sanctions | — | 300 | 서비스 상태 |
GET /v1/methodology | — | 300 | 시장 통계 |
GET /v1/subscriptions | —(텔레그램 봇의 위치와 시작 페이로드) | 300 | 레시피: 동결 추적하기 |
시장 데이터와 순위
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/stats/home | chain(없으면 모든 네트워크); window 24h/7d/30d, 기본값 24h | 60; 만들어지지 않은 보기에는 503 snapshot_pending(Retry-After: 60) | 시장 통계 |
GET /v1/stats/overview | chain; window | 60 | 시장 통계 |
GET /v1/stats/slo | chain | no-store | 서비스 상태 |
GET /v1/tokens/{token}/addresses | {token} 심볼; window 24h/7d/30d, 기본값 24h; per_chain 1–50 | 3600 | 토큰 순위 |
GET /v1/tokens/{token}/routes | 위와 같음 | 3600 | 토큰 순위 |
거래소
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
GET /v1/entities | — | 600 | 거래소 |
GET /v1/entities/{slug} | {slug}는 /v1/entities가 나열하는 그대로; 그 외는 404 not_found | 600 | 거래소 |
GET /v1/entities/{slug}/addresses strict | chain(필수); group own/deposit, 기본값 own; page ≥ 1, 기본값 1; limit 1–100, 기본값 100 | 600 | 거래소 |
GET /v1/entities/{slug}/daily | — | 600 | 거래소 |
증명
| 라우트 | 매개변수 | max-age | 페이지 |
|---|---|---|---|
POST /v1/verify-attestation | JSON 본문 {"body": …, "attestation": …}; 선택 사항 public_key(base64url 원시 Ed25519) | no-store; 서명하지 않는 배포에서는 400 no_key | 서비스 상태와 증명 |
오류 코드
2026-10-24 기준 Error 스키마의 열거값은 38개입니다. bad_request, busy, disabled, internal, invalid_address, invalid_block, invalid_body, invalid_chain, invalid_cursor, invalid_days, invalid_dir, invalid_finality, invalid_frontier_cap, invalid_group, invalid_hops, invalid_kind, invalid_limit, invalid_page, invalid_per_chain, invalid_public_key, invalid_query, invalid_rule, invalid_status, invalid_stop_at_attributed, invalid_stop_on_sanctioned, invalid_token, invalid_tx, invalid_window, method_not_allowed, no_key, not_found, not_ready, rate_limited, snapshot_pending, timeout, unauthorized, unknown_param, unknown_token. 다섯 개 — internal, method_not_allowed, not_found, rate_limited, timeout — 는 어느 라우트에서나 나올 수 있습니다. disabled와 unauthorized는 이 섹션이 제외한 관심 목록 인터페이스에 속합니다. 각 코드가 무엇을 요구하는지는 코드에서의 오류와 한도에 있습니다.
헤더
모든 응답에 Content-Type: application/json; charset=utf-8, Cache-Control, ETag(Access-Control-Expose-Headers: ETag와 함께), X-Request-Id(보낸 경우 그대로 돌려주며, 엣지 캐시된 조회에서는 Cloudflare ray), X-Robots-Tag: noindex가 있습니다. 재전송된 응답에는 Age가 있습니다. 기다리라고 요구하는 거부 응답에는 Retry-After가 있습니다. CORS는 브라우저에서 If-None-Match, X-Request-Id, Authorization, Content-Type을 허용합니다.
Stablecoin scanner ACHIVX에서
- 이 페이지가 읽은 명세: /openapi.json; 서술형 설명: /agents.md §2.
- 요청 한도와 스킬 스키마가 있는 카드: /.well-known/agent-card.json.
출처
- REST 인터페이스의 OpenAPI 3.1 명세(API 1.4.0)
- 에이전트 매뉴얼 — agents.md(버전 2026-10-05)
- A2A 에이전트 카드(1.4.0) — 요청 한도와 스키마
더 알아보기
관련 질문
참고 · 라우트 38개 · 2026-10-24 작성, openapi.json, agents.md 및 당일 실제 호출 기준. 응답 형태는 인용이며, 수치는 날짜 기준이고 인덱스에 따라 달라집니다.
이 페이지는 ACHIVX Academy 영어 원문을 한국어로 옮긴 것입니다. 번역과 원문이 다르면 영어 원문이 기준입니다.