"CryptoFolio" V2 공개 - 구글 스프레드시트에 코인원 등 각종 API 활용한 포트폴리오
CryptoFolio v2
구글 스프레드시트에 코인원 등 각종 API 활용한 포트폴리오
사용예시
- 배포용 문서 링크: https://docs.google.com/spreadsheets/d/1kSeY6dsymsSf8MF3zGHH5bwmNHO0O7lUWkVjWXnzUog/edit?usp=sharing
사용방법
1. 배포용 스프레드시트를 본인의 구글 드라이브로 복제합니다. (파일 - 사본만들기...)
링크주소: https://docs.google.com/spreadsheets/d/1kSeY6dsymsSf8MF3zGHH5bwmNHO0O7lUWkVjWXnzUog/edit?usp=sharing
주의! 반드시 [사본만들기]를 해주세요. 공유요청하시면 안됩니다.
2. 시트별 설명을 확인하고, 포트폴리오를 구성하세요.
- Dashboard: 포트폴리오 전반이 정리되어 한 화면에 표시됩니다.
- Data: 개별 자산에 대한 목록을 데이터로 입력하는 시트입니다.
- Future: Earning의 값을 근거로 미래의 자산을 예측해볼 수 있습니다.
- Ticker: 종목별 가격을 지정하고, 자산의 성격을 정합니다.
- var: 각종 변수를 관리합니다.
- **(Exchange)TickerAPI: 거래소별 티커 API를 받아오는 시트
시트별 상세 설명
Dashboard
Dashboard는 최종 디스플레이되는 시트입니다.
여기 표시되는 값은 모두 [Data]의 값을 계산하여 표시하게 되어있기 때문에, 임의로 편집하면 안됩니다. 사용자가 할 수 있는 부분은 'unique' 함수로 인해 값을 자동으로 표시할 행이 부족할 경우 늘려주거나, 불필요한 행을 지워주는 정도의 액션만 취할 수 있습니다.
이 화면에서 확인 가능한 내용은 다음과 같습니다.
- 투자주체별 지분율 및 평가금액
- 미래 수익에 대한 예상 금액
- 자산의 회수가능 시간에 대한 종합적 표시
- 포트폴리오 종류별(봇, 트레이딩, 펀딩, 지갑 등) 평가금액 및 지분율
- 봇 트레이더를 위한 봇의 지분율 중 봇별 지분율 및 평가금액
- 자산의 큰 분류에 따른 지분율 및 평가금액
- 종목별 지분율 및 평가금액
Data
종목별/포트폴리오별 잔고(수량) 값을 기록해두는 데이터베이스 테이블입니다.
(시세 값은 [Ticker] 시트에서 받아오게 되기 때문에 시세는 별도로 건들지 말기 바랍니다.)
각 행은 하나의 포트폴리오의 종목을 의미하며, 여러 설정 값을 지니게 됩니다.
- Name: 자산에 대한 이름으로 자동입력됨
- Holder: 자산에 대한 홀더 비중별 표시(홀더는 총 A, B, C 3개를 지원합니다.)
- PotfolioType: 포트폴리오 타입(봇, 거래, 펀딩, 지갑 등 - 변수 시트 [var]에서 관리)
- CurrencyType: 자산에 대한 성격을 규정함 - 크립토인지 피아트인지, 스테이블인지
- Currency: BTC, KRW, ETH 등 고유 심볼을 적음. 해당 심볼은 [Ticker] 시트와 일치하는 것을 사용해야함
- ServiceName: 거래소 등 서비스명
- Account: 계정명(여러 계정을 이용하는 경우 구분할 수 있게)
- Time-tire: 회수가능 시간, 드롭다운을 클릭해 선택(값 변경은 [var]에서)
- Link1,2, Address, Add-Contract/Tag/Memo, Variable1,2: 지갑주소 메모 또는 수식에 활용하는 정량적인 칸(API활용)
- Note, Action: 정성적인 메모 칸수량
- APR %: 년 수익률 기재. Earning 계산에 사용함
- period: 기간제 락업물 진입시 사용, 날짜수로 입력(예를들면 15%에 30일짜리 락업물이면, APR %에 15%, period에 30 입력)
- Limit: 플랙서블 포트폴리오에 개수 제한이 있는경우 메모 용도로 입력. 예를 들어 A서비스에서 USDT 플랙서블에는 5만개 제한이면, 5만을 입력함. 계산에 적용하지 않음. 자산배분에 있어 수익이 누락되지 않게하려고 만든 칸
- Amount: 자산의 수량 입력. 배포용 샘플에 자동으로 받아오는 수식이 있는 경우 노트에 적힌 설명 참고.
- Price ₩: 원 단위 가격([Ticker] 시트에서 커런시 값을 통해 자동 받아옴, KRW, BTC값이 존재)
- ₩: 원 단위 평가금액
- BTC: BTC 단위 평가금액
- EPS ₩, EPD ₩, EPM ₩, EPY ₩: 원 단위 초(sec.), 일(day), 월(monthly), 년(year) 당 예상 수익(APR과 period 값으로 자동 계산됨)
- 이후 A, B, C 포트폴리오 홀더별 Share %와 나머지 동일한 값이 계산됨
(최종적으로 모든 포트폴리오 행 별 합산된 지분율/평가금액으로 최종 투자주체별 지분율이 계산되며 해당 값은 [Dashboard] 시트의 최상단에 표시됩니다.)
API 활용 안내
*잔고 등의 값은 직접 입력하거나 API로 받아와서 표시할 수 있습니다. 본 배포용 문서에서는 직접 제작한 CoinoneBalance.gs 스크립트를 통해 코인원 API로 잔고를 불러올 수 있습니다.
[도구 - 스크립트 편집기] 에서 스크립트 편집기로 이동한 다음, '이곳에 엑세스토큰, 시크릿키를 붙여넣으세요' 부분에 코인원 API(V2)값을 붙여넣으면, 자동으로 각 코인별 잔고를 받아올 수 있습니다.
CoinoneBalance.gs 스크립트 관련 안내사항
- 코인원에서 API를 만드실 때 반드시 개인용 API V2로 만드시고, 잔고 확인 기능만 체크하시기 바랍니다.
- 본 스크립트는 개발자 지인의 도움을 받아 제작한 코드이며 자유롭게 활용할 수 있습니다. 단 꼭 이 문서에 Upvote를 해주시고 활용하시기 바랍니다.
그 외 본 문서에서는 ImportJson.gs 라는 스크립트를 활용하고 있는데, json 으로 불러올 수 있는 API 결과값을 쉽게 얻어올 수 있습니다. 해당 수식 내용은 [Ticker] 시트의 코인별 시세 수식을 참고하시면 이해하시기 쉽습니다.
(ImportJson.gs 스크립트는 구글 시트(Google Sheet)로 가상화폐(비트코인/이더리움/리플) 관리 https://medium.com/@sgwanlee/구글-시트-google-sheet-로-가상화폐-비트코인-이더리움-리플-관리-95b0038de4d8 에서 가져왔습니다.)
Ticker
Ticker는 [Data] 시트에서 활용하는 암호화폐별 시세를 관리하는 시트입니다.
또한, 이 시트에서 [Dashboard]에 표시될 암호화폐를 디스플레이 값을 통해 지정할 수 있습니다.
포트폴리오로 관리하고자하는 암호화폐가 추가되거나, 기준시세를 다른 거래소로 쓸려면 이 시트에서 수정하면 됩니다.
앞서 설명한대로, ImportJson를 활용하면 API로 시세를 쉽게 받아올 수 있을것입니다.
암호화폐별로 Display열에 1을 입력하면 [Dashboard] 시트의 커런시 항목에 표시됩니다. 디스플레이되지 않는 암호화폐는 [Dashboard] 시트 최하단의 Other로 모아서 표시되게 됩니다.
사용 TIP
- 회사 급여와 퇴직금도 데이터 시트에 포함되어 있습니다. 노트에 적힌 내용을 참고해 내가 매 순간 얼마나 벌고 있는지, 퇴직금은 실시간으로 얼마나 쌓이고 있는지 확인해보세요.
- ETH DeFi가 핫하죠. 데이터 시트에 ETH 지갑과 ERC까지 준비해뒀습니다. ETH 주소와 ERC20 토큰 주소, 변수1에 Decimals을 입력하면 자동으로 자산을 받아와 표시해줍니다. 다만, API 콜 수 제한이 있으므로 이더스캔에 가입해 API 키를 발급받아 더 자유롭게 사용하시기 바랍니다. (해당 자산 칸에 적어둔 노트를 참고하세요)
- 코인원 자산을 실시간으로 받아오게 API를 잘 만들어뒀으니 이용해보시기 바랍니다. 혹시 가입하지 않았다면 해당 자산의 링크1에 제 레퍼럴 코드가 있으니 거래 많이해서 저한테 수수료 일부를 나눔 부탁드립니다. 참고로 레퍼럴로 가입하시면 그냥 가입하시는것보다 리워드 혜택이 있습니다.
- 채권과 채무도 예시로 넣어뒀습니다. 마이너스 자산을 다양하게 활용해보세요.
- 지분을 섞은 포트폴리오도 만들 수 있습니다. 홀더별 지분을 섞은 자산도 예제로 넣어뒀으니 참고하시기 바랍니다.
- 국내주식가 미국주식도 추가할 수 있게 해 만들었으니 잘 활용해보세요.
장점 및 단점
장점
- 다양한 서비스나 블록체인상의 포트폴리오를 한 곳에 모아서 확인할 수 있다는 점에서 매우 혁신적인 잔고 관리 방법이 될 수 있습니다.
- 관심있는 암호화폐의 시세를 수시로 한번에 확인할 수 있어 편리합니다.
- 여러 투자주체의 자본(ex: 본인 돈, 배우자의 돈, 가족의 공금 등)을 끌어다 같이 운용중이라면 투자주체별 지분 관리가 가능해서 좋습니다. 최대 3개까지 지원합니다.
- 로그인하지 않고도 잔고를 확인할 수 있습니다.(현재 코인원 거래소만 지원)
- 개인 지갑의 잔고도 API로 받아올 수 있습니다.(현재 비트코인, 이더리움만 지원) 공개된 시트에는 API 키가 누락되어 있으므로, API 콜 수의 제한이 있습니다. ETH는 이더스캔에서 쉽게 API키를 발급받아 API 콜 수를 늘려 쓸 수 있습니다. BTC는 블록체인info의 API 키 발급받는 절차가 다소 복잡하니 참고바랍니다.
단점
- 제대로 활용하려면 API에 대한 기본 지식이 필요하고, 세팅하는게 시간이 꽤 소모됩니다.
- 포트폴리오가 복잡해질수록 로딩이 길어질 수 있습니다.
- 공유 링크가 털리면 잔고를 외부사람이 볼 가능성이 있습니다.(따라서 절대 개인정보를 문서상에 입력하지 마세요)
이 문서는 암호화폐를 다년간 관리하면서 필요에 의해 제작한 문서이며, 노력의 산물입니다.
부디 잘 활용해주시고 많은 Upvote 부탁드립니다.
*배포용 포트폴리오에 포함된 자산은 제 돈이 아니고 가상의 돈과 유명한 주소에서 따온 자산입니다.
감사합니다.