본문으로 건너뛰기

Cognivo Developer API

Cognivo Developer API를 사용하면 Cognivo Chat, dApp, Telegram 봇을 구동하는 것과 동일한 온체인 인텔리전스를 여러분의 앱, 봇, 대시보드, 백엔드에서 직접 호출할 수 있습니다.

  • 기본 URL: https://api.cognivolabs.io
  • 인증: Developer 포털에서 직접 생성하는 스코프 기반 API 키
  • 현재 지원 체인: Ethereum(eth), Base(base), BNB Smart Chain(bsc)
  • Solana: 출시 예정 (아직 사용 불가)
  • 웹훅: 계획 중 (아직 사용 불가)
  • OpenAPI 스펙: cognivo-public-api.yaml - 기계가 읽을 수 있는 전체 스펙입니다. Postman, Insomnia 또는 SDK 생성기로 가져올 수 있습니다

무엇을 만들 수 있나요?​

토큰이나 지갑에 대한 빠르고 정직한 판단이 필요한 것이라면 무엇이든 가능합니다. 몇 가지 구체적인 아이디어:

  • 토큰 안전성 검사 봇 - 사용자가 컨트랙트 주소를 붙여넣으면 리스크 신호, 유동성과 잠금 현황, "왜 하락하고 있는지"를 한 메시지로 돌려주는 봇
  • 지갑 모니터링 대시보드 - 트레저리, 고래, 팀 지갑을 감시: 승인(approval) 노출, 정확한 최근 이동 내역, 토큰별 실현 손익
  • 커뮤니티용 Telegram / Discord 도구 - Cognivo Chat을 구동하는 것과 동일한 인텔리전스가 뒷받침하는 /check <token> 명령을 커뮤니티에 제공
  • 포트폴리오 손익 뷰 - 자체 신고 수치가 아니라 검증된 온체인 활동으로 계산한 토큰별 실현 손익을 사용자에게 표시
  • 리서치 노트북 - 리스크, 유동성, 팀 지갑, 자금 이동 데이터를 Python이나 JavaScript 노트북으로 가져와 토큰 분석과 사후 검토에 활용
  • 디스커버리 피드 - Discover 피드의 최신 고품질 공개 인텔리전스 카드를 여러분의 앱이나 사이트에 노출

이 API가 아닌 것​

  • 원시 노드/RPC 접근이 아닙니다. 항상 큐레이션된 Cognivo 인텔리전스 엔드포인트를 호출하며, 원시 체인 RPC는 절대 노출되거나 재판매되지 않습니다.
  • 트레이딩, 주문 실행, MEV 도구는 포함되지 않습니다.
  • 결과는 인텔리전스 신호일 뿐 투자 조언이 아니며 보증도 아닙니다. 깨끗한 결과가 결코 "안전하다"는 뜻은 아닙니다.

접근 모델과 요금​

Developer API는 얼리 액세스 기간 동안 접근이 제어됩니다. 모든 키는 탐색이 가능합니다: 문서 읽기, GET /v1/api/health 호출, GET /v1/api/me로 자기 자신 조회, 제한적인 샌드박스/데모 호출. 라이브 인텔리전스 엔드포인트에는 트라이얼, 파트너, 유료 또는 엔터프라이즈 접근이 필요합니다.

  • 유료 사용은 성공한 호출당 Cognivo 크레딧으로 과금됩니다. 실패한 호출에는 과금되지 않습니다.
  • 샌드박스(cogv_test_) 키는 통합 테스트용입니다: 상한이 엄격하며(시간당 25 요청, 일 100 요청), 관리자가 활성화한 경우에만 소량의 라이브 데모 허용량을 실행할 수 있습니다.
  • 트라이얼 접근은 관리자가 부여하며, 제한적이고 만료됩니다.
  • 엔터프라이즈는 맞춤형입니다: 요금, 더 높은 한도, 엔드포인트별 접근. Developer 포털에서 접근을 요청하세요.

접근 권한 없이 실행형 엔드포인트를 호출하면 무료로 실행되는 대신 명확한 오류(예: access_required, trial_expired, payment_required)가 반환됩니다. 엔드포인트별 크레딧 비용은 엔드포인트 레퍼런스와 속도 제한 페이지에 공개되어 있습니다.

개인정보와 데이터 안전​

API는 공개된 온체인 인텔리전스만 반환합니다. 응답에는 Cognivo 계정 식별자, 이메일, 잔액, 기타 비공개 계정 데이터가 절대 포함되지 않습니다. 여러분의 것도, 다른 누구의 것도 마찬가지입니다.

시작하기​

  1. dapp.cognivolabs.io/en/developers에 평소 사용하는 Cognivo 계정으로 로그인합니다.
  2. 프로젝트와 API 키를 생성합니다 (전체 키는 딱 한 번만 표시되므로 즉시 복사하세요).
  3. 퀵스타트를 따라 합니다.