에이전트 키와 권한

AI 에이전트에는 지갑 개인 키가 전혀 필요 없습니다. 앱 안에서 에이전트는 연결된 지갑 세션을 통해, 사용자가 확인한 경우에만 동작합니다. 외부 에이전트나 봇에는 필요한 권한 플래그만 가진 Bitnxs API 키를 만드세요. Bitnxs API 키에는 출금 권한 자체가 없습니다.

앱 내 에이전트는 어떤 자격 증명을 쓰나요?

자격 증명	저장 위치	할 수 있는 일
LLM API 키 (예: OpenAI)	브라우저에만 저장 (localStorage)	페이지가 LLM을 호출. bitnxs에는 필요 없음.
지갑 세션	지갑 연결 시 생성	에이전트 패널에서 확인한 지정가 주문 실행.

앱 내 에이전트는 별도의 “에이전트 키”를 쓰지 않습니다.

외부 에이전트용 거래 전용 API 키 만들기

앱에서 More → API Keys를 열고 키 이름을 정합니다(예: claude-agent-1; 영문·숫자·_·-, 최대 32자).
에이전트에 필요한 권한만 선택합니다(아래 표).
지갑에서 파생 메시지에 한 번 서명합니다. 키는 브라우저에서 파생되며 한 번만 표시되니 에이전트의 비밀 저장소에 복사하세요.
에이전트는 이 키로 세션에 서명하고 user로 메인 지갑 주소를 전달합니다. 인증 참고.
More → API Keys에서 언제든 취소할 수 있으며, 취소하면 해당 키의 세션이 종료됩니다.

4가지 권한 플래그

플래그	허용	부여 대상
`place_orders`	`POST /session/order`, `/session/batchOrder`	진입 주문을 넣는 에이전트
`cancel_orders`	`POST /session/cancel`, `/session/modify`	주문을 관리·가격 변경하는 에이전트
`change_leverage`	`POST /session/leverage`	보통 끄기. 레버리지는 직접 설정
`set_triggers`	`POST /session/trigger`, `/session/cancel_trigger`	TP/SL을 관리하는 에이전트

출금·이체·키 관리 플래그는 없습니다. API 키로는 자금을 출금하거나 다른 키를 만들 수 없습니다. 꺼진 플래그의 작업은 api-key-permission-denied를 반환합니다.

안전 모범 사례

에이전트마다 키 1개, 명확한 라벨로. 하나만 따로 취소할 수 있습니다.
최소 권한: place_orders부터(TP/SL 관리 시 set_triggers 추가). change_leverage는 끄세요. 앱 내 에이전트도 레버리지를 건드리지 않도록 설계되어 있습니다.
키를 프롬프트에 넣지 마세요. API 키나 시드 문구를 LLM 채팅에 붙여넣지 말고 환경 변수나 시크릿 매니저에서 불러오세요.
별도 지갑에 자금 분리: 에이전트에 맡겨도 되는 금액만 넣으세요.
레버리지는 미리 직접 낮게 설정하세요. 에이전트는 레버리지가 아닌 수량으로 조절합니다.
속도 제한 준수: 서명자당 쓰기 약 20회/초(버스트 50). /info와 /ws는 제한 없음.
모니터링: WebSocket으로 executionReports를 구독하고 이상하면 키를 취소하세요.
앱은 LLM API 키를 브라우저에 저장합니다. 사용 한도가 있는 키를 쓰고 공용 컴퓨터에서는 사용하지 마세요.