{
  "info": {
    "name": "RichGo Finance Public API v2",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "검증된 산식 기반 주식 점수·괴리율·랭킹. 인증: Bearer rfk_live_<key>. 키 발급: https://bulliza.richgo.ai/my/api-keys"
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{API_KEY}}", "type": "string" }]
  },
  "variable": [
    { "key": "BASE_URL", "value": "https://bulliza.richgo.ai/api/public/v2" },
    { "key": "API_KEY", "value": "rfk_live_REPLACE_ME" }
  ],
  "item": [
    {
      "name": "Health (ping)",
      "request": {
        "method": "GET",
        "header": [],
        "url": { "raw": "{{BASE_URL}}/health", "host": ["{{BASE_URL}}"], "path": ["health"] },
        "description": "키 검증 + 현재 플랜·일일 한도·오늘자 사용량 반환."
      }
    },
    {
      "name": "Stock score (KR — 삼성전자)",
      "request": {
        "method": "GET",
        "header": [],
        "url": { "raw": "{{BASE_URL}}/stocks/005930/score", "host": ["{{BASE_URL}}"], "path": ["stocks", "005930", "score"] },
        "description": "종목 1개 미니멀 — 점수·괴리율·적정가·현재가."
      }
    },
    {
      "name": "Stock score (US — AAPL)",
      "request": {
        "method": "GET",
        "header": [],
        "url": { "raw": "{{BASE_URL}}/stocks/AAPL/score", "host": ["{{BASE_URL}}"], "path": ["stocks", "AAPL", "score"] }
      }
    },
    {
      "name": "Rankings (KR 1조+ TOP 10)",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{BASE_URL}}/rankings?market=KR&bands=mega,xlarge,large&limit=10",
          "host": ["{{BASE_URL}}"],
          "path": ["rankings"],
          "query": [
            { "key": "market", "value": "KR" },
            { "key": "bands", "value": "mega,xlarge,large" },
            { "key": "limit", "value": "10" }
          ]
        },
        "description": "괴리율 TOP 랭킹. bands: mega(20조+), xlarge(5~20조), large(1~5조), mid(3천억~1조), small(<3천억)."
      }
    },
    {
      "name": "Rankings (US TOP 20)",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{BASE_URL}}/rankings?market=US&bands=mega,xlarge&limit=20",
          "host": ["{{BASE_URL}}"],
          "path": ["rankings"],
          "query": [
            { "key": "market", "value": "US" },
            { "key": "bands", "value": "mega,xlarge" },
            { "key": "limit", "value": "20" }
          ]
        }
      }
    },
    {
      "name": "Exports — 전체 수출입 시계열 (최근 5년)",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{BASE_URL}}/exports/total?from=2021-06",
          "host": ["{{BASE_URL}}"],
          "path": ["exports", "total"],
          "query": [{ "key": "from", "value": "2021-06" }]
        },
        "description": "관세청 OpenAPI Newtrade 기반 한국 공식 수출·수입·무역수지 월별. 1990-01 부터."
      }
    },
    {
      "name": "Exports — 섹터별 수출 + YoY (TOP 10)",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{BASE_URL}}/exports/sectors?from=2024-01&top=10",
          "host": ["{{BASE_URL}}"],
          "path": ["exports", "sectors"],
          "query": [
            { "key": "from", "value": "2024-01" },
            { "key": "top", "value": "10" }
          ]
        },
        "description": "섹터별 월별 수출액 + 전년동월대비 증감률. 24개월 누적 기준 상위 N."
      }
    }
  ]
}
