페이퍼 트레이딩 봇을 토스증권 Open API에 붙였습니다. 문서만 봐선 안 걸리는 함정 몇 개를 적어둡니다 — launchd나 ffmpeg 함정 메모와 같은 목적입니다.
환율은 baseCurrency / quoteCurrency
exchange-rate 엔드포인트는 흔한 from/to나 pair가 아니라 baseCurrency/quoteCurrency를 받습니다. 이름을 틀리면 조용히 빈 응답이 오지 에러가 안 납니다. 그래서 "환율이 0으로 들어온다"는 증상으로 한참 헤맵니다 — 실제로는 파라미터 이름이 틀린 겁니다.
샌드박스가 없다
모의/샌드박스 환경이 없습니다. 실 자격증명으로 붙되, 주문을 안 내는 read + 페이퍼 로직으로 안전하게 굴려야 합니다. "샌드박스에서 먼저 테스트"가 불가능하니, 드라이런을 코드 쪽에서 강제합니다 — 실주문 경로는 기본적으로 막아두고 명시 플래그가 있을 때만 열리게.
캔들 히스토리는 있다
candles 엔드포인트에 히스토리가 있어 백테스트용 데이터를 API로 받을 수 있습니다. 별도 데이터 소스를 안 붙여도 되는 부분이라, 여기선 문서가 반갑게 틀렸습니다(생각보다 많이 줍니다).
자격증명 보관
~/.config/toss/credentials.env에 두고 레포에는 절대 올리지 않습니다. 실 계좌 API는 유출 리스크가 실금전이라, 페이퍼 단계여도 처음부터 파일 권한과 .gitignore를 확실히 잡아둡니다.
작지만 문서에 안 튀는 것들이라 적어둡니다 — 다음에 붙일 때 같은 데서 안 막히려고.