API Reference
Go to Nodit!

Overview

Aptos Indexer API

Aptos Indexer API는 Aptos 네트워크의 데이터를 효율적으로 쿼리할 수 있도록 하는 도구로 Aptos 네트워크 상의 모든 데이터를 구조화된 형식으로 인덱싱하여 빠르게 검색할 수 있도록 하며, 다양한 쿼리 옵션을 제공하여 사용자가 필요한 데이터를 정확하고 신속하게 가져올 수 있게 합니다.


사용자는 필요한 데이터만 선택적으로 요청할 수 있고 중첩된 데이터를 한 번의 요청으로 받아올 수 있어 경제적으로 데이터를 이용할 수 있습니다. 또한 Aptos Indexer API는 명확한 스키마 정의를 통해 API의 가독성을 높이고 오류를 줄일 수 있습니다. Aptos Node API와 Aptos Indexer API은 모두 Aptos 블록체인의 데이터를 액세스하고 쿼리하는 데 사용되지만, 목적과 기능 면에서 중요한 차이점이 있습니다.


Aptos Node API

Aptos Node API는 블록체인 노드와 직접 통신하여 데이터를 가져오는 인터페이스입니다. 블록, 거래, 계정 상태 등 기본적인 블록체인 데이터를 제공하는 API를 통해 블록체인 네트워크의 실시간 데이터를 가져올 수 있습니다.


Aptos Indexer API

Aptos Indexer API는 블록체인 데이터를 인덱싱하고 검색할 수 있도록 설계되어 사용자가 원하는 특정 데이터를 빠르게 추출하는 데 강점을 가지고 있습니다. Aptos Node API와 Aptos Indexer API의 차이를 간략하게 살펴보면 다음과 같습니다.


데이터 접근 방식:

  • Node API: 노드와 직접 통신하여 실시간 데이터를 가져옵니다. 주로 현재 상태나 최신 정보를 조회하는 데 사용됩니다.
  • Indexer API: 인덱싱된 데이터를 활용하여 빠르고 효율적으로 검색합니다. 특정 조건에 맞는 데이터를 찾는 데 유리합니다.

사용 방법:

  • Node API: RESTful API를 사용하여 정해진 엔드포인트를 통해 데이터를 조회합니다.
  • Indexer API: 사용자 정의 쿼리를 통해 필요한 데이터를 선택적으로 조회할 수 있습니다.

응답 속도 및 효율성:

  • Node API: 실시간 데이터를 제공하지만, 대량의 데이터나 복잡한 쿼리의 경우 속도가 느릴 수 있습니다.
  • Indexer API: 인덱싱된 데이터를 사용하므로 대량의 데이터에서도 빠른 검색이 가능합니다.

데이터 활용 용도:

  • Node API: 실시간 데이터 조회와 최신 상태 정보를 필요로 하는 애플리케이션에 적합합니다.
  • Indexer API: 복잡한 데이터 검색과 분석, 특정 이벤트 추적 등을 필요로 하는 애플리케이션에 적합합니다.

결론적으로, Aptos Node API는 실시간 데이터를 직접 조회하는 데 적합한 반면, Aptos Indexer API은 인덱싱된 데이터를 통해 효율적으로 검색하고 복잡한 쿼리를 수행하는 데 적합합니다. 두 도구는 서로 보완적으로 사용될 수 있으며, 애플리케이션의 요구 사항에 따라 적절히 선택하여 사용할 수 있습니다.


Aptos Indexer API Type

Aptos Indexer API은 보편적으로 2가지 타입을 제공합니다. Aptos 재단에서 제공하는 Labs Hosted 타입과 자체 Aptos Node를 이용하여 Aptos Indexer를 구축하는 Self Hosted 타입입니다. 두 가지 타입 모두 Aptos Indexer API를 사용할 수 있으나 아래와 같은 차이점이 있습니다.

  • Labs-Hosted Indexer API
    • Aptos 재단에서 제공하는 Aptos Indexer API로, 5분 동안 5,000 Request의 Rate Limit이 있습니다.
  • Self-Hosted Indexer API
    • 자체적으로 Indexer API를 호스팅해야 하기 때문에 구축 및 관리의 번거로움이 있으나 구축 후 Rate Limit 없이 이용할 수 있습니다.

Nodit 서비스는 자체적으로 Indexer API를 호스팅하여 제약 없이 사용할 수 있는 환경을 제공합니다. 이제 Nodit을 통해 Node 환경 구축부터 Indexer API 활용까지 편리하게 이용해보시기 바랍니다.

🚧

Aptos Indexer API는 Aptos 재단에서 직접 제공하는 서비스로 현재 Beta 버전으로 운영되고 있습니다.

Aptos 재단은 운영 방안에 따라 문제가 발생할 경우, aptos-indexer-processors 리포지토리에 이슈를 생성하여 보고해 줄 것을 권장하고 있습니다. 이용에 참고 부탁드립니다.