거래소 API 설정 가이드

계정 메뉴 진입

화면 우측 상단의 프로필 아이콘(계정 아바타)에 마우스를 올리면 드롭다운 메뉴가 열립니다. 목록 아래쪽의 API management를 클릭하면 API 키 관리 화면으로 이동합니다.

bitget.com — account menu

닉네임·UID 등 계정 식별 정보는 모자이크 처리. 목록 하단의 API management를 클릭합니다.

API keys 관리 화면 — 무엇이 보이는지

왼쪽 사이드바에서도 같은 위치를 확인할 수 있습니다: Security 바로 아래 API keys 항목이 현재 페이지로 활성화되어 있습니다. 이미 발급된 키가 있다면 목록에 표시되고, 새로 만들려면 우측 상단 Create API key를 클릭합니다.

bitget.com/asia/account/newapi

좌측 사이드바의 API keys가 바로 이 페이지의 위치입니다. 키 값·IP·계정 이메일·봇 이름은 모자이크 처리했습니다.

키 종류 선택

Create API key 클릭 시 두 가지 방식 중 선택합니다.

• System-generated API key — Bitget이 HMAC 방식 키 쌍을 즉시 생성. 대부분의 자동매매 사이트 연동은 이 방식을 사용합니다.
• User-generated API key — RSA 비대칭키를 직접 만들어 공개키만 등록. 별도 서명 인프라가 필요해 일반적인 봇 연동에는 잘 쓰이지 않습니다.

Select API key type

System-generated를 선택합니다.

키 이름 · 패스프레이즈 · 기본 권한

• Note — 용도를 구분할 이름 (예: ai-futures-bot)
• Passphrase (API token) — 8~32자 영숫자. API 호출 시 시크릿 키와 함께 매번 필요한 세 번째 값입니다. 키/시크릿과 별도로 반드시 기록해두세요.
• Permissions — Read-write를 선택해야 주문 제출이 가능합니다. Read-only는 조회만 가능해 자동매매에는 사용할 수 없습니다.

Create new API key

배경의 기존 키 값·IP·계정 이메일·봇 이름도 모자이크 처리했습니다.

세부 권한 범위 지정

스크롤하면 세부 권한 체크박스가 나옵니다. 자동매매 봇에는 Unified account → Manage와 Unified account → Trade 두 가지를 반드시 함께 켜야 합니다.

Create new API key — Permission type

Wallet → Withdraw 는 체크하지 않습니다. IP·봇 이름은 모자이크 처리했습니다.

IP 화이트리스트 등록

권한 체크박스 바로 아래, 같은 화면에 Bind IP addresses (optional, up to 30 per key) 입력란이 있습니다. 자동매매 사이트/서버가 실제로 요청을 보내는 고정 IP만 입력하세요 — 여러 개면 쉼표로 구분해 최대 30개까지 등록할 수 있습니다.

Create new API key — Bind IP addresses

MetaQuant 플랫폼의 실제 고정 서버 IP를 입력했습니다. 이 값은 특정 유저의 비밀값이 아니라 플랫폼 전체가 공통으로 사용하는 발신 IP라, 어떤 거래소를 등록하든 동일하게 입력하면 됩니다.

발급 완료 — Secret Key는 지금 한 번만

Next를 누르면 보안 인증(이메일/OTP 등) 후 키가 생성됩니다. 생성 직후 화면에서 Secret Key 전체 값이 이 순간 단 한 번만 표시됩니다. 화면을 벗어나기 전에 API Key · Secret Key · Passphrase 세 값을 안전한 곳에 저장하세요 — 이후에는 Secret Key를 다시 확인할 방법이 없습니다.

bitget.com/asia/account/newapi — View

발급 후 API keys 목록에서 Details를 눌러 다시 열어본 화면입니다. Access API Key·Secret Key·QR 코드는 모자이크 처리했습니다 — Secret Key는 이 화면에서도 *로만 표시되고 원문은 다시 볼 수 없습니다.

거래소 API 설정 — 세 값 입력

사이트의 거래소 API 설정 화면에서 거래소 탭 중 Bitget을 선택한 뒤, 발급받은 값을 각 칸에 붙여넣고 저장합니다.

• API KEY — Part 01에서 발급한 API Key
• SECRET KEY — 발급 완료 시 단 한 번 표시된 Secret Key
• PASSPHRASE — Step 04에서 직접 설정한 값

자동매매 사이트 — 거래소 API 설정

서버 IP 안내 문구는 모자이크 처리. Gate.io·XT.com·Bybit 등 다른 거래소도 같은 방식으로 각각 독립 등록됩니다.

사이트 안내 문구 그대로 — API 키 생성 시 거래 권한만 활성화하고 출금 권한은 반드시 끄며, IP 제한을 쓴다면 사이트가 안내하는 서버 IP를 허용 목록에 추가해야 합니다. Part 01~02에서 발급한 키가 이 조건을 그대로 만족합니다.

AI 자동거래 활성화

API 설정 저장 후 웹페이지를 새로고침한 다음, 아래 AI 자동거래 섹션의 거래 활성화됨 토글을 켜면 봇이 실제로 주문을 넣기 시작합니다. 새로고침을 건너뛰면 토글을 켜도 반영되지 않아 거래가 시작되지 않습니다. 거래소별 스위치를 끄면 그 거래소의 신규 진입만 멈추고, 이미 열린 포지션과 예약된 반대편 주문은 그대로 유지되어 자동으로 청산되지 않습니다 — 켜고 끄는 시점을 신중히 판단하세요.

계정 메뉴 진입

화면 우측 상단의 프로필 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 목록에서 API 관리를 클릭하면 API 키 관리 화면으로 이동합니다.

xt.com — account menu

닉네임·UID 등 계정 식별 정보는 모자이크 처리. 드롭다운 목록의 API 관리를 클릭합니다.

API 관리 화면 진입

우측 상단 계정 아이콘 → API 관리로 들어가면 발급 폼과 기존 키 목록이 한 화면에 함께 나옵니다.

xt.com/ko/accounts/user/api

기존 키의 닉네임·퍼블릭 키는 모자이크 처리. 화이트리스트 IP(66.42.42.24)는 플랫폼 공용 IP라 그대로 노출.

권한 선택 및 발급

닉네임을 입력하고 아래 권한 체크박스에서 필요한 항목만 선택한 뒤, 화이트리스트 IP와 Google OTP 코드를 입력하면 바로 발급됩니다.

거래소 API 설정 — 두 값 입력

사이트의 거래소 API 설정 화면에서 거래소 탭 중 XT.com을 선택한 뒤, 발급받은 값을 각 칸에 붙여넣고 저장합니다.

• API KEY — STEP 01~02에서 발급한 API Key
• SECRET KEY — 발급 완료 시 한 번만 표시된 Secret Key

자동매매 사이트 — 거래소 API 설정 (XT.com)

서버 IP 안내 문구는 모자이크 없이 그대로 노출됩니다(플랫폼 공용 IP). 거래소 탭을 바꿔가며 각각 독립적으로 등록합니다.

사이트 안내 문구 그대로 — API 키 생성 시 선물 활성화 권한만 활성화하고 출금 활성화 권한은 반드시 끄며, IP 제한을 쓴다면 사이트가 안내하는 서버 IP를 허용 목록에 추가해야 합니다. STEP 01~02에서 발급한 키가 이 조건을 그대로 만족합니다.

AI 자동거래 활성화

API 설정 저장 후 웹페이지를 새로고침한 다음, 아래 AI 자동거래 섹션의 거래 활성화됨 토글을 켜면 봇이 실제로 주문을 넣기 시작합니다. 새로고침을 건너뛰면 토글을 켜도 반영되지 않아 거래가 시작되지 않습니다. 거래소별 스위치를 끄면 그 거래소의 신규 진입만 멈추고, 이미 열린 포지션과 예약된 반대편 주문은 그대로 유지되어 자동으로 청산되지 않습니다 — 켜고 끄는 시점을 신중히 판단하세요.

계정 메뉴 진입

화면 우측 상단의 프로필 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 목록에서 API Management를 클릭하면 API 키 관리 화면으로 이동합니다.

gate.com — account menu

닉네임·UID·자산 정보는 모자이크 처리. 드롭다운 목록의 API Management를 클릭합니다.

API Key 생성 — Trading Account

Create API Key를 누르고 계정 타입으로 Trading Account를 선택하면 발급 폼이 열립니다. API Key Remark에 이름을 적고, IP Permissions에 플랫폼 서버 IP를 등록합니다.

gate.com/myaccount/profile/api-key/save

Bind IP를 Recommended 상태로 두고 플랫폼 서버 IP를 입력합니다.

권한 설정 — Perpetual Futures + Wallets

스무 가지가 넘는 권한 목록 중 자동매매 봇에는 Perpetual Futures와 Wallets 두 가지만 Read And Write로 켜면 됩니다.

Permissions

Perpetual Futures = 선물 주문/포지션, Wallets = 잔고 조회. Withdraw는 항상 끔.

발급 완료 확인

상세 화면에서 등록한 IP와 권한이 맞는지 다시 확인합니다.

View API Key

Key·Remark는 모자이크 처리, IP 66.42.42.24는 플랫폼 공용 IP라 그대로 노출.

거래소 API 설정 — 두 값 입력

사이트의 거래소 API 설정 화면에서 거래소 탭 중 Gate.io을 선택한 뒤, 발급받은 값을 각 칸에 붙여넣고 저장합니다.

• API KEY — STEP 01~03에서 발급한 API Key
• SECRET KEY — 발급 완료 시 한 번만 표시된 Secret Key

자동매매 사이트 — 거래소 API 설정 (Gate.io)

서버 IP 안내 문구는 모자이크 없이 그대로 노출됩니다(플랫폼 공용 IP). 거래소 탭을 바꿔가며 각각 독립적으로 등록합니다.

사이트 안내 문구 그대로 — API 키 생성 시 Perpetual Futures 권한만 활성화하고 Withdraw 권한은 반드시 끄며, IP 제한을 쓴다면 사이트가 안내하는 서버 IP를 허용 목록에 추가해야 합니다. STEP 01~03에서 발급한 키가 이 조건을 그대로 만족합니다.

AI 자동거래 활성화

API 설정 저장 후 웹페이지를 새로고침한 다음, 아래 AI 자동거래 섹션의 거래 활성화됨 토글을 켜면 봇이 실제로 주문을 넣기 시작합니다. 새로고침을 건너뛰면 토글을 켜도 반영되지 않아 거래가 시작되지 않습니다. 거래소별 스위치를 끄면 그 거래소의 신규 진입만 멈추고, 이미 열린 포지션과 예약된 반대편 주문은 그대로 유지되어 자동으로 청산되지 않습니다 — 켜고 끄는 시점을 신중히 판단하세요.

계정 메뉴 진입

화면 우측 상단의 프로필 아이콘을 클릭하면 드롭다운 메뉴가 열립니다. 목록에서 API를 클릭하면 API 키 관리 화면으로 이동합니다.

bybit.com — account menu

닉네임·UID 등 계정 식별 정보는 모자이크 처리. 드롭다운 목록의 API를 클릭합니다.

Create New Key

Create New Key를 누르면 키 타입 선택 창이 뜨는데 System-generated API Keys를 선택합니다. 이름을 정하고 API Key Permissions에서 Read-Write를 선택한 뒤 IP 화이트리스트를 등록합니다.

bybit.com/app/user/add-secret-key

Read-Write 선택 시 아래 권한 표가 나타납니다.

권한 설정

Unified Trading 아래 Contract 항목의 Orders와 Positions 두 개만 체크하면 선물 주문 제출과 포지션 조회가 가능해집니다. Assets 섹션의 Withdrawal은 기본적으로 잠겨 있고, 자동매매 봇에는 필요하지 않으니 그대로 둡니다.

API Key Permissions — Read-Write

Contract: Orders, Positions만 체크. USDC Contracts·SPOT·Earn 등은 불필요.

발급 완료 확인

API Key Records 목록에 새 키가 나타납니다. Permission 칸에 원하는 권한이 표시되는지 확인하세요.

API Management

Name·APIKey는 모자이크 처리, API Secret은 생성 시 한 번만 노출된 뒤 자동으로 가려짐. IP 66.42.42.24는 플랫폼 공용 IP.

거래소 API 설정 — 두 값 입력

사이트의 거래소 API 설정 화면에서 거래소 탭 중 Bybit을 선택한 뒤, 발급받은 값을 각 칸에 붙여넣고 저장합니다.

• API KEY — STEP 01~03에서 발급한 API Key
• SECRET KEY — 발급 완료 시 한 번만 표시된 Secret Key

자동매매 사이트 — 거래소 API 설정 (Bybit)

서버 IP 안내 문구는 모자이크 없이 그대로 노출됩니다(플랫폼 공용 IP). 거래소 탭을 바꿔가며 각각 독립적으로 등록합니다.

사이트 안내 문구 그대로 — API 키 생성 시 Contract 권한만 활성화하고 Assets·Withdrawal 권한은 반드시 끄며, IP 제한을 쓴다면 사이트가 안내하는 서버 IP를 허용 목록에 추가해야 합니다. STEP 01~03에서 발급한 키가 이 조건을 그대로 만족합니다.

AI 자동거래 활성화

API 설정 저장 후 웹페이지를 새로고침한 다음, 아래 AI 자동거래 섹션의 거래 활성화됨 토글을 켜면 봇이 실제로 주문을 넣기 시작합니다. 새로고침을 건너뛰면 토글을 켜도 반영되지 않아 거래가 시작되지 않습니다. 거래소별 스위치를 끄면 그 거래소의 신규 진입만 멈추고, 이미 열린 포지션과 예약된 반대편 주문은 그대로 유지되어 자동으로 청산되지 않습니다 — 켜고 끄는 시점을 신중히 판단하세요.