.. _getting_started:

===============
Getting started
===============

PyQQQ를 사용하여 금융 데이터를 분석하고 거래를 자동화하세요. 이 문서는 PyQQQ를 처음 사용하는 분들을 위해 기본적인 시작 방법을 안내합니다.


시작에 앞서
----------------


1. `PyQQQ <https://www.pyqqq.net>`_ 에서 회원가입을 합니다.
2. 로그인 후 좌측의 프로필 페이지로 이동 후 **API Key** 를 확인하세요. API Key 는 PyQQQ 서비스를 사용하는 데 필수적입니다.
3. :ref:`증권사 <brokers>` 섹션을 참고하여 사용하려는 증권사 정보를 확인하고 연동 설정을 완료하세요.


API Key
~~~~~~~~~~~~~

.. image:: ../_static/images/apikey.png
   :class: focus-box
   :width: 600
   :align: center

발급받은 API Key는 주가 조회, 관리종목 확인, 주가지수 검색 등 다양한 서비스에 사용됩니다. API Key는 개인 정보로 간주되므로 타인과 공유하거나 외부에 노출되지 않도록 주의하세요.


요구 사항
~~~~~~~~~~~~~

PyQQQ를 사용하려면 아래 요구 사항을 충족해야 합니다.

- Python 3.11 이상
- 인터넷 연결


국내 증권사
----------------

모의투자 및 실거래를 위해서는 국내 증권사의 계좌가 필요합니다. PyQQQ에서는 국내 사용자가 많은 아래의 증권사들을 지원하고 있고, 추가 지원도 계획 중에 있습니다.

* `한국투자증권 <https://securities.koreainvestment.com>`_
* `LS증권 <https://www.ls-sec.co.kr>`_

.. note::

   주가 조회 및 백테스트 등의 기능은 증권사 정보 없이도 사용이 가능합니다!


.. toctree::
   :maxdepth: 2
   :hidden:

   준비 및 설치하기 <install>
   증권사 <brokers/index>
   intro_tutorials/index