데이터·출처Data & Licenses
Uhype가 사용하는 모든 공개 데이터 출처와 라이선스 · façade-strictEvery public source Uhype uses, with its license
façade-strict 원칙 · commitment
표시되는 모든 수치는 약관이 허용하는 공개 출처의 실제 값이거나, 데이터가 없으면 null / "—" 입니다. 지어내거나 보간하지 않습니다.
Every number shown is a real value from a terms-permitted public source, or null / "—" when absent. Nothing fabricated or interpolated.
전체 출처All sources
표를 좌우로 밀어 전체 열 보기 →Swipe sideways to see every column →
| 영역Area | 소스Source | 제공Provides | 표출Mode | 라이선스License |
|---|---|---|---|---|
| 한국 주식 / KR equities | FinanceDataReader ↗ | KOSPI·KOSDAQ 일별 종가·등락 / daily close & change | EOD | 오픈소스 라이브러리 · 정보제공 / open-source lib |
| 한국 지수·공식 / KR official | KRX (data.krx.co.kr) ↗ | 공식 시장정보·지수 / official market data & indices | EOD | KRX 정보이용 약관 / KRX data terms |
| 한국 공시·재무·지분 / KR filings | DART OPEN API (전자공시) ↗ | 공시·손익·지분변동(5%·임원) / filings, income, ownership | 공시 기준 / as-filed | 공공데이터 (OPEN DART) / public, API key |
| 미국 주식 / US equities | CNBC quote ↗ | S&P 500 등락 / S&P 500 quotes | 지연 / delayed | 공개 quote · 표시용 / public quote, display |
| 미국 주식 / US equities | FinanceDataReader ↗ | S&P 500 일별 종가 / daily close | EOD | 오픈소스 라이브러리 / open-source lib |
| 크립토 시세 / Crypto prices | Binance (data-api.binance.vision) ↗ | 실시간 가격·24h 등락·분봉 / live price, 24h, 1m candles | 실시간 / real-time | 공개 데이터 · 표출 허용 / public, display OK |
| 크립토 펀더멘털 / Crypto TVL | DefiLlama ↗ | TVL·수수료·매출 / TVL, fees, revenue | 일별 / daily | 오픈 데이터 / open data |
| 크립토 메타 / Crypto meta | CoinGecko ↗ | 이름·로고·시총 / name, logo, market cap | 일별 / daily | 무료 API / free API |
| 부동산 실거래 / Real-estate deals | 국토교통부 (data.go.kr) ↗ | 아파트 매매·전세 실거래가 / apartment sale & jeonse | 공공 / public | 공공데이터포털 / public data portal |
| 부동산 좌표 / Geocoding | VWorld (국토부 공간정보) ↗ | 단지 좌표 / complex coordinates | — | 국토부 오픈플랫폼 / open platform |
| 거시·일정 / Macro | FRED (St. Louis Fed) ↗ | 경제지표·발표 일정 / economic series & release dates | — | FRED API 약관 / FRED API terms |
| 트렌드 / Trends | Google Trends RSS ↗ | 급상승 검색어 / trending searches | 표시 전용 / display-only | Google ToS · 저장 안 함 / not stored |
| 트렌드 뉴스 / Trend news | GDELT DOC 2.0 ↗ | 글로벌 뉴스 카운트 / global news counts | 일별 / daily | Public domain (Open Data) |
| 트렌드 관심 / Trend interest | Wikimedia Pageviews ↗ | 아티클 조회수 / article views | 일별 / daily | CC BY-SA 4.0 |
| 트렌드 신호 / Trend signals | YouTube · X · Naver | 인기·언급 신호 / popularity & mention signals | 표시 전용 / display-only | 각 서비스 ToS / each service's ToS |
실시간 표출에 대한 정직한 한계Honest limits on real-time display
한국 주식 / KR equities — 장중 실시간 시세를 일반에게 표출하려면 KOSCOM 시세정보이용계약(법인)이 필요합니다. 그 계약 전까지 Uhype는 합법적으로 EOD(종가)를 제공합니다.
Publicly displaying KR intraday real-time quotes requires a paid KOSCOM market-data license (corporate). Until then Uhype legally shows end-of-day data.
미국 주식 / US equities — 표시되는 시세는 지연(delayed)이며 30초마다 갱신됩니다. 크립토만 무료·합법으로 실시간 표출이 가능합니다(Binance).
US quotes shown are delayed and refresh every 30s. Only crypto can be shown real-time for free and legally (Binance).
트렌드 API (무료 베타)Trends API (free beta)
무료 베타 · free beta
아래 API·임베드는 무료 베타입니다 — 사전고지 후 응답 형식·제공 범위가 변경될 수 있습니다. API 키 발급은 준비 중이며, 지금은 키 없이 사용할 수 있습니다.
The API and embed below are a free beta — shape and availability may change with prior notice. API keys are in preparation; for now no key is required.
랭킹 보드 데이터Ranked board data
GET https://uhype.app/api/data/trend-board
주기적으로 베이크되는 랭킹 트렌드 보드 JSON입니다. meta.generatedAt이 베이크 시각(ISO)이고, items[]는 점수 내림차순 항목들입니다 — 주요 필드: term·slug·score(0–100 또는 null)·momentumPct·zScore·breakout·sources[]·spark[]·kgRef(내부 딥링크)·sourceUrl·why(출처 기사 제목 발췌 {text, source, url} 또는 null — 생성 문구가 아닙니다). 전체 계약은 저장소의 lib/uhype/trends/score-types.ts에 있습니다. 데이터가 없는 수치는 항상 null입니다(façade-strict — 0으로 채우지 않음).The periodically-baked ranked trend board as JSON. meta.generatedAt is the bake time (ISO); items[] is ranked by score descending — key fields: term, slug, score (0–100 or null), momentumPct, zScore, breakout, sources[], spark[], kgRef (internal deep link), sourceUrl, and why (an extractive headline {text, source, url} or null — never AI-fabricated copy). The full contract lives in lib/uhype/trends/score-types.ts in the repo. Absent numerics are always null (façade-strict — never 0-filled).
공정 이용 · 캐싱Fair use & caching
응답은 엣지 캐시됩니다 (Cache-Control: public, max-age=120, s-maxage=300, stale-while-revalidate=86400). 데이터셋은 베이크 주기로만 갱신되므로 2분보다 자주 폴링해도 새 데이터는 없습니다 — 이용자 측에서도 캐시해 주세요.Responses are edge-cached (Cache-Control: public, max-age=120, s-maxage=300, stale-while-revalidate=86400). The dataset only changes when a bake runs, so polling more often than every 2 minutes yields nothing new — please cache on your side too.
출처 표기 (필수)Attribution (required)
이 데이터를 표시할 때는 보이는 곳에 “Uhype” 출처 표기와 함께 https://uhype.app 또는 해당 항목의 퍼머링크로 링크해 주세요.When displaying this data, include a visible “Uhype” credit linking to https://uhype.app or to the item’s permalink.
퍼머링크Permalinks
각 항목의 slug 필드로 공유 페이지가 열립니다: https://uhype.app/t/<slug>Each item’s slug field resolves to a share page: https://uhype.app/t/<slug>
임베드 카드Embeddable card
랭킹 TOP 리스트를 그대로 붙여넣을 수 있는 초경량 iframe 카드입니다 — JS·쿠키 없음, 인라인 스타일만.A featherweight iframe card of the ranked TOP list — no JS, no cookies, inline styles only.
<iframe src="https://uhype.app/embed/trend-board?n=5&lang=ko&theme=dark" width="360" height="300" loading="lazy" style="border:0;border-radius:12px" title="Uhype 실시간 트렌드 보드 TOP 5"></iframe>
파라미터: n 1–10 (기본 5) · lang ko|en · theme dark|light. 높이는 행당 약 34px + 헤더/푸터 ~130px로 잡으면 됩니다 (n=5 ≈ 300px). 카드에는 Uhype 출처 링크가 포함되며 제거할 수 없습니다.Params: n 1–10 (default 5) · lang ko|en · theme dark|light. Budget roughly 34px per row plus ~130px of header/footer (n=5 ≈ 300px). The card carries a Uhype attribution link that cannot be removed.
방법론(점수·신호 산출)은 방법론Methodology 페이지를 참고하세요. 오류 제보: support@uhype.app