Nebula CLI
터미널, 스크립트 또는 CI에서 주식, 원자재, 지수, 크립토, AI 전반의 글로벌 시장 인텔리전스를 조회하세요.
설치
CLI를 사용하려면 Node.js 18 이상이 필요합니다.
npm install --global @hiddensystems/nebula-cli
인증
nebula auth login --key YOUR_API_KEY
CLI는 키를 ~/.nebula/config.json에 소유자 전용 권한으로 저장합니다. 자동화에는 NEBULA_API_KEY를 대신 설정하세요.
x402 결제
Nebula 계정이나 API 키 없이 별도의 x402 HTTP API를 통해 Base의 USDC로 적격 API 읽기에 대한 비용을 지불할 수도 있습니다. 각 결제는 지갑에서 승인합니다. MCP와 CLI 연결은 계속 계정 인증과 크레딧을 사용하며, 자동으로 지갑 결제를 수행하지 않습니다. x402 결제 가이드 보기
예제
nebula api list_assets --asset-class equity --query NVIDIA
nebula api get_sentiment
nebula api get_mindshare --asset-id NVDA --asset-class equity
nebula api create_chat_completion --body '{"messages":[{"content":"What changed in NVIDIA sentiment this week?","role":"user"}],"stream":false,"thinking_mode":"auto"}'
엔드포인트 개요
각 CLI 명령은 REST API, MCP, CLI, Nebula Agent와 동일한 작업 단위 가격 책정 및 공유 계정 잔액을 사용합니다.
- 고정 비용 작업은 요청당 명시된 크레딧 수를 소비합니다.
- 파라미터는 작업 비용을 변경하지 않습니다. 단, 해당 행에 특정 가격이 명시된 경우는 예외입니다. 예를 들어 마인드셰어 또는 심리 예측을 refresh=true로 다시 실행하면 5 크레딧 대신 10 크레딧이 부과됩니다. 심리는 클러스터 필터 사용 여부와 관계없이 항상 1 크레딧입니다.
- 행에 따라 더 낮은 수준의 답변에 더 낮은 가격이 명시될 수도 있습니다. 자산이 가질 수 없는 예측(not_forecastable)은 무료이며, 계정당 시간당 최대 30건까지 허용됩니다. 이를 초과하면 해당 시간이 지날 때까지 엔드포인트가 429를 반환합니다. 오류로 끝난 요청은 비용이 발생하지 않습니다.
- Agent 요청은 토큰 볼륨, 모델 비용, 도구 호출을 기반으로 한 변동 가격을 사용합니다. 완료된 응답에는 사용된 크레딧이 보고됩니다.
- 모든 작업은 모든 플랜에서 사용할 수 있습니다. 플랜은 히스토리 기간(Free: 90일, Pro: 각 엔드포인트의 최대치이며 대부분의 시계열은 1년), 속도 제한(Free: 분당 60 요청, Pro: 300), 포함된 월간 크레딧에 따라 다릅니다. 크레딧을 구매하면 사용량을 늘릴 수 있지만 히스토리나 속도 제한은 변경되지 않습니다.
디스커버리
| 명령 | 크레딧 | 설명 |
|---|
nebula api screener |
2 |
스크리너 |
nebula api get_top_momentum |
2 |
상위 모멘텀 |
nebula api get_top_trending |
2 |
상위 트렌딩 |
조회
| 명령 | 크레딧 | 설명 |
|---|
nebula api list_assets |
1 |
텍스트 → 자산 ID |
nebula api search |
1 |
검색 |
nebula api list_subjects |
1 |
텍스트 → 주체 ID |
소셜 & 센티먼트
| 명령 | 크레딧 | 설명 |
|---|
nebula api get_emotions |
1 |
감정 분포 |
nebula api get_mindshare |
2 |
마인드셰어 |
nebula api get_related_subjects |
2 |
관련 주제 |
nebula api get_sentiment |
1 |
센티먼트 |
nebula api get_sentiment_timeframes |
1 |
시간대별 심리 |
nebula api get_social_momentum |
2 |
소셜 모멘텀 |
예측
| 명령 | 크레딧 | 설명 |
|---|
nebula api list_forecast_assets |
1 |
예측 가능 자산 |
nebula api get_mindshare_forecast |
5회(새로 고침 시 10회, not_forecastable이면 무료, 시간당 30회) |
마인드셰어 예측 |
nebula api get_sentiment_forecast |
5회(새로 고침 시 10회, not_forecastable이면 무료, 시간당 30회) |
심리 예측 |
시장 센티먼트
| 명령 | 크레딧 | 설명 |
|---|
nebula api get_calls |
2 |
롱/숏 콜 |
nebula api get_call_returns |
2 |
콜 결과 분포 |
nebula api get_conviction_index |
2 |
확신 지수 |
nebula api get_fear_greed_index |
1 |
공포와 탐욕 지수 |
nebula api get_price_levels |
2 |
소셜 언급 가격대 |
nebula api get_social_volume_index |
2 |
소셜 대비 거래량 |
nebula api get_social_volume_profile |
2 |
소셜 거래량 프로필 |
시장 데이터
| 명령 | 크레딧 | 설명 |
|---|
nebula api get_price_history |
1 |
가격 이력 |
인텔리전스
| 명령 | 크레딧 | 설명 |
|---|
nebula api list_calendar_events |
5 |
캘린더 이벤트 |
nebula api list_insights |
5 |
인텔리전스 |
nebula api get_insight_attention |
5 |
인사이트 주목도 |
클러스터
| 명령 | 크레딧 | 설명 |
|---|
nebula api list_clusters |
2 |
작성자 클러스터 |
nebula api compare_clusters |
2 |
클러스터 비교 |
nebula api get_divisive_assets |
2 |
논쟁적인 자산 |
nebula api compare_hype_cycles |
2 |
하이프 사이클 도달 |
nebula api compare_cluster_traits |
2 |
클러스터 특성 비교 |
nebula api get_cluster_hype_cycles |
2 |
클러스터 하이프 사이클 |
nebula api get_cluster_overlap |
2 |
클러스터 중첩 |
nebula api get_cluster_profile |
2 |
클러스터 프로필 |
nebula api get_cluster_rotation |
2 |
클러스터 로테이션 |
nebula api get_cluster_stances |
2 |
클러스터 입장 |
Agent
| 명령 | 크레딧 | 설명 |
|---|
nebula api create_chat_completion |
변수 |
Nebula Agent 채팅 완성 |
Account
| 명령 | 크레딧 | 설명 |
|---|
nebula api get_account |
0 |
Account |
생성된 명령
경로, 메서드, 도움말 텍스트, 기본값, 선택자 제약 조건, 요청 스키마, 유효성 검사는 모두 OpenAPI에서 직접 가져옵니다.
nebula api compare_cluster_traits | 클러스터 특성 비교 |
|---|
nebula api compare_clusters | 클러스터 비교 |
|---|
nebula api compare_hype_cycles | 하이프 사이클 도달 |
|---|
nebula api create_chat_completion | Nebula Agent 채팅 완성 |
|---|
nebula api get_account | Account |
|---|
nebula api get_call_returns | 콜 결과 분포 |
|---|
nebula api get_calls | 롱/숏 콜 |
|---|
nebula api get_cluster_hype_cycles | 클러스터 하이프 사이클 |
|---|
nebula api get_cluster_overlap | 클러스터 중첩 |
|---|
nebula api get_cluster_profile | 클러스터 프로필 |
|---|
nebula api get_cluster_rotation | 클러스터 로테이션 |
|---|
nebula api get_cluster_stances | 클러스터 입장 |
|---|
nebula api get_conviction_index | 확신 지수 |
|---|
nebula api get_divisive_assets | 논쟁적인 자산 |
|---|
nebula api get_emotions | 감정 분포 |
|---|
nebula api get_fear_greed_index | 공포와 탐욕 지수 |
|---|
nebula api get_insight_attention | 인사이트 주목도 |
|---|
nebula api get_mindshare | 마인드셰어 |
|---|
nebula api get_mindshare_forecast | 마인드셰어 예측 |
|---|
nebula api get_price_history | 가격 이력 |
|---|
nebula api get_price_levels | 소셜 언급 가격대 |
|---|
nebula api get_related_subjects | 관련 주제 |
|---|
nebula api get_sentiment | 센티먼트 |
|---|
nebula api get_sentiment_forecast | 심리 예측 |
|---|
nebula api get_sentiment_timeframes | 시간대별 심리 |
|---|
nebula api get_social_momentum | 소셜 모멘텀 |
|---|
nebula api get_social_volume_index | 소셜 대비 거래량 |
|---|
nebula api get_social_volume_profile | 소셜 거래량 프로필 |
|---|
nebula api get_top_momentum | 상위 모멘텀 |
|---|
nebula api get_top_trending | 상위 트렌딩 |
|---|
nebula api list_assets | 텍스트 → 자산 ID |
|---|
nebula api list_calendar_events | 캘린더 이벤트 |
|---|
nebula api list_clusters | 작성자 클러스터 |
|---|
nebula api list_forecast_assets | 예측 가능 자산 |
|---|
nebula api list_insights | 인텔리전스 |
|---|
nebula api list_subjects | 텍스트 → 주체 ID |
|---|
nebula api screener | 스크리너 |
|---|
nebula api search | 검색 |
|---|
JSON 및 코딩 에이전트
기계 판독 가능한 출력을 위해 --json를 추가하세요. nebula api <operation_id> --help를 실행하면 모든 작업의 생성된 파라미터를 확인할 수 있습니다.
MCP 도우미
nebula mcp를 실행하면 MCP 클라이언트 구성을 출력합니다. 설정 세부 정보는 MCP 문서를 참조하세요.
CI 및 자동화
시크릿 관리자에 NEBULA_API_KEY를 설정하고 구조화된 출력에는 --json를 사용하세요. NEBULA_API_BASE_URL는 개발 또는 자체 호스팅 API에만 사용하세요.