Covalent ‘Token Holders’를 사용하여 데이터를 스프레드시트로 보내는 방법

Yoonho Kim
Covalent
Published in
6 min readApr 29, 2021

번역: DetoxJuice#7642(디스코드)
원문: https://medium.com/covalent-hq/how-to-use-the-covalent-token-holders-tool-to-export- data-to-a-spreadsheet-87701744c79d

Emmanuel Odianosen, 3월 24일

블록의 ‘height’는 블록체인의 특정 위치를 의미하며, 그 앞에 몇 개의 확인 된 블록이 있는지로 결정됩니다. 블록체인의 현재 블록의 height는 현재 크기 또는 존재한 시간을 나타냅니다.

기본적으로 블록의 height는 특정 블록체인 네트워크의 전체 과거기록에서 확인 된 블록의 수를 나타냅니다. (제네시스 블록부터 가장 최근 블록까지) 블록체인 네트워크에서 모든 블록은 바로 앞에 오는 블록에 대한 레퍼런스(해시)를 포함합니다. 블록의 height는 실제로 해당 시퀀스의 각 블록의 수 입니다. 따라서 제네시스 블록의 블록 height는 #0이고, 채굴 된 첫번째 블록 높이는 #1이며 이런 방식으로 계속 진행됩니다.

Covalent에는 블록체인 네트워크의 블록 height에서 각 주소가 보유한 토큰의 양과 토큰 보유자의 수를 호출(query) 하기 위한 endpoint가 있습니다. 호출될 때, endpoint는 다음 정보를 가져옵니다.

chain_id {string — required} 
address {string — required}
block_height {string — not required}
page_number {int — not required}
page_size {int — not required}
format {json or csv}

블록 height 정보를 검색하는 것은 블록 height에서 특정 토큰을 보유한 사람 및 컨트랙트 주소의 수를 조사하려는 개인 또는 조직의 매우 일반적인 사용 사례입니다. 이것이 왜 중요할까요? 데이터를 이해함으로써 결정을 보다 쉽게 할 수 있다는 것이 가장 큰 이유입니다. 또한 정보가 올바른지 확인하는 쉬운 방법입니다. Covalent 이전에는 프로그래밍 기술 없이는 블록체인 네트워크에서 정보를 추출하는 방법이 없었기 때문에 정보를 수집하기가 매우 어려웠습니다. 이제는 양식에 정보를 입력하고 필요한 데이터를 Excel 시트로 보내는 작업처럼 쉽게 할 수 있습니다.

Covalent API에서 정보를 가져오는 방법은 두 가지가 있습니다. 첫 번째 방법은 사용자가 endpoint를 직접 호출하고 데이터를 json 또는 csv형식으로 반환하는 프로그래밍이 필요합니다. 두 번째 방법은 Covalent의 ‘Token Holders’라고 하는 툴을 사용하는 것입니다.

Covalent ‘Token Holders’

예제 쿼리를 만들어 보겠습니다. 블록 높이 기준으로 UNI 토큰을 호출합니다:

11383235

유니토큰의 토큰 주소:

0x1f9840a85d5af5bf1d1762f925bdaddc4201f984

툴을 사용할 때, 각 섹션에 정보를 채우고 page_number 및 page_size 입력 공간을 비워 둘 수 있습니다. 네트워크로 Ethereum을 선택하세요.

블록 height 11383235인 UNI 토큰 화면

‘Submit’을 클릭하세요 파일을 다운로드 할 수 있는 대화상자가 나타납니다. ‘Save’를 클릭하면 CSV 문서로 저장됩니다.

Google 스프레드 시트(또는 다른 스프레드 시트)에서 파일을 보려면, 빈 스프레드 시트를 열고, 파일 >> CSV 가져오기 및 업로드를 클릭하세요.

다운로드된 CSV 파일 정보가 포함되어있는 스프레드시트

API를 직접 호출하려면 Covalent Docs로 이동하면 됩니다.

endpoint를 호출하면 문서 터미널에서 복사할 수 있는 응답을 받게 됩니다.

Covalent 문서 API 쿼리화면

Covalent API에 대한 많은 사용사례가 있습니다. 사용이 간편하기 때문에 프로그래밍 지식이 없는 사람이 Covalent 내부에 구축된 도구를 사용하여 블록체인 데이터를 호출할 수 있습니다. ‘Token Holders’라는 툴은 특정 블록 height에서 토큰 홀더 목록을 반환하는 예시 중 하나입니다.

위의 예를 통해서 UNI토큰 주소 보유자를 호출하는 방법을 배웠으므로 계속해서 ‘Token Holders’ 도구를 사용하여 Ethereum, Binance Smart Contract, Polygon 및 Avalanche C-chain 네트워크에서 모든 토큰주소를 호출할 수 있습니다. 머지 않아 더 많은 네트워크 데이터가 Covalent API에 추가 되고, ‘Token Holders’는 이러한 네트워크에 대한 지원도 확장할 것입니다.

긴 글 읽어주셔서 감사드립니다. 여러분에게 유용한 글이라 생각하며 기사에 박수👏를 남겨주신다면 너무 기쁠 것 같습니다. 다시 한 번 감사드립니다!

홈페이지: https://www.covalenthq.com/

트위터: https://twitter.com/Covalent_HQ
한국트위터: @CovalentKorea

텔레그램: https://t.me/CovalentHQ
한국텔레그램: https://t.me/covalent_korea

디스코드: https://bit.ly/Covalenthq_discord

--

--