API 인증

Blocklens API의 모든 요청은 API 키로 인증해야 합니다. API 키는 이용 자격이 있는 구독 플랜을 사용 중인 사용자에게 발급됩니다.

API 키 생성하기

계정 대시보드의 API Keys 섹션에서 API 키를 관리할 수 있습니다.

1. API Keys 페이지로 이동합니다.
2. **"Create New Key"**를 클릭합니다.
3. 키에 알아보기 쉬운 이름을 지정합니다(예: "My Trading Bot", "Research Script").
4. 새로운 API 키가 표시됩니다. 이 키를 즉시 복사하여 안전한 곳에 보관하세요. 보안상의 이유로 전체 키를 다시 확인할 수 없습니다.

인증된 요청 보내기

API 요청을 인증하려면 Bearer 방식으로 Authorization 헤더에 API 키를 담아 보내야 합니다.

cURL을 사용한 요청 예시

curl -X GET "https://api.blocklens.co/v1/holder/supply?limit=1" \
     -H "Authorization: Bearer your_api_key_here"

Python을 사용한 요청 예시

import requests

API_KEY = "your_api_key_here"
API_URL = "https://api.blocklens.co/v1/holder/supply"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

params = {
    "limit": 1
}

response = requests.get(API_URL, headers=headers, params=params)

if response.status_code == 200:
    print(response.json())
else:
    print(f"Error: {response.status_code}")
    print(response.text)

유효한 API 키 없이 보낸 요청은 401 Unauthorized 오류가 발생합니다.