query-address-info
작성자 binancequery-address-info는 지갑 주소와 지원되는 체인에서 토큰 보유 내역을 확인하는 Web3 스킬입니다. 토큰 이름, 심볼, 가격, 24시간 가격 변동, 보유 수량을 반환해 빠른 포트폴리오 점검, 지갑 실사, 주소 모니터링에 유용합니다. 추정 없이 구조화된 잔액 스냅샷이 필요할 때 사용하세요.
이 스킬은 72/100점으로, 목록에 올릴 수는 있지만 주의해서 소개하는 편이 좋습니다. 지갑 조회 용도를 분명하게 드러내고 호출할 수 있는 구체적인 API도 제공하지만, 저장소의 워크플로 정보는 다소 부족해 실행의 일부는 사용자가 추론해야 할 수 있습니다. 디렉터리 사용자에게는 완성도 높은 종단 간 워크플로보다는, 특정 온체인 주소 조회용 스킬을 원할 때 설치할 가치가 있는 수준입니다.
- 지갑 잔액, 토큰 보유량, 포트폴리오, 자산 포지션 관련 질문에 대한 트리거 의도가 명확합니다.
- 필수 파라미터와 요청 헤더가 포함된 구체적인 GET 엔드포인트가 있어 에이전트가 바로 호출하기 쉽습니다.
- 플레이스홀더나 실험용 표기가 없고, 본문 분량도 실제 API 사용 예시를 보여주기에 충분합니다.
- 저장소에 스킬 파일이 하나만 있고 보조 스크립트, 참고 문서, 규칙이 없어 예외 처리와 검증이 충분히 문서화되어 있지 않습니다.
- 공개된 예제가 잘려 있고 설명도 매우 짧아, 처음 사용하는 사람에게는 빠른 시작 관점의 명확성이 떨어집니다.
query-address-info 개요
query-address-info가 하는 일
query-address-info 스킬은 지원되는 체인에서 특정 지갑 주소의 토큰 보유 현황을 가져옵니다. 현재 포지션을 빠르게 확인하고 싶은 Web3 사용자를 위해 설계되었으며, 토큰 이름, 심볼, 가격, 24시간 가격 변동, 보유 수량까지 한 번에 볼 수 있습니다.
이 스킬이 필요한 사람
포트폴리오 점검, 지갑 실사(due diligence), 주소 모니터링, 가벼운 온체인 분석에 query-address-info를 사용하세요. 이미 주소와 chain ID를 알고 있고, 구조화된 잔고 스냅샷이 빠르게 필요할 때 특히 유용합니다.
언제 가장 잘 맞는가
“이 지갑이 지금 무엇을 보유하고 있나?”에 답하기 위한 실용적인 query-address-info guide가 필요할 때 잘 맞습니다. 반면 거래 내역, 전체 DeFi 귀속, NFT 보유 현황, 또는 활성 토큰 포지션을 넘어서는 심층 분석에는 덜 적합합니다.
핵심 판단 포인트
query-address-info를 설치할 가장 큰 이유는 속도입니다. 주소 조회 흐름에서 생기는 시행착오를 줄여 주고, 필요한 요청 형태도 바로 보여줍니다. 다만 범위는 분명합니다. 특정 주소와 체인의 토큰 보유 현황에 집중하므로, 크로스체인 집계나 과거 회계 정보를 기대하면 안 됩니다.
query-address-info 사용 방법
스킬 파일 설치 및 열기
query-address-info install을 하려면 binance/binance-skills-hub에서 스킬을 추가한 뒤, 먼저 스킬 진입 파일을 읽으세요. SKILL.md부터 확인하고, 연결된 저장소 파일이 있다면 그다음에 살펴보면 됩니다. 이 저장소에서는 스킬이 단독으로 구성되어 있으므로 SKILL.md가 핵심 기준 문서입니다.
스킬이 필요로 하는 입력값
query-address-info를 제대로 쓰려면 다음을 제공하세요:
0x...형태의 EVM 주소와 같은 지갑 주소56(BSC) 또는8453(Base)처럼 지원되는chainId- 페이지네이션용
offset값, 보통 첫 페이지는0
“이 지갑 좀 확인해줘” 같은 약한 프롬프트는 너무 모호합니다. 반면 “주소 0x...와 체인 56에 대해 query-address-info를 사용해서 활성 토큰 포지션을 반환하고, 큰 잔고 집중도가 있으면 함께 알려줘”처럼 요청하면, 스킬이 더 집중된 결과를 내기 충분한 맥락을 얻습니다.
더 나은 결과를 위한 실무 흐름
query-address-info usage는 다음 3단계로 활용하세요:
- 체인과 주소가 맞는지 확인합니다.
offset=0으로 보유 현황 첫 페이지를 요청합니다.- 지갑이 큰 편이라면 이후
offset으로 이어서 더 많은 포지션을 확인합니다.
분석이 목적이라면 토큰 집중도, 스테이블코인 비중, 눈에 띄는 가격 변동 기준으로 보유 현황을 요약해 달라고 요청하세요. 이렇게 하면 단순 잔고 목록이 아니라 실제로 쓸 수 있는 지갑 리드아웃으로 바뀝니다.
먼저 읽어야 할 파일과 세부사항
스킬을 수정하거나 확장하려면, 프롬프트나 자동화를 만들기 전에 SKILL.md의 요청 파라미터, 헤더, 예시 요청을 먼저 읽으세요. 이 세부 정보는 중요합니다. 엔드포인트가 특정 주소, chain ID, 페이지네이션 형식을 기대하기 때문에, 값이 틀리면 결과가 비어 보이거나 잘못된 것처럼 나올 수 있습니다.
query-address-info 스킬 FAQ
query-address-info는 Web3 주소에만 쓰이나요?
네. query-address-info for Web3 사용 사례가 이 스킬의 핵심 설계입니다. 이메일 계정, 거래소 프로필, 온체인 외부의 신원 정보가 아니라 온체인 지갑 주소와 토큰 포지션을 위한 도구입니다.
일반 프롬프트와 무엇이 다른가요?
일반 프롬프트는 목표를 설명할 수 있지만, query-address-info skill은 API 중심의 정확한 흐름과 필요한 입력값을 제공합니다. 그 덕분에 서식 오류가 줄고, 주고받는 수정도 적어지며, 지갑 보유 현황을 빠르게 확인해야 할 때 더 안정적인 결과를 얻을 수 있습니다.
초보자도 쓰기 쉬운가요?
네, 이미 지갑 주소와 체인을 알고 있다면 충분히 쉽습니다. 초보자가 가장 어려워하는 부분은 올바른 chain ID를 고르는 일과, 이 스킬이 지갑의 모든 자산이 아니라 활성 포지션만 반환한다는 점을 이해하는 것입니다.
언제 쓰지 않는 게 좋나요?
과거 PnL, 전체 거래 추적, 크로스체인 포트폴리오 집계, NFT 분석이 필요하다면 query-address-info를 쓰지 마세요. 그런 작업에는 다른 도구와 데이터 소스가 필요합니다.
query-address-info 스킬 개선 방법
가능한 한 정확한 주소와 체인을 입력하세요
query-address-info 결과를 가장 잘 개선하는 방법은 유효한 체크섬 형식의 주소와 정확한 chain ID를 제공하는 것입니다. 둘 중 하나라도 틀리면 출력이 불완전해지거나 잘못된 지갑 문맥을 가리킬 수 있습니다.
실제로 필요한 분석을 요청하세요
단순히 잔고만 묻기보다, 어떤 결정을 내리려는지까지 명시하세요. 예를 들어 “가치 기준 상위 5개 보유 종목을 요약해줘”, “스테이블코인 비중이 큰 지갑을 표시해줘”, “24시간 변동폭이 큰 토큰을 강조해줘”처럼 요청하면 됩니다. 이렇게 해야 스킬이 포지션 목록을 더 유용한 query-address-info guide 출력으로 바꿔 줍니다.
페이지네이션은 의도적으로 사용하세요
큰 지갑은 한 페이지에 다 담기지 않을 수 있습니다. 첫 응답이 비어 보이거나 일부만 보인다면, 지갑이 비어 있다고 단정하지 말고 다음 offset으로 이어서 확인하세요. 특히 적극적으로 거래하는 계정, LP, 멀티자산 지갑에서 중요합니다.
실행 전에 엣지 케이스를 확인하세요
랩드 자산, 유동성이 낮은 토큰, 오래된 것처럼 보이는 잔고를 주의해서 보세요. 스크리닝이나 리포팅에 결과를 쓸 경우, 상위 보유 종목이 지갑의 실제 전략과 맞는지 비교하고, 출력이 예상한 체인이나 주소와 어긋나면 새 프롬프트로 다시 실행하세요.