시작하기

가이드 · 경험이 없어도 됩니다

AI 어시스턴트나 내 프로그램을 단계별로 연결하기

이 사이트의 모든 데이터는 사이트 밖에서도 쓸 수 있습니다. AI 어시스턴트(Claude, ChatGPT, Cursor) 안에서 쓰거나, 직접 실행하는 프로그램에서 쓸 수 있습니다. 두 방법 모두 필요한 것은 하나, 무료 계정 키입니다. 이 페이지는 모든 클릭과, 무언가 작동하지 않을 때 할 일을 보여 드립니다.

API 키를 한 번도 만들어 본 적 없는 분을 위해 썼습니다. 이미 해 보셨다면 사용하시는 도구의 섹션으로 바로 이동하십시오.

데이터 및 API 열기요금제 보기전체 개발자 문서

1. 무엇을 설정하는지

같은 데이터로 들어가는 문이 두 개 있고, 키 하나로 두 문을 모두 엽니다.

  1. AI 어시스턴트 문(MCP)

    MCP는 Claude나 ChatGPT 같은 어시스턴트가 대화 중에 저희 데이터를 불러올 수 있게 해 주는 플러그입니다. "지금 BTC 펀딩비가 얼마야"라고 물으면 어시스턴트가 저희에게서 답을 가져옵니다. 호스팅 버전은 설치할 것이 없습니다. 주소 하나를 어시스턴트 설정에 붙여넣으면 됩니다.

  2. 프로그램 문(API)

    API는 직접 만든 스크립트, 스프레드시트, 봇이 호출해서 숫자를 JSON으로 받아 오는 주소입니다. 키를 붙여 요청을 보내면 저희가 데이터를 보내 드립니다.

  3. 키

    키는 bk_로 시작하는 긴 비밀번호입니다. 어느 계정이 요청하는지 저희에게 알려 줍니다. 무료 계정에는 키 하나와 월 15,000회 호출이 주어지며, 어시스턴트 문과 프로그램 문이 이 한도를 함께 씁니다. 키는 만들 때 한 번만 표시되므로 비밀번호처럼 다루십시오.

2. 키 만들기(2분)

  1. 로그인하거나 무료 계정 만들기

    오른쪽 위의 '로그인' 버튼을 누르십시오. 새 계정에는 이메일 주소만 있으면 됩니다. 저희가 링크를 보내 드리면 그 링크를 클릭하는 것으로 끝납니다.

  2. Data & API(데이터 및 API) 열기

    로그인한 뒤 오른쪽 위의 계정 메뉴를 열고 Data & API(데이터 및 API)를 선택하십시오. 휴대폰에서는 '내 공간' 탭 아래에 있습니다.

  3. 키 만들기

    Keys(키) 섹션까지 스크롤하십시오. 키를 어디에 쓸지 알아볼 수 있는 이름을 입력하십시오. 예를 들어 "내 노트북"이나 "ChatGPT"라고 입력하고 Create(키 생성)를 누르십시오.

    키는 Copy(복사) 버튼이 있는 상자에 한 번만 나타납니다. 바로 복사해서 안전한 곳에 붙여넣으십시오. 복사하지 않고 페이지를 닫았더라도 잃는 것은 없습니다. 그 키를 폐기하고 새로 만드십시오.

    키 아래에는 키가 이미 들어 있는 호스팅 MCP 주소도 준비되어 있습니다. 이 주소는 헤더를 넣을 수 없는 도구(ChatGPT)용입니다. 키와 마찬가지로 비공개로 보관하십시오.

3. claude.ai(웹 및 모바일)

호스팅 서버이므로 설치할 것이 없습니다.

  1. 커넥터 추가

    Settings, Connectors, Add custom connector(사용자 지정 커넥터 추가) 순서로 여십시오.

    Name(이름): ByKaranteli. URL: https://mcp.bykaranteli.com.

    Authentication에서 No sign-in을 선택하십시오(claude.ai가 "Detected"로 표시할 수 있습니다). "Sign in now"나 "Sign in when needed"는 고르지 마시고, OAuth Client ID와 Client Secret은 비워 두십시오.

    요청 헤더 설정을 여십시오(Advanced 아래에 있는 경우도 있습니다). 헤더 하나를 추가하십시오. 이름은 x-api-key, 값은 본인의 키입니다. 저장하십시오.

    헤더
    x-api-key: bk_...your key...

  2. 사용해 보기

    대화를 시작하고, 그 대화에서 ByKaranteli 커넥터가 켜져 있는지 확인한 뒤 이렇게 물어보십시오. "BTC 청산 맵을 보여 줘." 어시스턴트가 저희 도구 목록을 확인하고 호출합니다.

4. ChatGPT

ChatGPT는 헤더를 추가할 수 없으므로 키를 주소 안에 넣어 보냅니다.

  1. 커넥터 추가

    Settings, Connectors(일부 계정에서는 Developer mode 아래), Create 순서로 여십시오.

    Name(이름): ByKaranteli. URL: Data & API(데이터 및 API)에서 복사한, 키가 포함된 주소입니다. 아래 줄과 같은 모양입니다.

    Authentication: none(없음). 저장하십시오.

    URL
    https://mcp.bykaranteli.com/?key=bk_...your key...

    이 주소는 비밀번호처럼 작동합니다. 공개된 곳에 붙여넣었다면 Data & API(데이터 및 API)에서 키를 폐기하고 새로 만드십시오.

5. Claude Desktop

Claude Desktop은 컴퓨터에서 작은 프로그램 bykaranteli-mcp를 실행합니다. Node.js가 설치되어 있어야 합니다(nodejs.org에서 LTS 버전 다운로드).

  1. 설정 파일 편집

    Claude Desktop에서 Settings, Developer, Edit config 순서로 여십시오. claude_desktop_config.json이라는 파일이 열립니다.

    아래 블록을 그 파일에 붙여넣으십시오(파일에 이미 "mcpServers" 부분이 있다면 그 안에 "bykaranteli" 항목을 추가하십시오). bk_...를 본인의 키로 바꾸십시오. 저장한 뒤 Claude Desktop을 다시 시작하십시오.

    claude_desktop_config.json
    {
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_...your key..." }
    }
  }
}

6. Claude Code와 Cursor

  1. Claude Code(터미널)

    명령 하나면 됩니다. bk_...를 본인의 키로 바꾸십시오.

    터미널
    claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_...your key... -- npx -y bykaranteli-mcp

  2. Cursor와 다른 편집기

    편집기의 MCP 설정을 열고(Cursor: Settings, MCP, Add 순서) 아래 블록을 mcp.json에 붙여넣으십시오. URL과 헤더를 받는 편집기라면 어느 것이든 같은 방법으로 됩니다.

    mcp.json
    {
  "mcpServers": {
    "bykaranteli": {
      "url": "https://mcp.bykaranteli.com/mcp",
      "headers": { "Authorization": "Bearer bk_...your key..." }
    }
  }
}

7. 프로그램에서 API 호출하기

어시스턴트 없이 직접 만든 코드나 스프레드시트만으로 씁니다.

  1. 코드 없이 한 번 호출해 보기

    Data & API(데이터 및 API)에는 플레이그라운드(Playground)가 있습니다. 엔드포인트를 고르고 '보내기'를 누른 뒤 JSON을 읽으십시오. 브라우저 세션을 사용하므로 붙여넣을 것이 없습니다.

  2. 터미널에서 같은 호출 하기

    /api/public/ 아래의 모든 주소는 JSON으로 응답합니다. 키를 헤더에 붙이십시오. bk_...를 본인의 키로 바꾸십시오.

    curl
    curl -s "https://bykaranteli.com/api/public/funding-heatmap" -H "Authorization: Bearer bk_...your key..."

  3. 응답 헤더 읽기

    x-ratelimit-limit와 x-ratelimit-remaining: 플랜이 분당 허용하는 호출 수와 이번 1분 동안 남은 호출 수입니다.

    x-quota-limit, x-quota-used, x-quota-reset: 월간 한도, 지금까지 쓴 양, 초기화 시점입니다.

    엔드포인트, 필드, 예시의 전체 목록은 개발자 페이지에 있습니다.

8. 한도를 쉬운 말로

  1. 무료 계정

    분당 30회, 월 15,000회 호출이며, 어시스턴트 문과 프로그램 문을 합쳐서 셉니다. 그달 한도를 다 쓰면 다음 달 1일(UTC)까지 호출에 429("너무 많음") 응답이 돌아갑니다. 사이트의 모든 페이지는 계속 작동합니다.

  2. 더 필요하다면

    Terminal(월 29달러)은 같은 깊이에서 키 한도를 분당 60회, 월 150,000회로 올리고 사이트의 회원 도구를 더합니다.

    Builder(월 49달러)는 분당 300회, 공정 사용 기준 월 1,000,000회, API의 회원 깊이(모든 시간 단위의 LiqMap, 5분 시리즈), 그리고 월 1,000회의 x402 카탈로그 호출을 제공합니다. Business와 Scale은 상업 라이선스, 대량 내보내기, 실시간 스트림을 더합니다.

    유료 플랜은 절대 멈추지 않습니다. 공정 사용량을 넘기면 그달이 초기화될 때까지 무료 속도로 응답합니다.

9. 문제가 생겼을 때

아래 메시지는 모두 저희가 의도적으로 보내는 것이며, 각각 해결 방법이 있습니다.

어시스턴트가 "this tool call needs an account key"(이 도구 호출에는 계정 키가 필요합니다)라고 합니다.
커넥터에 키가 없습니다. claude.ai에서는 x-api-key 헤더를 추가하고, ChatGPT에서는 ?key=가 들어 있는 주소를 쓰고, Claude Desktop이나 Claude Code에서는 BYKARANTELI_API_KEY 값을 확인하십시오. 도구 목록은 키 없이도 볼 수 있지만 도구 호출은 키 없이 할 수 없습니다.
"The account key this connection sent was not recognised"(이 연결이 보낸 계정 키를 인식할 수 없습니다).
키를 복사할 때 글자가 빠졌거나 공백이 들어갔거나, 키가 폐기되었습니다. Data & API(데이터 및 API)를 열어 그 키를 폐기하고, 새로 만들어 다시 붙여넣으십시오.
claude.ai가 OAuth Client ID를 요구합니다.
Authentication 선택이 잘못되었습니다. 커넥터를 편집해 No sign-in을 고르고, OAuth 필드 두 개는 비워 두고, 키는 x-api-key 헤더에 넣으십시오.
ChatGPT가 커넥터를 저장했지만 전혀 응답하지 않습니다.
대개 인증 방식이 맞지 않는 경우입니다. none을 고르고, URL에 ?key=와 키 전체가 들어 있는지 확인하십시오.
제 스크립트가 401 "key required"를 받습니다.
요청에 키가 없습니다. Authorization: Bearer bk_...(또는 x-api-key: bk_...)로 보내십시오. 저희 페이지를 여는 브라우저에는 키가 필요 없지만 프로그램에는 항상 필요합니다.
429 "monthly quota"(월간 할당량).
이번 달 무료 15,000회를 모두 썼습니다. 다음 달 1일까지 기다리시거나 요금제 페이지에서 Terminal 또는 Builder로 옮기십시오.
429 "rate limit"(속도 제한).
1분 동안 호출이 너무 많습니다. x-ratelimit-limit에 나온 숫자에 맞춰 속도를 줄이거나 retry-after에 나온 초만큼 기다리십시오.
키를 잃어버렸습니다.
키는 두 번 표시할 수 없습니다. Data & API(데이터 및 API)에서 이전 키를 폐기하고 새로 만드십시오. 이전 키는 즉시 작동을 멈춥니다.

이 페이지에 나오는 용어

API
프로그램이 데이터를 받아 오려고 호출하는 주소입니다. 여기서는 JSON 텍스트로 받습니다.
API 키
bk_로 시작하는 긴 비밀번호로, 호출할 때마다 계정을 식별합니다.
MCP
Model Context Protocol. AI 어시스턴트가 저희 도구 같은 외부 도구를 호출하게 해 주는 플러그입니다.
커넥터(Connector)
claude.ai와 ChatGPT가 계정에 추가한 MCP 서버를 부르는 이름입니다.
헤더(Header)
요청과 함께 보내는 작은 라벨입니다. 키는 그중 하나에 담겨 전달됩니다.
속도 제한(Rate limit)
플랜이 1분에 허용하는 호출 수입니다.
할당량(Quota)
플랜이 한 달에 허용하는 호출 수입니다.