MINARA
참조

HTTP API

게이트웨이(`npm run serve`)가 노출하는 모든 라우트

HTTP 게이트웨이(npm run serve)는 REST/SSE API를 통해 동일한 Agent를 노출합니다. 인증이 필요 없는 /healthz 활성 상태 프로브를 제외한 모든 라우트는 버전 접두사 /v1/... 아래에 위치합니다.

인증

환경에 GATEWAY_AUTH_TOKEN을 설정하면 모든 /v1/... 라우트에 Bearer 토큰이 필요합니다. 설정하지 않으면 게이트웨이는 모든 요청을 수락합니다. (로컬 개발 환경에서만 사용하십시오.)

Authorization: Bearer <GATEWAY_AUTH_TOKEN>

상태 확인

메서드경로설명
GET/healthz활성 상태 프로브. 게이트웨이가 실행 중이면 200과 \{"ok": true\}를 반환합니다.
GET/v1/healthz/healthz의 버전 미러. 인증 없이 \{"ok": true, "ts": ...\}를 반환합니다.

채팅

메서드경로설명
POST/v1/chat/streamAgent 턴을 시작하고 즉시 세션 id를 반환합니다. 턴은 비동기로 실행됩니다.
POST/v1/assist/system-promptWeb UI 마법사의 AI로 생성 패널에 사용할 Custom Agent 시스템 프롬프트를 스트리밍합니다.
POST/v1/chat/interject세션에서 진행 중인 턴에 조종 메시지를 큐에 추가합니다. 게이트웨이가 이를 주입합니다.
POST/v1/chat/interrupt세션에서 진행 중인 턴을 중지합니다. 턴은 정상적으로 종료되며, 부분 작업은 보존됩니다.
GET/v1/chat/recommendation세션별 기능 추천 스토어에서 카드를 롱 폴링합니다.
GET/v1/chat/sessions/:id/goal세션의 상시 목표를 반환합니다. 설정된 목표가 없으면 null을 반환합니다.
POST/v1/chat/sessions/:id/goal세션에 상시 목표를 설정합니다. 이미 활성 목표가 있으면 400으로 거부됩니다.
POST/v1/chat/sessions/:id/goal/pause상시 목표의 연속 실행을 일시 중지합니다. 수동 턴은 계속 작동하며, 목표는 재개할 수 있습니다.
POST/v1/chat/sessions/:id/goal/resume일시 중지된 목표를 재개합니다. 턴 예산을 초기화하여 목표가 새로운 턴으로 실행됩니다.
POST/v1/chat/sessions/:id/goal/clear상시 목표를 지웁니다. 이 작업은 취소 불가능하며 목표가 완전히 삭제됩니다.
POST/v1/chat/sessions/:id/goal/subgoals상시 목표에 수락 기준을 추가합니다. 판정자와 다음 턴 계획에 반영됩니다.
DELETE/v1/chat/sessions/:id/goal/subgoals/:nn번째 위치(1부터 시작)의 수락 기준을 삭제합니다. 유효하지 않은 위치면 400으로 거부됩니다.

채팅 세션

메서드경로설명
GET/v1/sessions/:parentId/subagent-runs/:childSessionId동기식 subagent 위임 하나에 대한 접힌 대화 기록을 반환합니다.
GET/v1/sessions사용자의 채팅 세션 목록을 최근 활동 타임스탬프 및 메시지 수와 함께 반환합니다.
GET/v1/sessions/search모든 세션의 메시지 내용을 검색합니다. 최적 일치 순으로 정렬됩니다. (SQLite FTS5, bm25)
POST/v1/sessions새 세션 id를 생성합니다. Agent 루프는 세션별로 상태를 범위 지정합니다.
GET/v1/sessions/:id기본 히스토리 읽기 엔드포인트입니다. 세션 메타데이터와 모든 영속 메시지를 반환합니다.
DELETE/v1/sessions/:id세션과 모든 메시지, 디스크 상의 세션 워크스페이스를 삭제합니다.
PATCH/v1/sessions/:id세션 제목을 설정합니다. 수동 이름 변경은 백그라운드 LLM 생성 이름보다 우선합니다.
GET/v1/institution/sessions/:sessionId/pipeline세션 소유 파이프라인, 최신 실행 스냅샷 폴백, 또는 기본값을 반환합니다.
PUT/v1/institution/sessions/:sessionId/pipeline낙관적 리비전 관리를 사용하여 세션 소유 파이프라인을 검증하고 저장합니다.
GET/v1/institution/sessions/:sessionId/runs시간 순서대로 변경 불가한 라운드테이블 스냅샷, 최종 결과, 리포트를 반환합니다.

상태 및 제어

메서드경로설명
GET/v1/status킬 스위치 상태, 일일 지출, 도구 수, 리뷰 엔진 상태를 반환합니다.
GET/v1/system-metrics대시보드 시스템 상태 행을 위한 프로세스 및 시스템 스냅샷입니다. CPU 사용률, 메모리 등을 포함합니다.
GET/v1/dashboard/achievements웹 UI 대시보드 배너용 통계를 반환합니다. 활성화 타임스탬프, 주요 지표 등을 포함합니다.
GET/v1/portfolioMinara 백엔드에서 현재 포트폴리오 스냅샷을 가져와 Agent 소비용으로 포맷합니다.
GET/v1/methodologies등록된 방법론 목록과 성공/실패 횟수, 최근 결과를 반환합니다.
GET/v1/learning/audit/reports방법론 감사 상태 리포트의 트렌드 및 히스토리를 반환합니다. days 쿼리 파라미터로 기간을 지정합니다. (기본값 30)
GET/v1/learning/audit/reports/latest가장 최근의 방법론 감사 리포트 전체를 반환합니다. 종합 상태 점수, 일별 세부 정보를 포함합니다.
GET/v1/learning/audit/reports/:passIdpass id로 조회한 방법론 감사 리포트 하나를 전체 반환합니다.
POST/v1/learning/audit/run감사 패스를 온디맨드로 실행하고 영속화합니다. 선택적 본문 \{ windowDays \}로 기간을 지정합니다.
POST/v1/kill/v1/unkill이 호출될 때까지 등급 2 이상의 모든 도구 호출을 차단합니다. 비상 상황을 위한 기능입니다.
POST/v1/unkill킬 스위치 플래그를 해제합니다.
POST/v1/interactions/:id/answerAgent가 턴 중간에 제기한 보류 중인 질문을 해결합니다. 질문은 WS를 통해 도달합니다.

포트폴리오

메서드경로설명
GET/v1/portfolio/statusMinara 인증 여부와 접근 가능한 거래소를 빠르게 확인합니다.
GET/v1/portfolio/spot연결된 모든 지갑의 현물 잔고를 게이트웨이 기준으로 집계합니다.
GET/v1/portfolio/spot/snapshot인증된 Minara PnL 요청 한 번으로 스테이블 자산 잔고와 비스테이블 자산 포지션을 가져와 첫 화면의 중복 요청을 방지합니다.
GET/v1/portfolio/spot/positions알려진 경우 평균 취득 단가를 포함한 자산별 현물 포지션을 반환합니다.
GET/v1/portfolio/perpsMinara의 모든 무기한 선물 서브 계정에서 오픈 퍼프 포지션을 반환합니다. ?subAccountId=로 필터링할 수 있습니다.
GET/v1/portfolio/perps/summary무기한 선물 서브 계정 전체의 자산, 마진, 미실현 PnL을 집계합니다.
GET/v1/portfolio/history차트 표시를 위해 버킷으로 나눈 포트폴리오 총 가치의 시계열을 반환합니다.
GET/v1/portfolio/spot/activity사용자의 기본 지갑에 대한 크로스체인 현물 활동 피드(스왑 + 전송)를 반환합니다.
GET/v1/tx/status트랜잭션 id로 단일 트랜잭션의 온체인 상태를 폴링합니다. Minara를 래핑합니다.

무기한 선물

메서드경로설명
GET/v1/perps/account-stateHyperliquid 서브 계정 하나의 실시간 상태입니다. 자산, 마진 사용량, 출금 가능 금액, 오픈 주문을 포함합니다.
GET/v1/perps/sub-accounts사용자의 Minara 무기한 선물 지갑 아래 모든 무기한 선물 서브 계정을 다중 거래소 정보와 함께 반환합니다.
GET/v1/perp-wallets/v1/perps/sub-accounts와 동일한 핸들러입니다. 상위 OpenAPI 경로에 맞춰 정렬되었습니다.
POST/v1/perp-wallets하나의 거래소(hyperliquid | lighter)에 바인딩된 새 무기한 선물 서브 계정을 생성합니다.
POST/v1/perps/sub-accountsPOST /v1/perp-wallets의 Agent 네이티브 별칭입니다. 동일한 본문과 응답 형식을 사용합니다.
POST/v1/perp-wallets/rename기존 무기한 선물 서브 계정 이름을 변경합니다. 본문: \{ subAccountId: string, name: string \}
POST/v1/perps/sub-accounts/renamePOST /v1/perp-wallets/rename의 Agent 네이티브 별칭입니다.
POST/v1/trading-gateway/place-orders서브 계정에 바인딩된 거래소에 퍼프 주문을 일괄 제출합니다.
POST/v1/trading-gateway/cancel-orders\{ symbol, orderId \}로 주문을 일괄 취소합니다. 본문: \{ cancels: \{ symbol: string, order... \} \}
POST/v1/trading-gateway/modify-order활성 주문의 가격, 수량 또는 트리거 가격을 수정합니다. 본문: \{ symbol: str... \}
POST/v1/trading-gateway/update-leverage한 번의 라운드트립으로 레버리지와 마진 모드(교차 vs 격리)를 변경합니다.
POST/v1/trading-gateway/update-isolated-margin기존 포지션의 격리 마진 금액을 조정합니다. 본문: \{ symbol: stri... \}
POST/v1/trading-gateway/withdraw외부 주소로 USDC를 출금합니다. 본문: \{ amount: string, toAddress: string... \}
GET/v1/trading-gateway/summary단일 서브 월렛의 자산, 오픈 포지션, 오픈 주문을 한 번에 읽습니다.
GET/v1/wallet/deposits현물 및 퍼프 입금 주소를 하나의 응답으로 반환합니다.
GET/v1/wallet/supported-chains상위 Minara /tokens/supported-chains 엔드포인트의 프록시입니다. 지원 체인 목록을 반환합니다.
POST/v1/wallet/withdraw/spot크로스체인 현물 출금을 미리 보기(confirm: false) 하거나 실행(confirm: true)합니다.
POST/v1/wallet/withdraw/perps퍼프 USDC/Arbitrum 출금을 미리 보기(confirm: false) 하거나 실행(confirm: true)합니다.
GET/v1/wallet/withdrawals/{operationId}출금 작업의 최신 상태를 조회합니다. 최신 \{operation... \}을 반환합니다.
GET/v1/perps/trades서브 월렛 하나에 대한 Hyperliquid 체결 내역을 실시간으로 반환합니다.
GET/v1/perps/funding퍼프 포지션별로 수령 및 지불한 펀딩 비율을 반환합니다.
GET/v1/perps/transfers지갑 범위의 Hyperliquid 입금, 출금 및 계정 이체 내역을 반환합니다.
GET/v1/perps/order-history최근 체결 및 취소된 주문을 반환합니다.
GET/v1/perps/lighter-pnlLighter 서브 월렛의 롤링 실현 PnL을 Lighter의 전용 API에서 가져옵니다.
GET/v1/orders무기한 주문 또는 source=spot으로 현물 조건부 주문을 반환합니다.
POST/v1/perps/transfer한 무기한 선물 서브 계정에서 다른 서브 계정으로 유휴 USDC를 이동합니다. USDC 전용입니다. 자금 이동 작업으로 미리 보기가 필요합니다.
GET/v1/perps/sub-account/:subAccountId/idle-usdc무기한 선물 서브 계정의 이전 가능한 유휴 USDC 금액 하나를 반환합니다.

Autopilot

메서드경로설명
GET/v1/autopilot/managed/catalog피커가 제공할 수 있는 완전 관리형 전략 유형 목록을 반환합니다.
GET/v1/autopilot/managed/catalog/:strategyType/backtest완전 관리형 전략 유형 하나에 대한 백테스트 미리 보기를 반환합니다. (자산 곡선 + 주요 통계)
GET/v1/autopilot/managed/strategies바인딩된 서브 계정과 정규화된 상태를 포함한 모든 관리형 전략을 반환합니다.
GET/v1/autopilot/managed/aggregated-summary/autopilot KPI 바와 대시보드 관리형 섹션이 공유하는 단일 집계 소스입니다.
GET/v1/autopilot/managed/xstrategy/deployments사용자의 라이브 XStrategy 배포 목록(모든 상태)을 반환합니다.
GET/v1/autopilot/managed/xstrategy/backtest/:backtestId배포에 대한 전체 다중 자산 백테스트 리포트를 반환합니다. /curves를 추가하면 자산 곡선도 포함됩니다.
GET/v1/autopilot/managed/by-sub-account/:subAccountId세부 패널이 사용하는 서브 계정별 스냅샷을 반환합니다. 바인딩된 전략(또는 null)을 포함합니다.
POST/v1/autopilot/managed/strategies서브 월렛에 관리형 전략을 생성합니다. 자금 이동 작업입니다. confirm을 생략하거나 false로 전달하면 미리 보기가 반환됩니다.
POST/v1/autopilot/managed/run다른 소스의 전략을 Autopilot으로 실행합니다. marketplace는 공개 전략을 구독합니다.
POST/v1/autopilot/managed/:strategyId/disable실행 중인 관리형 전략을 중지합니다. 자금에 영향을 주는 작업으로 동일한 미리 보기 흐름을 따릅니다.
POST/v1/autopilot/managed/xstrategy/:strategyId/stop사용자가 작성한 라이브 XStrategy 배포를 중지합니다. Autopilot이 이를 함께 표시합니다.
POST/v1/autopilot/managed/xstrategy/:strategyId/deploy기존 배포를 복제하여 선택한 서브 월렛에 XStrategy를 배포합니다.

시장 데이터

메서드경로설명
GET/v1/quote/batch한 번의 라운드트립으로 여러 티커의 현물/퍼프 시세를 반환합니다. 티커 보드에서 사용됩니다.
GET/v1/quote/:ticker현물 가격, 24시간 변동률, 전통 지표(P/E, EPS, 배당 수익률, 52주 범위)를 반환합니다.
GET/v1/quote/crypto/:symbol암호화폐 하나의 시가총액, FDV, 24시간 거래량(USD), 24시간 % 변동, 이름, 로고, 체인을 반환합니다.
GET/v1/market/candles하나의 티커와 인터벌에 대한 OHLC 바를 반환합니다. 적절한 제공자(Hyperliquid 등)로 라우팅됩니다.
GET/v1/market/perps-priceHyperliquid 또는 Lighter의 무기한 선물 시장 현재 가격과 거래소별 시장 식별자를 반환합니다.
GET/v1/market/sparkline웹 UI의 인라인 스파크라인 렌더링을 위한 종가 전용 압축 시계열을 반환합니다.
GET/v1/market/trendingWorkbench 자산 전환기에 사용할 정규화된 인기 암호화폐 및 주식 항목을 반환합니다.
GET/v1/market/search암호화폐, 주식, ETF, 상품, 외환에 걸쳐 티커 심볼과 이름을 퍼지 매칭으로 검색합니다.
GET/v1/markets/movers시장 개요 보드의 최대 변동 종목을 반환합니다. class=stocks(기본값)는 주식 데이터를 반환합니다.
GET/v1/markets/snapshot한 번의 호출로 시장 개요 보드의 거시 경제 번들을 반환합니다. 주요 지수 시세 등을 포함합니다.
GET/v1/markets/sectors보드의 히트맵을 위한 GICS 11개 섹터의 일별 성과를 반환합니다.
GET/v1/markets/newsYahoo Finance의 키 없는 RSS에서 파싱한 시장 헤드라인 피드를 반환합니다.
GET/v1/markets/calendarNasdaq의 키 없는 캘린더에서 다음 세션의 실적 발표 일정을 반환합니다.

음성

메서드경로설명
GET/v1/voice/status음성 서비스 구성 여부를 반환합니다. stt_configured(전사 제공자)를 포함합니다.
GET/v1/voice/voices음성 선택기 옵션 목록을 반환합니다. 공식 프리셋 음성(ElevenLabs + OpenAI, 항상 표시)을 포함합니다.
GET/v1/voice/settings현재 사용자가 조정할 수 있는 음성 합성 설정을 반환합니다. provider=openai를 전달하면 해당 음성 설정을 반환합니다.
PUT/v1/voice/settings사용자가 조정한 음성 합성 설정을 저장합니다. provider=openai 또는 다른 제공자를 전달합니다.
POST/v1/voice/cleanup채팅 메시지에 저장된 음성 오디오(음성 응답 + 마이크 녹음)를 삭제합니다.
POST/v1/voice/transcribe설정된 음성 제공자(ElevenLabs 등)를 통해 업로드된 오디오 녹음을 전사합니다.
POST/v1/voice/tts최대 4096자의 텍스트에 대한 합성 음성을 스트리밍합니다. 제공자 본문이 파이프됩니다.
POST/v1/sessions/:id/voice-audio이전에 업로드한 오디오 파일(POST /v1/files)을 assistant 메시지에 첨부합니다.

이미지 및 동영상

메서드경로설명
GET/v1/media/settingsFal.ai 연결 상태와 독립적으로 선택된 이미지 및 동영상 모델을 반환합니다.
PUT/v1/media/settingsFal.ai 인증 방법 또는 기본 이미지 및 동영상 엔드포인트를 선택합니다.
GET/v1/media/models하나의 출력 모달리티에 대한 활성 Fal.ai 엔드포인트를 나열합니다. 동적으로 추론된 정보를 포함합니다.
POST/v1/media/models/refresh하나 또는 두 출력 모달리티의 5분 카탈로그 캐시를 우회합니다.
GET/v1/media/models/schema해결된 OpenAPI 입출력 스키마, 필드 순서, 추론된 정보를 반환합니다.
POST/v1/media/providers/fal/oauth/initFal.ai 디바이스 플로우를 시작하고 사용자 코드와 인증 URL을 반환합니다.
GET/v1/media/providers/fal/oauth/poll디바이스 플로우를 폴링합니다. 성공 응답 시 갱신 가능한 OAuth 자격 증명을 저장합니다.
POST/v1/media/providers/fal/api-keyFal.ai API 키를 검증하고 구조화된 자격 증명 저장소에 저장합니다.
DELETE/v1/media/providers/fal/auth/:kind저장된 Fal.ai 로그인 프로필 또는 API 키 재정의를 삭제합니다. 다른 인증 방법은 유지됩니다.

파일 및 아티팩트

메서드경로설명
POST/v1/files샌드박스 워크스페이스에 파일을 업로드합니다. 이후 참조할 수 있는 키를 반환합니다.
GET/v1/files/:key이전에 업로드한 샌드박스 파일을 호출자에게 스트리밍합니다.
GET/v1/artifacts/:idid로 Agent가 생성한 아티팩트(차트, 스프레드시트, 리포트 페이로드)를 가져옵니다.
GET/v1/artifacts웹 UI 파일 페이지용으로 완료된 리포트 아티팩트를 나열합니다. kind=ch...로 필터링할 수 있습니다.
DELETE/v1/artifacts1개에서 200개까지의 아카이브된 리포트 아티팩트와 파일을 영구 삭제합니다.
GET/v1/sandbox/files/:nameAgent가 세션별 샌드박스에 작성한 파일을 읽습니다. 샌드박스 외부로 탈출할 수 없습니다.

워크스페이스 파일

메서드경로설명
GET/v1/workspace/files크기, mtime, sha256을 포함한 편집 가능한 모든 워크스페이스 md 파일을 열거합니다.
GET/v1/workspace/files/:name단일 워크스페이스 md 파일의 내용과 sha256을 반환합니다.
PUT/v1/workspace/files/:name워크스페이스 md 파일을 원자적으로 교체합니다. expected_sha256이 필수입니다. 현재 sha256을 전달하십시오.
POST/v1/workspace/files/:name/restore-templatesrc/workspace/templ...의 배포된 템플릿으로 워크스페이스 파일을 덮어씁니다.

리서치

메서드경로설명
POST/v1/researchAgent 루프를 거치지 않고 게이트웨이에서 직접 딥 리서치 파이프라인을 실행합니다.
GET/v1/institution/skills환경에서 사용 가능한 스킬과 라운드테이블에 사용할 수 있는 읽기 전용 도구를 나열합니다.
GET/v1/institution/agent-templates라운드테이블 Agent 하나를 구성하기 위한 내장 및 사용자 생성 템플릿을 나열합니다.
POST/v1/institution/agent-templates독립적으로 재사용 가능한 Agent 구성을 저장합니다.
PATCH/v1/institution/agent-templates/:templateId사용자 생성 Agent 템플릿을 업데이트합니다. 내장 템플릿은 변경할 수 없습니다.
DELETE/v1/institution/agent-templates/:templateId기존 라운드테이블 복사본에는 영향을 주지 않고 사용자 생성 Agent 템플릿을 삭제합니다.
GET/v1/institution/roundtable-templates기본 및 사용자 생성 전체 라운드테이블 템플릿을 나열합니다.
POST/v1/institution/roundtable-templates제목, 설명, 독립적인 단계 및 Agent 구성을 저장합니다.
PATCH/v1/institution/roundtable-templates/:templateId사용자 생성 라운드테이블의 제목, 설명 또는 구성을 업데이트합니다.
DELETE/v1/institution/roundtable-templates/:templateId해당 템플릿을 사용하는 세션이나 실행 스냅샷에는 영향을 주지 않고 사용자 생성 템플릿을 삭제합니다.
GET/v1/institution/runs/:runId/snapshot변경 불가한 템플릿, 파이프라인, Agent 설정, 사용량, 최종 결과를 반환합니다.

개인화 및 메모리

메서드경로설명
GET/v1/profileAgent가 모든 시스템 프롬프트에 주입하는 재구성된 개인화 스냅샷을 읽습니다.
GET/v1/profile/onboarding사용자가 온보딩을 완료했는지 여부와 저장된 원시 답변을 반환합니다.
POST/v1/profile/onboarding온보딩 답변을 적용합니다. 금융 지식/빈도/위험/시장 정보를 매핑합니다.
GET/v1/financial-profile최신 영속화된 financial_profile 행을 반환합니다. 재구성된 플랫폼 지갑 요약을 포함합니다.
PUT/v1/profile/prompt사용자의 커스텀 시스템 프롬프트 추가분을 교체합니다. (최대 2000자)
DELETE/v1/profile/prompt추가분을 삭제합니다. UI는 호출 전 하드 확인을 표시합니다.
PUT/v1/profile/tags/:name11개 행동 태그 차원 중 하나를 설정하거나 지웁니다. (예: risk, markets)
DELETE/v1/profile/tags/:namevalue: null로 PUT한 것과 동일합니다. 태그가 지워지고 Agent가 다시 추론합니다.
GET/v1/memorycategory로 필터링된 최근 메모리를 읽거나 하이브리드(BM25 + 벡터) 검색을 실행합니다.
GET/v1/memory/trading-cases레거시 자유 형식 노트 피드입니다. (category = 'trading-cases'인 memories 테이블)
GET/v1/memory/research-casestopic으로 필터링된 /research 실행의 메모리입니다. 리서치 회고에서 사용됩니다.
POST/v1/memoryAgent가 항상 기억해야 하는 메모리를 직접 작성합니다. 서버가 category=pe...를 스탬프합니다.
PATCH/v1/memory/:idsource=user_manual 메모리의 statement, fact_type, tickers를 편집합니다.
DELETE/v1/memory/:iddeleted_at = now()로 표시합니다. 읽기 경로(FTS, 목록, 스냅샷)에서 해당 행을 필터링합니다.
POST/v1/memory/:id/restoredeleted_at을 지웁니다. 웹 UI 실행 취소 토스트(5초 창)에 연결되어 있지만 직접 호출도 가능합니다.
POST/v1/profile/refresh세 가지 개인화 재구성(trading_summary / tags / memories)을 모두 실행합니다.
GET/v1/profile/trade-history-breakdown금융 프로필 대시보드에 데이터를 제공하는 3가지 소스 분류를 반환합니다.
GET/v1/profile/reference-wallets사용자의 외부 지갑 주소 관심 목록을 반환합니다.
PUT/v1/profile/reference-wallets관심 목록을 원자적으로 교체합니다. 서버가 EVM(0x + 40 hex)과 Solana 주소를 검증합니다.

학습된 선호도

메서드경로설명
GET/v1/learned-preferences승인 대기 중인 추론된 행동 선호도를 반환합니다. (제안됨 / 활성 / 사용 중단됨)
POST/v1/learned-preferences/:id/:action학습된 선호도 하나를 전환합니다. 승인하면 활성화되어 시스템 프롬프트에 반영됩니다.
GET/v1/learned-preferences/:id학습된 선호도 id 하나의 전체 레코드를 반환합니다. (설명, 신호 강도, 히스토리 포함)
GET/v1/watchlist프로필에 저장된 사용자 큐레이션 심볼 관심 목록을 반환합니다.
PUT/v1/watchlist관심 목록을 교체합니다. (최대 100개 심볼)
GET/v1/runtime-preferences서브 기능 토글 스키마, 현재 재정의, 해결된 값을 반환합니다.
PUT/v1/runtime-preferences모든-또는-없음 검증으로 사용자 재정의를 일괄 적용합니다. If-Match 조건을 지원합니다.
GET/v1/runtime-preferences/critical-unlock-status중요 등급 토글이 현재 잠금 해제되어 있는지 여부를 읽습니다. (CLI minara c...를 통해)
POST/v1/runtime-preferences/critical-unlock후속 PUT /v1/runtime-preferences가 중요 등급 토글을 변경할 수 있도록 단기 잠금 해제를 발급합니다.
POST/v1/runtime-preferences/sign-ack다음 PUT /v1/runtime-preferences에서 소비되는 단기 서명된 ack 토큰을 발급합니다.
GET/v1/credentials/families제공자 패밀리 레지스트리를 반환합니다. (웹 검색, 시장 데이터, 임베딩, 클라우드 등)
PUT/v1/credentials/families/:id~/...의 dataSources 슬롯에 단일 제공자 패밀리의 재정의를 씁니다.
DELETE/v1/credentials/families/:id/field/:envVar단일 필드의 재정의를 삭제합니다. (환경 변수 파생 폴백으로 되돌림)
GET/v1/credentials/secrets플랫 자격 증명 슬롯(dataS...)에 구성된 모든 자격 증명 키를 반환합니다.
PUT/v1/credentials/secrets/:keyUPPER_SNAKE 키 아래 값을 저장합니다. 메시징 환경 변수는 메시징 환경 변수로 라우팅됩니다.
GET/v1/credentials/custom~/.minara/credentials.json의 자유 형식 custom 슬롯에 있는 모든 키를 반환합니다.
PUT/v1/credentials/custom/:keycustom 슬롯의 임의 키 아래 값을 저장합니다. (원자적 + 파일 잠금)
DELETE/v1/credentials/custom/:keycustom 슬롯에서 단일 키를 삭제합니다.

알림

메서드경로설명
GET/v1/notifications최근 인앱 알림(최신순)과 unread_count를 반환합니다.
DELETE/v1/notifications모든 알림을 삭제합니다. \{ ok, cleared \}를 반환합니다.
POST/v1/notifications/read-all모든 읽지 않은 알림을 읽음으로 표시합니다. \{ ok, updated \}를 반환합니다.
POST/v1/notifications/:id/read단일 알림을 읽음으로 표시합니다. (멱등) \{ ok: true, updated \}를 반환합니다.
DELETE/v1/notifications/:idid로 단일 알림을 삭제합니다.

학습 및 방법론

메서드경로설명
GET/v1/memory/trading-cases/stats트레이딩 케이스 대시보드용 4개 숫자 스냅샷입니다. 총 케이스 수, 최근 30일, 승률 등을 포함합니다.
GET/v1/memory/trading-cases/methodology-trend상위 N개 방법론의 주별 outcome_alpha_return 시계열을 반환합니다.
GET/v1/memory/methodologiesWilson 하한 신뢰도로 순위가 매겨진 상위 N개 방법론을 케이스 수, 자산 클래스와 함께 반환합니다.
GET/v1/memory/methodology-cases통합 methodology_observations 원장을 읽습니다. 감사 원장 뷰에 데이터를 제공합니다.
GET/v1/memory/trading-cases/:idmethodology_observations.id 하나의 전체 행 JSON을 반환합니다.
GET/v1/memory/trades통합 trade_executions에서 최근 Agent 실행 거래를 반환합니다. 액션, from/to 정보를 포함합니다.
GET/v1/memory/strategy-runsstrategy_runs에서 사용자의 Autopilot / 관리형 전략 실행을 반환합니다.
GET/v1/memory/factsfact_type으로 필터링된 FactLayer 행을 반환합니다. (observation.* / preference.* / goal.targ...)

스킬

메서드경로설명
GET/v1/skillsAgent가 활성화할 수 있는 모든 등록된 도메인 스킬을 반환합니다. 각 항목은 활성화 정보를 포함합니다.
POST/v1/skills/reload외부 스킬 패키지를 샌드박스에 다시 미러링하고 재등록합니다.

통계

메서드경로설명
GET/v1/stats채팅 세션별로 버킷화된 token, 비용, 도구 호출 카운터를 반환합니다.
POST/v1/telemetry/block-actionui_block 이벤트(UBP v1)에 대한 클릭 레코드를 fire-and-forget으로 전송합니다. 웹 UI에서 게시합니다.

LLM 제공자

메서드경로설명
GET/v1/llm/default-modelAgent 루프가 현재 새 턴에 사용하는 모델 id를 반환합니다.
PUT/v1/llm/default-modelAgent 루프를 다른 모델 id로 전환합니다. 라이브 avail... 목록에 대해 검증됩니다.
GET/v1/llm/available-models게이트웨이가 디스패치할 수 있는 모델을 제공자별로 그룹화하여 반환합니다.
POST/v1/llm/available-models/refresh인메모리 캐시를 우회하여 활성 제공자의 모델 카탈로그를 강제로 다시 가져옵니다.
GET/v1/llm/background-models백그라운드 작업 모델의 지원 및 적용 상태, 설정 출처, 지정된 슬롯, 그리고 채팅·제목·압축·무인 작업·시각에 쓰는 모델을 반환합니다.
PUT/v1/llm/background-models백그라운드 작업 모델을 켜거나 끄고, 제목·압축·무인 작업에 쓸 모델을 지정합니다. enabled: null은 환경 또는 내장 기본값으로 복원합니다.
GET/v1/shortcut-questions수동 작성된 고정 목록과 카테고리별 LLM 생성 동적 질문을 반환합니다.

테마

메서드경로설명
GET/v1/theme웹 UI 테마 설정을 반환합니다. (밝음/어둠/시스템 + 강조색)
POST/v1/theme저장된 테마 설정을 업데이트합니다.
GET/v1/settings/report-design기관 및 딥 리서치 HTML 리포트에서 사용하는 저장된 시각적 설정을 반환합니다.
PUT/v1/settings/report-design기관 및 딥 리서치 리포트에서 사용하는 시각적 설정을 정규화하고 저장합니다.
GET/v1/report-style기관 및 딥 리서치가 공유하는 전체 리포트 스타일 구성을 반환합니다.
PUT/v1/report-style한 번의 요청으로 리포트 디자인 설정 및/또는 커스텀 REPORT.css를 업데이트합니다.
PUT/v1/report-style/preset나머지 디자인 설정을 유지하면서 내장 리포트 스타일 프리셋 중 하나를 적용합니다.
PUT/v1/report-style/css선택한 프리셋 이후에 적용되는 커스텀 REPORT.css를 검증하고 교체합니다.

게이트웨이

메서드경로설명
GET/v1/gateway/providers게이트웨이에 등록된 인바운드 메시징 제공자를 반환합니다. (Slack, Lark 등)
POST/v1/gateway/providers/:id/fields/:envVar/reveal마스킹된 단일 자격 증명 필드의 평문 값을 반환합니다. (예: `TELEGRAM_
POST/v1/gateway/providers/:id/resolve-chat-idgateway 가 보유한 토큰으로 봇이 보낼 채팅 ID 를 조회합니다. 호출자는 토큰을 다루지 않습니다. 폴링 방식: found / awaiting_start / conflict / invalid_token.

yahoo_finance

공유 실시간 주식 대체 데이터입니다. FMP를 우선 사용해 정규화된 시세, 일별 이력, 회사 요약을 가져오고 실패하면 Yahoo Finance로 대체합니다.

단일 스크립트 위험 결정 조회

GET /v1/admin/script-risk/decisions/:id: 단일 스크립트 위험 게이트 결정의 전체 감사 기록입니다.

목차

인증상태 확인채팅채팅 세션상태 및 제어포트폴리오무기한 선물Autopilot시장 데이터음성이미지 및 동영상파일 및 아티팩트워크스페이스 파일리서치개인화 및 메모리학습된 선호도알림학습 및 방법론스킬통계LLM 제공자테마게이트웨이