지갑 주소로 토큰 잔액을 확인하는 방법은 무엇입니까?

직접 체인별 균형 쿼리

1. 사용자는 /balance/{chain}/{address} 에 GET 요청을 제출하여 토큰 잔액을 검색할 수 있습니다. 여기서 {chain}은 지원되는 7개의 블록체인 중 하나이고 {address}는 지갑의 16진수 문자열입니다.

2. 엔드포인트는 체인별 계약 표준 및 인덱서 적용 범위에 따라 기본 토큰 잔액과 ERC-20/BEP-20/SPL 토큰 보유량을 반환합니다.

3. Solana 응답에는 지갑에 매핑된 SPL 토큰 계정이 포함되며, Ethereum과 Base는 다중 호출 집계를 통해 ETH와 토큰 잔액을 모두 반환합니다.

4. Hedera 쿼리는 기본 HBAR 잔액만 반환합니다. HTS 토큰에는 이 엔드포인트에서 다루지 않는 별도의 계약 상호 작용이 필요합니다.

5. Bitcoin 응답은 RGB 또는 기타 토큰화 레이어를 지원하지 않는 UTXO 기반 BTC 잔액을 반영합니다.

인증 요구 사항

1. 모든 잔액 요청에는 AgentHustle AI가 발급한 유효한 자격 증명이 포함된 X-API-Key 헤더가 포함되어야 합니다.

2. 키의 범위는 특정 체인 및 권한으로 지정됩니다. 이더리움 전용 ​​키로 BSC에 쿼리를 시도하면 HTTP 403이 발생합니다.

3. 키당 비율 제한이 적용됩니다. 모든 엔드포인트에서 분당 60개의 요청이 API 게이트웨이 수준에서 적용됩니다.

4. 유효하지 않거나 만료된 키는 "invalid_api_key" 또는 "key_expired"를 나타내는 JSON 본문으로 HTTP 401을 트리거합니다.

5. 세션 쿠키나 OAuth 흐름이 포함되지 않습니다. 인증은 상태 비저장이며 헤더 기반입니다.

응답 구조 및 데이터 필드

1. 성공적인 응답은 HTTP 200을 사용하며 기본 단위의 문자열화된 정수로 표현되는 최상위 잔액 필드를 포함합니다(예: ETH의 경우 wei, SOL의 경우 lampports).

2. 토큰 배열은 각각 contractAddress , 기호 , 소수 및 rawBalance 가 포함된 비기본 자산을 나열합니다.

3. lastUpdated 필드는 기본 블록체인 인덱서의 최신 동기화 블록에 맞춰 Unix 타임스탬프를 밀리초 단위로 보고합니다.

4. 기본 통화 이외의 토큰을 보유하지 않는 지갑의 경우 토큰 배열은 그대로 유지되지만 비어 있습니다.

5. JSON 직렬화 중 부동 소수점 정밀도 손실을 방지하기 위해 모든 숫자 값은 문자열로 전달됩니다.

ENS 이름 확인 통합

1. 확인 서비스가 활성화되면 16진수 주소 대신에 Vitalik.eth 와 같은 ENS 이름을 직접 사용할 수 있습니다.

2. API는 쿼리를 체인별 잔액 엔드포인트로 전달하기 전에 이더리움 메인넷의 ENS 레지스트리를 통해 자동으로 역조회를 수행합니다.

3. 이름이 주소로 확인되지 않거나 잘못된 체크섬 형식을 가리키는 경우 확인이 자동으로 실패합니다.

4. 지원되는 ENS TLD에는 .eth, .xyz 및 .luxe가 포함됩니다. .com 및 .org는 ENS 호환 확인자에 등록되지 않으면 처리되지 않습니다.

5. PayPal 및 Venmo 통합을 통해 ENS 이름을 사용한 PYUSD 전송이 허용되지만 잔액 확인은 체인 기반으로 유지되며 오프체인 결제 잔액은 반영되지 않습니다.

자주 묻는 질문

Q: Cardano나 Avalanche와 같이 지원되지 않는 체인의 지갑 잔액을 확인할 수 있나요? A: 아니요. 엔드포인트는 Solana, Ethereum, Base, BSC, Polygon, Hedera 및 Bitcoin만 지원합니다. 다른 체인에 대한 요청은 오류 코드 "unsupported_chain"과 함께 HTTP 400을 반환합니다.

Q: API는 이더리움 지갑에서 wBTC 또는 wETH와 같은 래핑된 토큰을 감지합니까? 답: 그렇습니다. ERC-20 표준을 준수하는 래핑된 토큰은 올바른 기호, 소수 및 원시 잔액과 함께 토큰 배열에 표시됩니다.

Q: 지갑의 모든 자산에 대한 잔고가 0인 경우 어떻게 됩니까? A: 응답에는 Balance: '0' 과 빈 토큰 배열이 포함됩니다. HTTP 상태는 200으로 유지됩니다.

Q: 한 번의 요청으로 여러 주소를 일괄 확인할 수 있는 방법이 있나요? A: 기본적으로는 아닙니다. 각 주소에는 별도의 HTTP 요청이 필요합니다. 클라이언트는 외부에서 병렬화 또는 대기열 논리를 구현해야 합니다.