본문으로 건너뛰기

토스증권 Open API를 연결해 주식 검색·관심 종목 저장 24시간 API 서버 만들기

jw

2026.07.24

토스증권 Open API를 연결해 주식 검색·관심 종목 저장 24시간 API 서버 만들기 본문 이미지

이번 실습에서는 AI에게 자연어로 요청하면서 직접 API 서버를 만들어보았습니다.

처음에는 API 서버와 엔드포인트의 개념도 명확히 이해하지 못한 상태였습니다. 단순히 정해진 JSON을 반환하는 서버에서 시작했지만, 실습을 진행하면서 다른 Open API의 데이터를 가져오는 서버를 만들어보고 싶어졌습니다.

평소 관심 있던 주식을 소재로 정하고, 토스증권 Open API를 연결해 다음 기능을 구현하는 것을 목표로 삼았습니다.

  • 국내·미국 주식 랭킹 조회

  • 내 계좌의 보유 종목 조회

  • 종목 한글명으로 현재가 검색

  • 검색한 종목을 관심 종목으로 저장

  • 저장한 날짜와 당시 가격 확인

단순한 예제 데이터를 반환하는 데 그치지 않고, 실제 외부 API의 값을 받아 가공하는 서버를 만들어보고 싶었습니다.


진행 방법

1. Node.js와 Express로 기본 API 서버 만들기

먼저 Codex에게 다음과 같이 요청했습니다.

api 서버를 만들라고 해

  1. GET /hello

  2. GET /취미

  3. POST /취미: 드라마보기

처음에는 Python으로 서버가 만들어졌지만, 강의 자료의 예제가 Node.js와 Express를 사용하고 있어서 다음 프롬프트로 구조를 변경했습니다.

엔드포인트는 코드에서 이렇게 정의합니다.
server.js — Node.js + Express
GET /hello, GET /menu, POST /order 형태로 만들어줘.

그 결과 Express 서버를 실행하고 브라우저에서 다음 주소로 JSON 응답을 확인할 수 있었습니다.

http://localhost:8000/hello
{
  "message": "안녕하세요, 23기!"
}

이 과정에서 엔드포인트는 단순한 주소만 의미하는 것이 아니라 GET /hello, POST /order처럼 HTTP 메서드와 경로를 합쳐 표현한다는 점을 배웠습니다.

2. 브라우저에서 API를 확인하는 테스트 화면 추가

처음에는 브라우저에 JSON만 표시되었습니다. 다른 참여자들이 버튼과 입력창이 있는 API 테스트 화면을 만든 것을 보고 다음과 같이 요청했습니다.

테스트 화면도 추가해줘.

3. 토스증권 Open API 연결

처음에는 키움증권 API를 검토했지만 키움증권 계좌가 없었습니다. 대신 토스증권 Open API가 있다는 것을 확인했고, 다음과 같이 요청했습니다.

일단 env 파일이 있다고 보고 GET으로 Ranking과 Asset이 나오게 해줘.

토스증권에서 발급한 인증정보는 소스코드에 직접 입력하지 않고 .env에 보관했습니다.

TOSS_CLIENT_ID=발급받은_client_id
TOSS_CLIENT_SECRET=발급받은_client_secret
PORT=8000

4. 한글 종목명으로 현재가 검색

토스증권 현재가 API는 종목명이 아닌 종목코드를 요구합니다. 사용자는 종목코드보다 한글명을 입력하는 것이 편하기 때문에 다음 기능을 요청했습니다.

GET /search로 종목 한글명을 치면 현재가격이 나오는 것을 만들어줘.

서버에서 종목명과 종목코드를 연결한 뒤, 확인된 종목코드로 토스증권 현재가 API를 호출했습니다.

5. 관심 종목 저장 기능 구현

검색한 종목이 관심 있으면 저장하고 싶어서 다음과 같이 요청했습니다.

POST /save를 만들고 싶어.
GET /search에서 검색한 결과를 보고 관심 있으면 저장을 눌러서 저장 날짜 시간이랑 정보를 저장하고 싶어.

POST /save는 종목명을 받은 뒤 현재가를 다시 확인하고, 당시 가격과 저장 시각을 함께 기록합니다.

테스트 화면의 사용 순서는 다음과 같습니다.

  1. 종목 한글명 입력

  2. 현재가 검색 버튼 클릭

  3. 관심 종목 저장 버튼 클릭

  4. 저장 목록 보기 버튼 클릭

📷 이미지 첨부 위치
관심 종목 저장 결과와 저장 목록 캡처


사용한 주요 프롬프트

이번 실습에서는 한 번에 완성된 요구사항을 전달하기보다, 필요한 기능을 하나씩 추가하는 방식으로 진행했습니다.

api 서버를 만들라고 해
1. GET /hello
2. GET /취미
3. POST /취미: 드라마보기
테스트 화면도 추가해줘.
API 서버를 다른 Open API 값을 결과값으로 가져오게 해서
만들어보고 싶은데 어때?
일단 env 파일이 있다고 보고 GET으로
Ranking과 Asset이 나오게 해줘.
토스증권 API 응답에서 계좌를 확인하는 것까지 해서
내 계좌 주식 종목을 볼 수 있게 해줘.
한글명도 보이게 해줘.
GET /search로 종목 한글명을 치면
현재가격이 나오는 것을 만들어줘.
POST /save를 만들고 싶어.
GET /search에서 검색한 결과를 보고 관심 있으면 저장을 눌러서
저장 날짜 시간이랑 정보를 저장하고 싶어.


결과와 배운 점

최종적으로 다음 엔드포인트를 가진 API 서버를 만들었습니다.

GET  /hello
GET  /ranking
GET  /assets
GET  /search?name=삼성전자
POST /save
GET  /saved

이번 실습에서 가장 크게 배운 점은 API 서버가 단순히 JSON을 보여주는 페이지가 아니라는 것입니다.

클라이언트가 요청하면 서버가 다음과 같은 역할을 수행합니다.

  • 외부 API 인증

  • 외부 데이터 조회

  • 필요한 형태로 데이터 가공

  • 민감한 인증정보 보호

  • 관심 종목 데이터 저장

  • 적절한 상태 코드와 JSON 응답 반환

또한 GET과 POST의 차이도 직접 체감했습니다.

  • GET은 주로 정보를 조회할 때 사용

  • POST는 새로운 데이터를 만들거나 저장할 때 사용

시행착오

첫 번째 시행착오는 서버가 실행되지 않은 상태에서 브라우저에 접속해 연결 거부 오류가 발생한 것이었습니다.

API 서버는 계속 실행 중인 프로그램이므로 터미널이나 서버 프로세스가 종료되면 페이지에도 접속할 수 없다는 점을 알게 되었습니다.

두 번째는 이전 서버 프로세스가 8000번 포트를 계속 사용하고 있어 수정한 코드가 적용되지 않았던 문제였습니다. 코드가 잘못된 줄 알았지만 실제 원인은 이전 프로세스였습니다.

세 번째는 랭킹 API 결과에 한글 종목명이 없었던 문제였습니다. 토스증권 랭킹 API는 종목코드만 반환하기 때문에 종목정보 API를 추가로 호출해 코드를 한글명과 결합해야 했습니다.

네 번째는 계좌번호와 accountSeq를 혼동한 것입니다. 실제 계좌번호를 서버에 넣는 것이 아니라 계좌 목록 API가 반환한 accountSeq를 헤더에 사용해야 했습니다. 이후 서버가 계좌 목록을 자동 확인하도록 개선했습니다.

나만의 꿀팁

  • API 키와 Secret은 코드에 직접 입력하지 않고 .env에 저장합니다.

  • .env는 반드시 .gitignore에 추가합니다.

  • 에러가 발생하면 메시지를 생략하지 말고 AI에게 그대로 전달합니다.

  • 기능을 한 번에 모두 요청하기보다 GET → 외부 API → POST → 화면 순서로 나누면 이해하기 쉽습니다.

  • 외부 API 응답에 원하는 정보가 없으면 다른 엔드포인트의 데이터와 조합할 수 있습니다.

  • 테스트 페이지를 만들면 Postman 없이도 버튼으로 API를 시연할 수 있습니다.

  • 현재가격은 계속 변하므로 저장할 때 가격 조회 시각도 함께 기록하는 것이 좋습니다.

앞으로의 계획

이번에는 AI에게 기능을 단계적으로 요청하며 API 서버를 완성했습니다. 다음 목표는 만들어진 결과물을 직접 분석하고, 점차 AI의 도움 없이도 기능을 구현할 수 있는 수준으로 가는 것입니다.

우선 다음 내용을 중심으로 코드를 분석해볼 계획입니다.

  • Express 서버가 요청을 받고 응답하는 흐름

  • 라우트와 엔드포인트가 연결되는 방식

  • .env와 OAuth 인증정보가 사용되는 위치

  • 토스증권 API 응답을 필요한 형태로 가공하는 과정

  • 검색 결과와 관심 종목 데이터를 저장하는 흐름

  • GET과 POST를 구분해 설계한 이유

최종 목표는 바이브 코딩으로 빠르게 결과물을 만드는 데만 의존하는 것이 아니라, AI를 보조 도구로 활용하면서 요구사항을 설계하고 코드를 이해하며 직접 구현할 수 있는 개발자가 되는 것입니다.


도움 받은 글

3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

온어닷 프로필 이미지
온어닷2026.07.30

ㅎㅎㅎ 제가 다른 바이브코딩 강의를 가면 항상 많이 만드시는 예제가 바로 주식, 로또, 사주, 골프인데..... 주제가 너무나 반가웠습니다 =)

처음 저도 api를 접했을 때, 엔드포인트의 개념도 모르고 api에 엔드포인트가 왜 나오지..?하고 생각했는데, 옛 생각이 새록새록 나네요ㅎㅎㅎ

오 근데

API 키와 Secret은 코드에 직접 입력하지 않고 .env에 저장합니다.

<<< 이거 진짜 필수...... 아니면 다 털립니다...ㅠㅠㅠㅠ

ㅎㅎㅎ그리고 결과물이 마음에 드셨는지 궁금한데... 어떻게 나오셨는지 함께 볼 수 있으면 좋겠습니다 =)

유피테르 프로필 이미지
유피테르2026.07.29

필요한 기능을 한 번에 요구하지 않고 GET → 외부 API 연동 → POST → 테스트 화면 순서로 하나씩 확장해 가신 과정이 정말 인상적이었어요. 특히 검색한 종목을 저장할 때 현재 가격뿐 아니라 저장 시각까지 함께 남기도록 설계해, 실제로 다시 활용할 수 있는 흐름을 만든 점이 좋았습니다. .env와 .gitignore로 인증정보를 보호하면서도 버튼으로 직접 확인할 수 있는 테스트 화면까지 완성하신 덕분에 결과물이 훨씬 실용적으로 느껴집니다.

뽀짝이 프로필 이미지
뽀짝이2026.07.24

API 서버와 엔드포인트 개념을 모르는 상태에서 시작해 토스증권 Open API까지 연결하셨네요. 단순 예제가 아니라 실제 외부 API 값을 받아 가공하는 서버를 만들어보고 싶었다는 목표 설정이 처음부터 달랐어요.

시행착오 4가지를 이렇게 구체적으로 기록하신 게 글의 핵심 같아요. 특히 계좌번호와 accountSeq를 혼동한 것, 포트 점유 문제, 랭킹 API에 한글명이 없어서 종목정보 API를 추가 호출한 것 — 이 오류들을 직접 부딪혀 해결한 과정이 코드 이해보다 더 큰 자산이 될 것 같아요.

"바이브 코딩 의존에서 벗어나 직접 구현할 수 있는 개발자"로 가겠다는 다음 목표도 인상적이에요. 코드를 분석하는 방향이 이미 구체적으로 정해져 있으니까요. 고롱고롱… 이런 꼼꼼한 사례글 보면 기분 좋아져요 ✨

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기