Stock Events

Stock Events

Stock Events API를 사용해 보세요

Stock Events API는 여러분이 직접 만든 툴을 통해 Stock Events 계정의 데이터를 자동으로 관리할 수 있게 해주는 Pro 전용 기능이에요. 이 API는 계정 자동화를 위해 설계되었으며, 일반적인 시장 데이터 제공이나 심볼 검색용 API가 아니라는 점을 꼭 기억해 주세요.

Write 요청을 통해 Stock Events 앱에서 직접 보고 있는 것과 동일한 관심 종목(watchlists), 심볼, 그리고 거래 내역(transactions)을 수정할 수 있습니다.

API로 무엇을 할 수 있나요?

  • 관심 종목 리스트 확인, 생성, 조회 및 업데이트
  • 관심 종목 내 심볼 리스트 확인, 추가, 업데이트 및 삭제
  • 거래 내역 리스트 확인, 생성, 조회, 업데이트 및 삭제
  • 계산된 보유 자산(Holdings) 및 배당금(Dividends) 뷰 읽기

API 키를 만드는 방법

API 키를 만들고 사용하려면 활성화된 Stock Events Pro 구독이 필요해요.

  1. Stock Events 웹 앱에 로그인하세요.
  2. 프로필(Profile)을 여세요.
  3. 설정(Settings)을 선택하세요.
  4. 항목 아래에서 데이터(Data)를 선택하세요.
  5. API Keys를 선택하세요.
  6. Create API key를 선택하세요.
  7. 식별하기 쉬운 이름(Name)을 입력한 후 생성(Create)을 누르세요.
  8. Copy API key를 선택하고, 대화 상자를 닫기 전에 키를 안전한 곳에 저장해 두세요.

전체 API 키는 단 한 번만 보여집니다. 대화 상자를 닫고 나면, API Keys 화면에는 전체 키 대신 이름, 접두사(prefix), 생성일, 마지막 사용일만 표시돼요.

만약 Pro 구독이 비활성화되면, 키는 계정에 그대로 남아있지만 Pro 권한이 다시 활성화될 때까지 API 요청 시 403 Forbidden 에러가 반환됩니다.

첫 번째 요청 보내기

API 기본 URL은 https://stockevents.app/api/v1입니다. Authorization 헤더에 Bearer 토큰 방식으로 API 키를 보내주세요.

curl -H "Authorization: Bearer $STOCK_EVENTS_API_KEY" \    https://stockevents.app/api/v1/watchlists

이 요청을 보내면 여러분의 관심 종목 리스트와 각 ID가 반환됩니다. 이 관심 종목 ID를 사용해서 특정 관심 종목의 심볼, 보유 자산(Holdings), 배당금(Dividends) 엔드포인트에 접근할 수 있어요.

요청 필드, 응답 구조, 선택적 파라미터 및 사용 가능한 모든 엔드포인트에 대한 자세한 내용은 다음 리소스를 참고해 주세요:

API 키를 안전하게 관리하세요

API 키는 비밀번호처럼 소중히 다뤄주세요. 소스 제어 시스템(Git 등)에 커밋하거나, 공개된 클라이언트 코드에 노출하거나, 쿼리 파라미터 또는 요청 본문에 담아 보내지 마세요.

API 키는 각 키마다 별도의 권한을 설정할 필요 없이 계정 자동화 API를 인증합니다. 따라서 반드시 신뢰할 수 있는 툴에서만 사용해 주세요.

만약 키가 노출되었다면, API Keys로 돌아가 Revoke API key를 선택한 뒤 Revoke를 눌러 확인해 주세요. 해당 키는 즉시 작동을 멈추며 다시 활성화할 수 없습니다. 필요한 경우 새 키를 만들어 사용하세요.

자주 발생하는 에러

  • 401 Unauthorized: API 키가 누락되었거나, 유효하지 않거나, 취소(revoked)되었습니다.
  • 403 Forbidden: 현재 계정에 활성화된 Pro 권한이 없습니다.