API 문서

AI-TAMSA 블록체인 익스플로러 API 엔드포인트 문서입니다

Base URL:https://xp.tamsa.io

모든 엔드포인트는 JSON 형식으로 응답합니다. Rate Limit: 100 req/min (Free), 1000 req/min (Pro).

Chain ID

20250217

Network

Xphere Mainnet

Token

XP (18 decimals)

RPC

en-bkk.x-phere.com

Blocks

GET/api/blocks

최근 블록 목록 조회

Params:limitoffset

GET/api/blocks/{number}

블록 번호로 블록 상세 조회

Transactions

GET/api/transactions

최근 트랜잭션 목록 조회

Params:limitoffsettxTypefromto

GET/api/transactions/{hash}

트랜잭션 해시로 상세 조회 (AI 해석 포함)

Addresses

GET/api/addresses/{address}

주소 정보 조회 (잔액, TX 수, 컨트랙트 여부)

GET/api/addresses/{address}/profile

AI 주소 프로필 (분류, 위험 점수, 태그)

GET/api/addresses/{address}/graph

주소 관계 그래프 데이터

GET/api/addresses/{address}/export

트랜잭션 내역 CSV 다운로드

Contracts

GET/api/contracts/{address}

컨트랙트 분석 (바이트코드, 보안 점수, 함수 셀렉터)

POST/api/contracts/{address}/call

Read 메서드 호출 (view/pure 함수)

GET/api/contracts/{address}/verify

컨트랙트 검증 상태 조회

POST/api/contracts/{address}/verify

소스 코드 검증 제출

GET/api/contracts/{address}/proxy

프록시 컨트랙트 감지 (EIP-1967, EIP-1167)

Tokens

GET/api/tokens

토큰 목록 조회 (전송 수 기준 정렬)

Params:limitoffset

GET/api/tokens/{address}

토큰 상세 정보 (메타데이터, 보유자)

Network

GET/api/network

네트워크 실시간 통계 (블록 높이, 가스 가격, TPS)

GET/api/stats

분석 데이터 (일별 TX, 가스, 볼륨)

GET/api/top-accounts

상위 계정 목록 (TX 수 기준)

Params:limit

GET/api/search

검색 자동완성 (토큰, 주소 라벨)

Params:q

AI

POST/api/chat

AI 채팅 (스트리밍, Claude 도구 호출)

POST/api/agents

AI 에이전트 실행 (고래 모니터, 가스 추적 등)

Rate Limiting & 인증

Free

100 req/min

API Key 불필요

Pro

1,000 req/min

xp-pro-* API Key

Enterprise

10,000 req/min

xp-ent-* API Key

API Key는 X-API-Key 헤더로 전달합니다.