Developer API 개요

Developer API란

Cognivo Developer API를 사용하면 Cognivo Chat, dApp, Telegram 봇을 움직이는 것과 동일한 온체인 인텔리전스를 여러분의 코드에서 호출할 수 있습니다. 프로젝트를 만들고, API 키를 만든 다음, 일반 HTTPS로 요청을 보내면 됩니다.

1. Developers 영역은 프로젝트를 만들고 Cognivo API 키를 관리하는 곳입니다.
2. 로그인을 선택해 개발자 포털을 엽니다. 여러분의 키는 계정에서 비공개로 유지됩니다.

Cognivo dApp의 Developers 페이지입니다.이미지 확대

언제 사용하나요

Cognivo 안이 아니라 여러분이 만드는 제품 안에서 Cognivo의 답을 쓰고 싶을 때 사용하세요. 흔한 사례는 다음과 같습니다.

• 누군가 컨트랙트 주소를 붙여넣으면 위험 신호, 유동성과 잠금 맥락, 토큰이 하락한 이유에 대한 해석을 돌려주는 커뮤니티 봇.
• 재무 지갑, 팀 지갑, 고래 지갑을 위한 모니터링 대시보드: 승인 노출, 최근 이동, 토큰별 실현 손익.
• 연구나 사후 분석을 위해 토큰과 지갑 데이터를 Python이나 JavaScript로 가져오는 리서치 노트북.

이것은 노드나 RPC에 대한 원시 접근이 아닙니다. 언제나 큐레이션된 Cognivo 엔드포인트를 호출합니다. 트레이딩, 주문 실행, MEV 도구는 없습니다. 결과는 인텔리전스 신호이지 금융 조언이 아니며, 깨끗한 결과가 곧 토큰이 안전하다는 뜻은 절대 아닙니다.

찾는 위치

dApp에서 사이드바를 열고 Account로 이동한 다음 Developers를 선택합니다. 직접 링크는 dapp.cognivolabs.io/en/developers입니다. 평소 쓰는 Cognivo 계정으로 로그인해야 합니다. 로그아웃 상태에서는 프로젝트나 키 없이 안내 화면만 표시됩니다.

dApp의 Developers 페이지 상단으로, 기본 URL과 API 키를 보내는 방법을 확인하는 곳입니다.이미지 확대

페이지 상단의 카드에는 첫 호출에 필요한 세 가지가 담겨 있습니다.

• Base URL: https://api.cognivolabs.io. 여기에 엔드포인트 경로를 붙여 요청을 만듭니다.
• Auth: 모든 요청의 X-API-Key 헤더에 API 키를 보냅니다. 키는 서버에 보관하고 브라우저 코드에는 절대 두지 마세요.
• Chains: 페이지에는 Ethereum, Base, and BSC live와 More chains coming soon이 표시됩니다. 일부 엔드포인트는 다른 엔드포인트보다 적은 체인을 지원하며, 어떤 체인인지는 엔드포인트 레퍼런스에 나와 있습니다.

같은 카드에서 이 문서와 기계가 읽을 수 있는 OpenAPI 스펙으로 연결되며, 이 스펙은 Postman, Insomnia 또는 SDK 생성기로 가져올 수 있습니다.

페이지에는 Quickstart, Keys, Endpoints, Usage 네 개의 탭이 있습니다. Endpoints는 복사할 수 있는 예제와 각 호출의 가격이 담긴 레퍼런스입니다. 페이지에는 실시간 실행기가 없으므로, 거기서 읽는 것만으로는 아무 비용도 들지 않습니다.

접근, 키, 비용

라이브 키는 셀프 서비스입니다. 만들면 바로 동작하며, 신청이나 승인 대기열이 없습니다. 포털은 모델을 명확히 밝힙니다. 일부 엔드포인트는 활성 키만 있으면 무료이고, 나머지는 유료 또는 Enterprise 접근이 필요하며 성공한 호출마다 Cognivo 크레딧 잔액에서 청구됩니다.

• 라이브 키(cogv_live_)는 실제 호출을 합니다. 성공한 호출마다 해당 엔드포인트에 공시된 가격만큼 Cognivo 크레딧으로 청구됩니다. 실패한 호출에는 절대 청구되지 않습니다. 현재 Developer API 호출에 대한 과금은 꺼져 있어, 호출이 성공해도 아무것도 차감되지 않고 잔액도 변하지 않습니다.
• 테스트 키(cogv_test_)는 포털에서 Test로 표시됩니다. 상한이 엄격하며, 실제 트래픽이 아니라 API를 시험해 보기 위한 것입니다.
• 모든 키는 Keys 탭에서 Paid, Trial, Partner, Sandbox, Enterprise 또는 Request access 같은 접근 모드를 표시합니다. Request access 상태의 키는 승인을 받아야 유료 엔드포인트를 실행할 수 있고, Suspended 키는 아무것도 호출할 수 없습니다. 포털이 그 이유를 보여 줍니다.
• Enterprise는 접근을 요청해야 하는 유일한 경로로, 맞춤 가격과 한도를 위한 것입니다. Enterprise access 버튼을 누르면 지원 절차가 열립니다.

크레딧은 Cognivo의 다른 모든 곳에서 쓰는 것과 같은 잔액에서 나오며, 모든 계정은 자정(UTC)에 재설정되는 하루 무료 크레딧 5개를 받습니다. 잔액이 호출 비용을 감당하지 못하면 payment_required 코드와 함께 402 오류를 받고, 아무것도 청구되지 않습니다. 충전한 뒤 다시 시도하세요. 잔액이 어떻게 작동하는지는 결제 및 크레딧을 참고하세요.

GET /v1/api/health는 무료이며 키가 필요 없습니다. GET /v1/api/me는 유효한 키만 있으면 무료입니다. GET /v1/api/discover는 무료이지만 일일 상한이 엄격합니다. 엔드포인트별 가격은 엔드포인트 레퍼런스와 속도 제한, 오류 및 과금에 있습니다.

무엇이 돌아오고, 빈 답은 무슨 뜻인가

응답에는 공개 온체인 인텔리전스만 담깁니다. 여러분의 것이든 다른 사람의 것이든 Cognivo 계정 식별자, 이메일, 잔액을 비롯한 비공개 계정 데이터는 절대 포함되지 않습니다. 유일한 예외는 GET /v1/api/me로, 호출한 키 자신의 크레딧 잔액을 알려 주어 지출을 확인할 수 있게 합니다.

빈 필드나 알 수 없음 값은 이 체인의 이 토큰 또는 지갑에 대해 Cognivo가 그 항목을 검증하지 못했다는 뜻입니다. 그 항목이 존재하지 않는다는 뜻도 아니고, 대상이 깨끗하다는 뜻도 아닙니다. 결과가 없으면 미검증으로 다루고, 추가로 확인이 필요하면 응답의 요청 ID를 사용하세요.

다음 단계

1. 로그인해 프로젝트를 만든 다음 라이브 키를 만드세요. 전체 키는 한 번만 표시되므로 즉시 복사하세요.
2. 퀵스타트로 첫 호출을 실행하세요.
3. 권한, 로테이션, 키 보안은 인증 및 API 키에서 확인하세요.