포트폴리오 인텔리전스 API

모든 포트폴리오에 대한 판단. API 호출 한 번으로.

보유 종목을 단일 엔드포인트로 POST하세요. PORTIQA는 종합 점수, 리스크 균형, 집중도, 회복력, 그리고 다음에 주의해야 할 사항을 반환합니다 — 45개 시장 70,000개 자산을 기준으로 평가합니다.

무료 API 키 발급받기 문서 보기 →

1 개 엔드포인트 70,000 개 자산 45 개 시장 5 회 무료 호출 / 월

portiqa — evaluate 실시간

POST /evaluate HTTP/1.1 Authorization: Bearer pq_live_•••••••• { "positions": [ { "ticker": "AAPL", "value": 12000 }, { "ticker": "MSFT", "value": 8000 }, { "ticker": "NVDA", "value": 5000 } ] }

200 OK · application/json

{ "score": 78.1, "status": "Good", "top_sector": "Technology", "top_sector_weight": 75.8, "exposure_plan": { "target_invested_pct": 72.0, "target_cash_pct": 28.0, "stance": "balanced" }, "suggestions": [ /* 3 items */ ] }

78.1 양호

70,000커버 자산

45시장

1엔드포인트

5월 무료 평가 횟수

한 번의 호출로 받는 것.

응답의 모든 필드에는 존재 이유가 있습니다. 모든 요금제에서 동일한 엔진 — 요금제는 호출 횟수만 달라집니다. 전체 스키마는 API 레퍼런스에서 확인하세요.

evaluation.score

종합 점수

자산 배분 건전성, 리스크 균형, 회복력을 가중한 0~100의 단일 수치 — 어떤 포트폴리오끼리도 비교할 수 있습니다.

evaluation.status

쉬운 언어의 판단

사용자가 즉시 이해하는 읽기 쉬운 상태값 — 정량 분석 배경 없이도 바로 행동할 수 있습니다.

top_sector_weight

집중도 분석

포트폴리오가 어디에 과도하게 쏠려 있는지, 건전한 분산에서 얼마나 벗어나 있는지 — 섹터별·종목별로 제시합니다.

exposure_plan

익스포저 계획

투자와 현금의 목표 비중을 명확한 스탠스와 함께 제시하며, 현재 시장 국면에 맞춰 조정됩니다.

risk_profile

리스크 균형

포트폴리오의 리스크가 실제로 어떻게 분포하는지 — 팩터 익스포저를 보유자의 프로필과 대조합니다.

suggestions[]

구체적인 다음 조치

포트폴리오를 강화하기 위한 우선순위가 매겨진 구체적 제안 — 관찰이 아니라 실행 지침입니다.

요청 하나가 들어가고. 판단 하나가 나옵니다.

보유 종목을 보내면 PORTIQA가 실시간 시장 국면 데이터와 대조해 평가하고, 명확한 답을 돌려줍니다 — 모두 단 한 번의 API 호출로.

보내는 것

보유 종목

{
  "positions": [
    { "ticker": "AAPL", "value": 12000 },
    { "ticker": "MSFT", "value":  8000 },
    { "ticker": "NVDA", "value":  5000 }
  ]
}

POST /evaluate

PORTIQA 평가

70,000개 자산 · 45개 시장

모든 보유 종목을 한 번의 처리로 식별하고 검증합니다:

자산 배분 건전성
섹터 집중도
팩터 익스포저
시장 국면 적합성

결정론적 엔진

받는 것

78.1 양호

종합 점수 및 상태
섹터 및 집중도 분석
익스포저 계획과 개선 제안

200 OK · JSON

정밀 계측기처럼 설계했습니다.

PORTIQA는 한 가지만 진지하게 합니다. 원시 보유 데이터를 의사결정의 토대가 되는 판단으로 바꾸는 일입니다.

모든 요금제에서 동일한 엔진

요금은 호출 횟수만 바꿀 뿐, 결과의 품질은 결코 달라지지 않습니다. 무료 요금제도 최상위 요금제와 완전히 동일한 평가를 수행합니다.

데이터 나열이 아닌 판단

엔드포인트는 무엇이 존재하는지가 아니라 무엇이 중요한지 알려줍니다. 점수, 상태, 제안은 사람이 읽기 쉽고 기계가 파싱하기 쉽도록 설계되었습니다.

만드는 사람을 위해

대시보드, 고객용 제품, 자문 도구에 바로 들어가는 깔끔하고 안정적인 JSON. 통합할 엔드포인트도 하나, 익힐 스키마도 하나입니다.

자주 묻는 질문.

더 자세한 내용은 API 레퍼런스와 분석 가이드를 참고하세요.

PORTIQA 포트폴리오 분석 API는 무엇을 반환하나요?

/evaluate로 POST 요청을 한 번 보내면 0에서 100까지의 종합 점수, 쉬운 언어로 된 상태값, 분산도·리스크·퀄리티·시그널·트렌드 항목별 점수, 최대 종목 비중과 유효 종목 수를 포함한 집중도 지표, 투자 및 현금 비율을 담은 목표 익스포저 계획, 그리고 우선순위가 매겨진 제안 목록이 반환됩니다.

PORTIQA는 몇 개의 자산과 시장을 커버하나요?

PORTIQA는 45개 시장의 약 70,000개 자산과 보유 종목을 대조하며, 점수를 산출하기 전에 각 종목에 섹터·팩터·시장 국면 데이터를 보강합니다. 보내실 것은 티커와 평가 금액뿐이며 나머지는 모두 자동으로 조회됩니다.

포트폴리오 API에 무료 요금제가 있나요?

있습니다. 무료 요금제는 월 5회 평가를 제공하며 모든 유료 요금제와 동일한 평가 엔진으로 동작합니다. 요금은 호출 가능 횟수만 바꿀 뿐 분석 품질은 달라지지 않습니다.

API는 어떤 형식을 받나요?

HTTPS를 통한 JSON입니다. 각 항목에 티커와 평가 금액이 담긴 positions 배열을 보내고, 리스크 수준과 현금 잔액은 선택적으로 지정할 수 있습니다. 인증은 Authorization 헤더의 bearer 토큰으로 수행합니다. 응답은 JSON입니다.

PORTIQA가 투자 자문을 제공하나요?

아닙니다. PORTIQA는 정보 제공만을 목적으로 하는 정량 분석을 반환합니다. 그 결과물은 포트폴리오의 구조와 특성을 기술할 뿐이며, 투자 자문이나 특정 증권의 매수·매도 권유를 구성하지 않습니다.