# API 키를 서버에 저장하고 사용하기

PyQQQ에서 제공하는 `증권사 API 관리` 기능을 활용하면 암호화된 API 정보를 손쉽게 사용할 수 있습니다.

## 증권사 API 등록하기

[증권사 API 관리](https://pyqqq.net/app/account/brokerage) 페이지에서 우측에 있는 API 등록 버튼을 누릅니다.

```{image} ../_static/images/api_kms.png
:class: focus-box
:width: 600px
:align: center
```

팝업이 보이면 API 이름과 증권사를 선택하여 API 정보를 기입합니다. `API 이름`은 추후 파이썬 코드에서 사용되므로 짧지만 명료한 이름이 좋습니다. 한번 등록된 API 정보는 수정할 수 없으며 삭제 후 등록을 해주셔야 합니다.

## 사용 예시

### 환경변수 설정

```{code-block}
:name: .env

## 이전에 등록한 API 이름을 ACCOUNT_NICK의 값으로 설정합니다.
ACCOUNT_NICK=한투ISA

```

### 사용하기

```python
from pyqqq.brokerage.helper import PyQQQAutoConnectionSingleton

# 싱글톤 인스턴스 생성
conn = PyQQQAutoConnectionSingleton()

# 계좌 정보 조회
account_info = conn.broker_simple.get_account()

# 모의투자 사용 시
if conn.paper_broker_simple:
    paper_account_info = conn.paper_broker_simple.get_account()
```

## 주요 속성

- `auth`: 인증 객체
- `broker_code`: 브로커 코드 ("kis" 또는 "ebest")
- `broker`: 일반 거래용 브로커 객체
- `broker_simple`: 간편 거래용 브로커 객체
- `paper_auth`: 모의투자 인증 객체 (설정된 경우)
- `paper_broker_simple`: 모의투자 간편 브로커 객체 (설정된 경우)

## 주의사항

1. 환경변수가 설정되지 않은 경우 `NoConnection` 인스턴스가 반환됩니다.
2. 싱글톤 패턴이 적용되어 있어 여러 번 인스턴스화해도 동일한 객체가 반환됩니다.
3. 모의투자 기능은 각 브로커별로 별도의 환경변수 설정이 필요합니다.