Bybit에서 API 키 권한을 확인하는 방법

API 키 권한 수준 이해

1. Bybit는 API 권한을 읽기 전용, 거래, 출금의 세 가지 등급으로 분류합니다.

2. 읽기 전용 액세스를 통해 상태를 수정하지 않고도 시장 데이터, 계정 잔액, 주문 내역 및 위치 정보를 검색할 수 있습니다.

3. 거래 허가를 통해 현물, 마진 및 파생상품 시장 전반에 걸쳐 주문을 발주, 취소 및 수정할 수 있습니다.

4. 출금 권한은 Bybit 계정에서 자금 이체를 시작할 수 있는 권한을 부여합니다. 이 권한은 명시적인 수동 활성화 및 추가 보안 확인이 필요합니다.

5. 각 권한 수준은 API 키 생성 중에 할당되며 새 키 쌍을 생성하지 않고는 소급하여 변경할 수 없습니다.

API 키 대시보드 찾기

1. 검증된 자격 증명을 사용하여 Bybit 계정에 로그인하고 2FA 인증을 완료하세요.

2. 오른쪽 상단 사용자 메뉴로 이동하여 "보안 센터" 섹션에서 "API 관리"를 선택합니다.

3. 대시보드에는 관련 라벨, 생성 타임스탬프, IP 바인딩 상태와 함께 모든 활성 API 키가 표시됩니다.

4. 키 옆에 있는 "세부 정보" 버튼을 클릭하면 권한 플래그와 화이트리스트 IP를 포함한 전체 구성이 표시됩니다.

5. “Testnet Only”라고 표시된 키는 별도로 표시되며 설계상 메인넷 작업과 격리됩니다.

API 응답을 통해 권한 플래그 확인

1. API 키와 비밀 서명을 사용하여 /user/info 엔드포인트에 GET 요청을 보냅니다.

2. 필수 헤더( X-BAPI-API-KEY , X-BAPI-SIGN , X-BAPI-TIMESTAMP 및 X-BAPI-RECV-WINDOW ) 를 포함합니다.

3. 성공적인 응답은 활성화된 기능을 부울 값으로 나열하는 권한 필드가 포함된 JSON 개체를 반환합니다.

4. 응답에 'withdraw': true 가 포함되면 키에 철회 권한이 있는 것입니다. 명시적으로 요구되지 않는 한 이 값은 false로 유지되어야 합니다.

5. 누락되거나 일관되지 않은 권한 표시는 구성이 잘못되었거나 키 초기화가 불완전함을 나타냅니다.

실제로 권한 제한 해석하기

1. 읽기 권한만 있는 API 키는 /order/create 에 POST를 시도할 때 HTTP 403을 반환합니다.

2. 출금이 아닌 키를 사용하여 /asset/withdraw를 호출하려고 하면 오류 코드 10004 와 "출금 권한이 없습니다"라는 설명 메시지가 표시됩니다.

3. 거래 엔드포인트는 엄격한 검증을 시행합니다. 파생상품 권한이 없는 키에 레버리지 매개변수가 포함된 주문을 제출하면 오류 11001 이 발생합니다.

4. 권한 범위에 따라 속도 제한 동작이 변경됩니다. 거래 키는 읽기 전용 키보다 가중치 기반 할당량이 더 엄격합니다.

5. 권한 수준에 관계없이 요청이 등록된 주소 범위 외부에서 발생하는 경우 IP 바인딩 키가 자동으로 실패합니다.

자주 묻는 질문

Q: API 키 생성 후 권한을 다운그레이드할 수 있나요? 아니요. Bybit는 기존 키에 대한 권한 수정을 지원하지 않습니다. 현재 키를 비활성화하고 원하는 설정으로 새 키를 생성해야 합니다.

Q: 설정 중에 API 키를 선택했는데도 왜 "Trading: false"가 표시됩니까? 이는 계정 설정에서 선물 또는 파생상품 거래를 활성화하기 전에 키가 생성되었을 때 발생합니다. 먼저 해당 모듈을 활성화한 다음 키를 다시 생성하세요.

Q: 내 키가 성공적으로 액세스한 엔드포인트를 감사할 수 있는 방법이 있습니까? 예. Bybit는 API 관리 인터페이스 내의 "API 활동 기록" 탭에 인증된 모든 API 호출을 기록하며 타임스탬프, 엔드포인트 및 응답 코드를 표시합니다.

Q: API 키를 IP 주소에 바인딩하고 나중에 네트워크를 변경하면 어떻게 되나요? 목록에 없는 IP로부터의 요청은 오류 코드 10002 와 함께 HTTP 401을 수신합니다. 기능을 복원하려면 IP 화이트리스트를 업데이트하거나 바인딩을 비활성화해야 합니다.