프로젝트 소개

twelvedata-python은 Twelve Data의 금융 API 및 WebSocket 서비스를 위한 공식 Python 클라이언트입니다. Twelve Data API 키가 필요하며, README에 따르면 WebSocket 접근은 Pro 요금제 이상에서 사용할 수 있습니다. 이 라이브러리는 주식, 외환, 암호화폐, ETF, 지수에 대한 OHLC 시계열을 검색합니다. 또한 시세, 실시간 및 장 마감 가격, 환율, 통화 변환을 제공합니다. 펀더멘털 메서드는 회사 프로필 및 로고, 배당금, 주식 분할, 실적 및 캘린더, IPO 캘린더, 통계, 내부자 거래, 손익계산서, 대차대조표, 현금 흐름, 임원, 기관 또는 펀드 보유자를 다룹니다. 시계열 요청은 심볼, 간격, 거래소, MIC 코드, 국가, 출력 크기, 시간대, 시작 및 종료 날짜, 정렬 순서 등의 매개변수를 지원합니다. 결과는 JSON, CSV, pandas DataFrame 또는 요청 URL로 반환할 수 있습니다. 100개 이상의 기술적 지표를 시계열 요청에 연결할 수 있으며, 지표만 필요할 때 OHLC 데이터를 제외할 수 있습니다. 배치 요청은 쉼표로 구분된 문자열 또는 심볼 목록을 허용하며, API 호출당 최대 120개의 심볼을 지원합니다. 배치 출력은 JSON 및 pandas 형식을 지원하며, 심볼과 날짜/시간에 대한 MultiIndex DataFrame을 포함합니다. 선택적 종속성은 차트 및 스트리밍 기능을 추가합니다. 정적 차트는 matplotlib와 mplfinance를 사용하고, 대화형 차트는 Plotly를 사용합니다. WebSocket 클라이언트는 주식, 외환, 암호화폐에 대한 이벤트 기반 스트림을 제공하며, 구독, 구독 취소, 구독 재설정, 연결, 연결 해제, 하트비트 전송 메서드를 포함합니다. 고급 기능에는 사용자 지정 Twelve Data 엔드포인트 요청, 현재 API 크레딧 사용량 확인, 디버깅을 위한 기본 URL 생성이 포함됩니다. 이 패키지는 pip로 설치되며 MIT 라이선스로 배포됩니다.