개발자

AI 어시스턴트, 터미널, 직접 만든 코드에서 포트폴리오를 사용하세요. 모든 기능은 읽기 전용이며 보유한 자산만 다뤄요.

AI 어시스턴트 연결

Claude, ChatGPT, Claude Code, Cursor에 보유 자산을 묻거나, 채팅으로 포지션을 추가하세요.

웹, 데스크톱, 모바일의 모든 Claude 요금제에서 쓸 수 있어요. 무료 요금제에는 커스텀 커넥터 1개가 포함돼요.

  1. 설정 중에 Sonar에 로그인해요. 계정이 없나요? 무료로 만들기.

    서버 URL
    https://sonarfolio.com/api/mcp
  2. Customize를 열고 Connectors를 선택하세요.

    Claude 커넥터 열기(새 탭에서 열림)
  3. + Add, Add custom connector를 차례로 선택하세요. 이름을 Sonar로 하고 서버 URL을 붙여넣으세요.

  4. 물어보면 Sign in now와 Use Claude's published identity를 선택하고, 클라이언트 ID와 시크릿 없이 Add를 선택하세요.

  5. Connect를 선택하고 로그인한 뒤 허용을 선택하세요. 채팅에서 +, Connectors를 차례로 선택해 켜세요.

테스트: 어시스턴트에게 물어보세요
내 포지션 중 가장 큰 다섯 개는 뭐야?

커넥터는 보유한 자산만 볼 수 있어요. 설명한 포지션을 추가할 수는 있지만, 거래하거나 자금을 옮기거나 무언가를 삭제할 수는 없어요.

문제 해결

연결되지 않거나 도구가 보이지 않아요

URL이 /api/mcp로 끝나는지, 로그인이 허용으로 끝났는지 확인하세요. 그래도 안 되면 Sonar를 제거하고 다시 추가하세요.

어시스턴트가 요금제나 크레딧이 필요하다고 해요

요금제에 따라 어시스턴트가 보는 범위가 정해지고, 도구 호출 1번이 요청 1회예요. 요청과 크레딧은 API 및 AI 도구에서 확인하세요.

앱 연결을 해제했거나 키를 폐기했어요

접근이 즉시 중단돼요. 다시 연결하려면 Sonar를 제거하고 다시 추가한 뒤 로그인하세요.

Team 또는 Enterprise 요금제의 Claude를 사용해요

소유자가 서버 URL로 Sonar를 한 번 추가하고, 각 멤버는 자기 계정에 로그인해요.

REST API

Bearer 키를 쓰는 HTTPS 기반 JSON이에요. 모든 엔드포인트에 대응하는 MCP 도구와 CLI 명령이 있어요.

curl https://sonarfolio.com/api/v1/assets \
  -H "Authorization: Bearer YOUR_KEY"
  • GET/api/v1/meMCPget_usageCLIsonar status요금제, 접근 권한, 오늘 사용량Starter
  • GET/api/v1/assetsMCPlist_held_assetsCLIsonar assets보유한 각 자산의 시장 및 소셜 데이터Starter
  • GET/api/v1/assets/{id}MCPget_assetCLIsonar asset <SYMBOL>보유 자산 하나: 시세, 소셜, 상위 크리에이터, 90일 종가Starter
  • GET/api/v1/assets/search?q=MCPsearch_assetsCLIsonar search <QUERY>자산 ID 찾기 (이름만)Starter
  • GET/api/v1/portfolioMCPget_portfolioCLIsonar portfolio합계, 24시간 변동, 손익, 자산 배분, 변동 상위Standard
  • GET/api/v1/holdingsMCPlist_holdingsCLIsonar holdings [--account NAME]계정별 모든 보유 내역Standard
  • POST/api/v1/holdingsMCPadd_positionCLIsonar add <SYMBOL> <QUANTITY> [--cost --date --account]포지션 추가: { asset_id, quantity, cost_usd?, date?, account? }데이터를 기록해요. MCP 클라이언트에는 destructive로 표시되고, CLI는 먼저 확인을 요청해요(--yes로 건너뜀).Starter

응답에는 출처, 타임스탬프, 고지 사항과 함께 X-RateLimit-Limit, -Remaining, -Reset, X-Credits-Remaining 헤더가 들어 있어요. 오류: { error: { code, message } }.

명령줄

같은 키로 터미널과 스크립트에서 같은 데이터를 써요.

설치하고 로그인하기

npm install -g sonarfolio
sonar login

Node 18 이상이 필요해요. sonar login은 API 및 AI 도구에서 받은 키를 저장해요. 스크립트와 CI에서는 대신 SONAR_API_KEY를 설정하세요.

기타 설치 옵션

업데이트하려면 설치를 다시 실행하세요. 설치 없이 써 보기: npx -p sonarfolio sonar status. 이 사이트에서 설치: npm install -g https://sonarfolio.com/cli/latest.tgz. 키는 나만 읽을 수 있는 ~/.config/sonar/config.json에 저장돼요.

명령어

명령은 REST 엔드포인트와 함께 나와 있고, sonar watch [portfolio|assets]로 일일 한도 안에서 실시간 보기를 띄울 수 있어요.

스크립트에서

sonar holdings --json | jq '.holdings[] | {symbol, value_usd}'

모든 명령은 --json을 받아 API의 JSON을 출력해요.

한도와 크레딧

API 호출, MCP 도구 호출, CLI 명령 하나가 각각 요청 1회예요. 일일 한도는 00:00 UTC에 초기화돼요.

요금제포함된 요청범위
FreeAPI 크레딧만가격과 포트폴리오
Starter하루 500회가격, 소셜 데이터, 포지션 추가
Standard하루 1,000회보유 내역, 손익, 자산 배분, 온체인 데이터 추가
Premium하루 2,000회보유 내역, 손익, 자산 배분, 온체인 데이터 추가

엔드포인트 목록의 요금제 이름은 요청이 포함되는 곳을 나타내요. 그 밖에는 모든 요금제에서 API 크레딧으로 결제돼요. $1에 1,000개, 크레딧은 만료되지 않고, 모든 계정은 100개로 시작해요.