문서
무엇을 하고 싶으신가요?
Lighter 연결
Lighter(Lighter Core)는 Lighter 계정에 연결된 API 키를 사용합니다. 거래는 할 수 있지만 자금을 다른 주소로 보낼 수는 없는 공개 키와 개인 키입니다. Lighter는 계정을 소유한 지갑으로만 출금을 허용합니다. MyLiquidBot에는 계정을 소유한 L1 지갑 주소도 필요합니다. 계정 인덱스와 API 키 인덱스는 저장 시 자동으로 찾습니다.
Lighter 계정은 본인 지갑으로 만들어야 합니다(이메일이나 소셜 로그인 불가). 어떤 계정 등급이든 연결하고 수동 거래하며 델타 뉴트럴을 사용할 수 있습니다. MyLiquidBot 수수료가 부과되는 그 밖의 봇은 Plus 또는 Premium이 필요합니다. Lighter는 Standard 계정에 통합자 수수료를 부과하는 것을 허용하지 않기 때문이며, 봇 생성 화면에서 만들기 전에 알려 드립니다.
연결 추가에서 Lighter를 선택하고 빠른 연결을 그대로 둔 채 Lighter 계정 지갑으로 메시지 하나에 서명하세요. MyLiquidBot이 메인 계정의 빈 슬롯에 API 키를 만들기 때문에 다른 키는 계속 작동합니다. 자금 이동과 가스 비용이 없습니다. Integrator Fee 승인은 여전히 별도 단계입니다. 직접 만들려면 API 키 붙여넣기를 선택하고 1부와 2부를 따르세요.
Lighter Core 계정 등급과 수수료
| Lighter Core 등급 | 기본 메이커 / 테이커 수수료 | MyLiquidBot 사용 시 |
|---|---|---|
| Standard | 0 / 0 | 수동 거래, 델타 뉴트럴, MyLiquidBot 수수료가 없는 봇 |
| Plus | 0.005% / 0.005% | 모든 봇 |
| Premium | 0.004% / 0.028% 기본(할인이 적용될 수 있음) | 모든 봇 |
기본 수수료는 Lighter가 부과하며 MyLiquidBot 수수료와는 별개입니다. 거래 전에 현재 거래소 요율을 확인하세요. 연결이 확인된 후 Lighter에서 또는 관리 → 등급 변경에서 등급을 변경할 수 있습니다. Lighter는 주문이나 포지션이 열려 있거나 쿨다운 중일 때 변경을 거부할 수 있으며, 등급 변경은 MyLiquidBot 외부의 거래에도 영향을 줍니다.
1부 — Lighter에서 API 키 만들기
API 키 페이지 열기
app.lighter.xyz에서 지갑을 연결하고 app.lighter.xyz/apikeys를 여세요.
새 표준 API 키 생성
Public Key와 Private Key를 복사하세요. 개인 키는 한 번만 표시됩니다. 키를 메이커 전용으로 표시하지 마세요. 거래 활성화에는 표준(메이커 전용이 아닌) API 키가 필요합니다.
지갑 주소 기록
Lighter에 연결한 EVM 주소가 L1 Wallet Address입니다.
2부 — MyLiquidBot에 연결 추가
계정 → 거래소 → 연결 추가로 이동하여 Lighter를 선택하고, 지갑으로 만든 계정과 등급 안내를 확인한 뒤 다음을 입력하세요:
| MyLiquidBot의 필드 | 입력할 내용 |
|---|---|
| Public Key | API 키의 공개 키(긴 16진수 문자열). |
| Lighter API Key - Private Key | API 키의 개인 키. 지갑 개인 키나 시드 문구는 절대 아닙니다. |
| L1 Wallet Address (Ethereum) | Lighter에서 사용하는 0x… 지갑. |
| Account Index / API Key Index | 비워 두세요. 연결을 저장하고 확인할 때 자동으로 채워집니다. |
| 선택 값(Auth Token, API URL, WebSocket URL) | 지원팀이 변경을 요청하지 않는 한 비워 두세요. |
저장 및 확인을 누르세요. MyLiquidBot이 계정을 찾고, 공개 키를 해당 계정의 API 키와 대조하고, 권한을 확인합니다.
3부 — 거래 활성화(Integrator Fee)
활성화 단계 또는 관리 → Integrator Fees 승인에서 Integrator 승인을 누르고 연결에 저장된 것과 같은 L1 지갑으로 서명하세요. 자금을 이동하지 않으며 출금을 허용하지 않습니다. 패널에 Integrator 승인됨이 표시되면 연결로 거래할 수 있습니다.
4부 — 레버리지와 마진 모드
Lighter에서는 레버리지와 교차/격리 모드가 시장별로 거래소에 저장됩니다. 봇을 만들거나 수동 주문을 보낼 때 선택한 레버리지와 거래 모드가 자동으로 동기화됩니다. 관리의 Lighter · 레버리지 설정 패널에서 시장별로 미리 설정할 수 있으며, 그 화면에서 저장한 설정을 보여 줍니다.
문제 해결
| 메시지 또는 증상 | 가능한 원인 | 해결 방법 |
|---|---|---|
| “Configured Lighter API public key was not found on this account.” / “The configured public key does NOT match any API key on this account.” | 공개 키가 다른 키나 계정에 속하거나 키가 삭제되었습니다. | app.lighter.xyz/apikeys(또는 관리에 표시된 목록)에서 공개 키를 다시 복사하여 연결을 편집하세요. 키가 삭제되었다면 새로 만드세요. |
| “Lighter did not accept this API key for the saved account…” | 개인 키, 계정, API 키 인덱스가 같은 계정에 속하지 않습니다. | 연결을 편집하여 같은 API 키의 공개 키와 개인 키를 붙여넣고, 두 인덱스를 비운 뒤 다시 저장하세요. |
| “This Lighter API key is maker-only…” | 키가 메이커 전용으로 생성되었습니다. | Lighter에서 해당 제한을 제거하거나 표준 API 키를 만들어 연결을 업데이트하세요. |
| “Lighter 계정이 Standard입니다. Lighter의 제한으로 이 봇에는 Plus 또는 Premium 계정이 필요합니다.” | 계정이 Standard이고 봇에 MyLiquidBot 수수료가 부과됩니다. | Plus 또는 Premium으로 변경하고(Lighter에서 또는 관리 → 등급 변경) 봇 생성 화면에서 다시 확인을 누르세요. |
| “Selected wallet … does not match the Lighter L1 wallet …” | 지갑에서 다른 계정이 선택되어 있습니다. | 연결에 저장된 L1 지갑을 선택하고 다시 서명하세요. |
| “Another Lighter operation for this API key is in progress.” | 두 작업이 동시에 전송되었습니다. | 1분 기다렸다가 다시 시도하세요. 작업을 여러 번 반복하지 마세요. |
| 봇 양식: “No local leverage/mode is saved for this market…” | 해당 시장의 레버리지 또는 거래 모드가 아직 동기화되지 않았습니다. | 양식에서 레버리지나 거래 모드를 변경하거나(자동 동기화됨) 관리 → 레버리지 설정에서 설정한 뒤 봇을 만드세요. |
| 주문의 nonce 또는 서명 오류 | Lighter에서 API 키가 교체되었거나 취소되었습니다. | 영향을 받는 봇을 일시정지하고, 새 API 키를 만들고, 연결을 편집한 뒤 확인이 끝나면 재개하세요. |