---
updatedAt: 2026-07-09T08:43:28.000Z
agentTools:
  projectIndex: https://apidocs.bithumb.com/llms.txt
---

# 빠른 시작 가이드

빗썸 API Key 발급부터 첫 번째 API 호출까지, 단계별로 빠르게 시작하는 방법을 안내합니다

## API Key 발급

1. <Anchor label="빗썸" target="_blank" href="https://www.bithumb.com">빗썸</Anchor> 계정을 생성하고 본인 인증을 완료합니다.
2. 빗썸 웹사이트에서 API Key와 Secret Key를 발급받습니다.
   * 로그인 후 <Anchor label="마이페이지 > API 관리" target="_blank" href="https://www.bithumb.com/react/api-support/management-api">마이페이지 > API 관리</Anchor>에서 발급할 수 있습니다.
3. API 활성 항목(자산조회, 주문조회, 주문하기, 출금하기 등)을 필요에 맞게 선택합니다.
4. 접근을 허용할 IP 주소를 등록합니다.
5. 약관에 동의 후, **API Key 생성** 버튼을 클릭하여 Key 생성을 완료합니다.

<Callout icon="🔑" theme="warning">
  Secret Key는 발급 시 한 번만 표시됩니다. 발급 즉시 안전한 곳에 보관하세요.
</Callout>

## API 기본 정보

| 항목                | 내용                                             |
| ----------------- | ---------------------------------------------- |
| Base URL          | `https://api.bithumb.com`                      |
| 프로토콜              | HTTPS                                          |
| 데이터 형식            | JSON                                           |
| 인증 방식             | JWT (HS256) — `Authorization` 헤더에 Bearer 토큰 포함 |
| Public API 요청 제한  | 초당 최대 150회                                     |
| Private API 요청 제한 | 초당 최대 140회                                     |
| API Key 발급 한도     | 계정당 최대 10개(만료 내역 포함)                           |
| 코드 샘플 지원 언어       | JavaScript, Python, Java                       |

## Step 1: 개발 환경 설정

빗썸 API를 호출하려면 언어별로 필요한 패키지를 설치합니다.

<Callout icon="fa-book" theme="default">
  프로젝트 구조와 `.env` 파일로 API 키를 관리하는 방법은 [개발 환경 설정하기](doc:개발-환경-설정하기)에서 다룹니다.
</Callout>

| 언어      | 설치 명령                                                       |
| ------- | ----------------------------------------------------------- |
| Node.js | `npm install jsonwebtoken uuid axios`                       |
| Python  | `pip install PyJWT requests`                                |
| Java    | `java-jwt`, `httpclient`, `jackson-databind` (Maven/Gradle) |

## Step 2: Public API 호출하기

Public API는 인증 없이 호출할 수 있습니다. 거래 대상 목록 조회 API로 거래 가능한 거래 대상 페어 목록을 가져오는 것부터 시작합니다.

<Callout icon="fa-book" theme="default">
  시세, 캔들, 호가 등 다양한 Public API 활용법은 [API 호출해 보기](doc:api-호출해-보기)에서 다룹니다.
</Callout>

<Tabs>
  <Tab title="JavaScript">
    ```javascript
    const options = {method: 'GET', headers: {accept: 'application/json'}};

    fetch('https://api.bithumb.com/v1/market/all?isDetails=false', options)
      .then(response => response.json())
      .then(response => console.log(response))
      .catch(err => console.error(err));
    ```
  </Tab>

  <Tab title="Python">
    ```python
    import requests

    url = "https://api.bithumb.com/v1/market/all?isDetails=false"

    headers = {"accept": "application/json"}

    response = requests.get(url, headers=headers)

    print(response.text)
    ```
  </Tab>

  <Tab title="Java">
    ```java
    OkHttpClient client = new OkHttpClient();

    Request request = new Request.Builder()
      .url("https://api.bithumb.com/v1/market/all?isDetails=false")
      .get()
      .addHeader("accept", "application/json")
      .build();

    Response response = client.newCall(request).execute();
    ```
  </Tab>
</Tabs>

응답 예시:

```json
[
  {
    "market": "KRW-BTC",
    "korean_name": "비트코인",
    "english_name": "Bitcoin"
  },
  {
    "market": "KRW-ETH",
    "korean_name": "이더리움",
    "english_name": "Ethereum"
  }
]
```

<Callout icon="💡" theme="info">
  거래 대상 페어 심볼(예: `KRW-BTC`)은 현재가 조회, 호가 정보 조회, 주문하기 등 대부분의 API에서 필수 파라미터로 사용됩니다. 이 API를 가장 먼저 호출하여 유효한 거래 대상 페어 목록을 확인하세요.
</Callout>

## Step 3: 인증 토큰 생성하기

Private API(자산 조회, 주문, 출금 등)를 호출하려면 JWT(JSON Web Token) 인증 토큰을 생성하여 `Authorization` 헤더에 포함해야 합니다. 인증 흐름은 다음과 같습니다.

1. API Key와 Secret Key 준비
2. JWT Payload 구성(`access_key`, `nonce`, `timestamp`)
3. Secret Key로 서명(HS256)
4. `Authorization` 헤더에 Bearer 토큰 포함
5. API 요청 전송

```http
GET /v1/accounts HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json; charset=utf-8
```

<Callout icon="fa-book" theme="default">
  JWT 구조, query_hash 생성 규칙, 배열 파라미터 해싱은 [인증 토큰 생성하기](doc:인증-토큰-생성하기)에서 상세히 다룹니다. 실제 Private API 호출 예제는 [API 호출해 보기](doc:api-호출해-보기)에서 확인하세요.
</Callout>

## 다음 단계

각 단계를 더 깊이 알아보려면 상세 가이드를 참고하세요.

<Cards>
  <Card title="개발 환경 설정하기" href="개발-환경-설정하기" icon="fa-solid fa-laptop-code">
    언어별 패키지 설치, .env 파일 관리, 프로젝트 구조를 안내합니다.
  </Card>

  <Card title="API 호출해 보기" href="api-호출해-보기" icon="fa-solid fa-code">
    Public API 조회부터 인증이 필요한 Private API 호출까지 실전 시나리오를 다룹니다.
  </Card>

  <Card title="인증 토큰 생성하기" href="인증-토큰-생성하기" icon="fa-solid fa-key">
    JWT 구조와 토큰 생성 과정을 상세히 설명합니다.
  </Card>

  <Card title="API 소개" href="api-레퍼런스" icon="fa-book">
    Open API, Private API, WebSocket 전체 구성을 확인합니다.
  </Card>

  <Card title="용어 이해하기" href="가상-자산-투자-이해하기" icon="fa-graduation-cap">
    거래 대상 페어, 주문 방식, 캔들 등 주요 개념을 정리합니다.
  </Card>
</Cards>