API 키: 내 스크립트로 매매일지 읽기

Pro와 Fleet.

TakeJournal API로 내 스크립트, 스프레드시트, 프로그래밍 도구가 매매일지를 읽을 수 있어요. 계좌, 거래 페이지에 보이는 그대로의 거래, 계좌의 체결, 대시보드의 통계와 그룹, 메모가 있는 하루나 한 주. 읽기만 해요. 매매일지를 바꾸거나 브로커에 닿는 일은 없어요.

키 만들기

프로필 → AI와 API → + 새 키: 알아볼 수 있는 이름을 붙이고, 읽을 수 있는 내용과 기간(30일, 90일 또는 365일)을 고른 뒤 키 만들기를 누르세요. 키(tja_…)는 시험용 호출과 함께 한 번만 보여요. 비밀번호 관리자나 스크립트의 비밀 저장소에 보관하세요. TakeJournal은 지문만 보관하므로 잃어버린 키는 다시 보여 줄 수 없어요. 새로 만드세요. 한 번에 최대 10개까지예요.

키가 읽는 내용

모든 키는 계좌, 거래, 체결, 통계를 읽어요. 직접 쓴 내용도 읽어야 하는 키라면 메모, 하루 매매일지, AI 리뷰, Spotter의 메시지를 체크하세요. 체크하지 않으면 모든 응답에서 빠져요.

API 호출하기

키를 Authorization 헤더로 보내세요:

curl -H "Authorization: Bearer tja_…" "https://app.takejournal.com/api/v1/trades?from=2026-10-01"

호출	돌려주는 내용
GET /api/v1/me	요금제, 프로필의 시간대·통화·언어, 키의 범위와 만료, 오늘의 호출
GET /api/v1/accounts	계좌(ID, 별칭(ACC-12), 이름, 번호, 통화, 상태)
GET /api/v1/trades	거래(여러 계좌에 복사된 결정은 한 번으로 셈), 필터와 페이지 지원
GET /api/v1/trades/{id}	거래 하나와 그 매매일지, 각 계좌에서의 거래
GET /api/v1/statistics	대시보드의 통계
GET /api/v1/groups?by=weekday	한두 가지 속성으로 묶은 거래
GET /api/v1/days/{date}, GET /api/v1/weeks/{date}	메모, AI 리뷰, Spotter의 메시지가 있는 하루나 한 주
GET /api/v1/labels	태그, 카테고리, 전략
GET /api/v1/accounts/{id}/fills	계좌의 체결(오래된 순, UTC)

필터는 거래 페이지와 같아요. from과 to는 거래일(YYYY-MM-DD), account는 ID나 별칭, symbols, strategy, tags, account_kind, market. 목록은 쉼표로 구분해요. limit과 offset으로 거래를 페이지 단위로 넘겨요. 호출에 UTC라고 적혀 있지 않으면 시간은 프로필의 시간대예요. 모든 호출의 모든 매개변수는 키 없이 읽을 수 있는 API 설명(OpenAPI)에 있어요.

한도

모든 키 합계: Pro는 분당 60회(그중 통계·그룹 20회), 하루 5,000회, Fleet는 120회, 40회, 10,000회, 동시에 2개. 한도를 넘은 호출은 429와 기다릴 초를 알려 주는 Retry-After를 돌려줘요. 하루는 UTC로 세요. 호출은 AI 답변을 쓰지 않아요. 프로필 → AI와 API에 오늘의 호출이 보여요.

키 취소하기

키 옆의 취소를 누르고 확인하면, 그 키를 쓰는 스크립트는 바로 401을 받아요. 키는 만료될 때도 멈춰요. 요금제에 API가 없어지면, 다시 생길 때까지 키는 403을 돌려줘요. 새로 만들 필요는 없어요.