티커 검색
1 크레딧/v1/finance/ticker-search회사명 또는 종목명으로 상품을 찾습니다. category는 stock, index, mutual_fund, currency, futures입니다. quote에 넣을 id를 반환합니다.
keyword, category, language, location
Finance 엔드포인트
Finance 종목 읽기 엔드포인트는 7개입니다. 이름으로 검색하고 TICKER:EXCHANGE 또는 외환·암호화 페어로 시세를 가져오며 지수와 모버 보드를 읽습니다. 데이터 API만 지원하며 주문, 포트폴리오 쓰기는 없습니다.
종목 시세
5 크레딧/v1/finance/quote풍부한 Quote 1건을 반환합니다. 실시간 가격, 일중 그래프, 펀더멘털, 프로필, 가능 시 재무, 피어가 포함됩니다. keyword는 TICKER:EXCHANGE 또는 EUR-USD 형태 페어입니다.
keyword (TICKER:EXCHANGE or EUR-USD), language, location
시장 개요
1 크레딧/v1/finance/markets언어와 위치 기준 지수·모버 보드를 반환합니다. 시장 랜딩 스냅샷이며 전체 심볼 유니버스 크롤이 아닙니다.
language, location
Finance API7개 엔드포인트 지원
문서 보기종목 하나의 시세를 전부 돌려줍니다. 실시간 가격과 장중 그래프, 시가총액, PER, 배당수익률, 52주 범위, 기업 개요, 재무, 동종 종목까지 들어 있습니다.
GOOGL:NASDAQ이나 BTC-USD처럼 정확한 심볼을 이미 알 때 사용하세요. 이름밖에 없다면 ticker-search로 심볼부터 찾으세요.
5크레딧
GET/v1/finance/quote?keyword=GOOGL%3ANASDAQ
keyword · Instrument identifier: TICKER:EXCHANGE for stocks/ETFs/indices ('GOOGL:NASDAQ', '.INX:INDEXSP') or a forex/crypto pair ('EUR-USD', 'BTC-USD'). Use the `id` returned by ticker-search.
$ curl https://www.socialcrawl.dev/v1/finance/quote?keyword=GOOGL%3ANASDAQ \
-H "x-api-key: sc_YOUR_API_KEY"대기 중
// 실제 실행에는 API 키가 필요합니다. "실행해보기"를 누르면 예시 응답을 표시합니다Finance API 동작
Finance도 다른 SocialCrawl 엔드포인트와 같습니다. API 키로 GET /v1/finance/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. 증권사 OAuth와 별도 SDK는 없습니다.
호출 인증
x-api-key 헤더에 키를 보냅니다. 거래소 터미널 자격 증명은 필요 없습니다. Google Search, Google News를 포함한 카탈로그 전 구간에 같은 키를 사용합니다.
GET과 쿼리 파라미터
라우트는 모두 GET입니다. 검색과 시세에는 keyword를, ticker-search에는 선택 category를, 라우트가 받는 경우 선택 language와 location을 전달합니다. 과금 전에 검증합니다.
크레딧 과금
티커 검색과 시장 개요는 1 크레딧입니다. quote는 5 크레딧입니다. 가격 민감 경로는 캐시가 짧습니다(quote·markets 약 60초). 캐시 히트는 0 크레딧입니다. 빈 응답과 하드 실패는 환불됩니다.
JSON 봉투
응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다. quote는 Quote 객체 1건입니다. 검색과 시장은 목록 형태입니다.
연동 순서
대부분 제품은 이름을 종목 id로 확정한 뒤 quote를 호출합니다. 심볼 없이 지수와 모버가 필요하면 markets를 사용합니다.
01티커 검색
GET /v1/finance/ticker-search?keyword=…종목 id가 있는 QuoteList 후보입니다.
회사명을 TICKER:EXCHANGE로 매핑한 뒤 quote 비용을 지불합니다.
02시세
GET /v1/finance/quote?keyword=TICKER:EXCHANGE가격, 그래프, 펀더멘털, 프로필이 있는 전체 Quote입니다.
대시보드, 알림, 리서치 잡에 쓰는 풍부한 종목 페이로드입니다.
03시장
GET /v1/finance/markets지수와 모버의 QuoteList 보드입니다.
심볼 목록을 순회하지 않고 시장 스냅샷을 가져옵니다.
요청
GET /v1/finance/ticker-search
?keyword=Apple
&category=stock
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
GET /v1/finance/quote?keyword=AAPL:NASDAQ응답 봉투
{
"success": true,
"data": {
"symbol": "AAPL:NASDAQ",
"price": 0,
"currency": "USD",
"graph": [],
"profile": {}
},
"credits_used": 5,
"credits_remaining": 9999,
"request_id": "req_…",
"cached": false
}data 형태
금융 응답은 공유 Quote와 QuoteList 아키타입을 쓰므로 주식, ETF, 지수, 암호화, 외환 파서가 하나로 유지됩니다.
QuoteList (ticker-search)ticker-search
items[]: 종목 id(TICKER:EXCHANGE 또는 페어), name, type, 시장 힌트
Quotequote
symbol, price, currency, graph[], profile, fundamentals, 가능 시 financials, peers. 외환·암호화는 pair
QuoteList (markets)markets
보드 UI용 지수·모버 행. 동일 Quote 목록 리프
게이트웨이
다른 /v1 플랫폼 엔드포인트와 같은 요청 수명주기입니다. Finance 전용 사이드카가 아닙니다.
- 01
엣지 수신
Next.js catch-all이 Hono 소셜 API로 들어갑니다. request_id를 발급하고 키를 인증한 뒤 분당 600회 한도와 키당 동시 50건을 적용합니다.
- 02
검증 후 차감
레지스트리에서 finance/ticker-search, quote, markets를 찾습니다. 검색과 시세의 필수 keyword 검증이 먼저입니다. 잘못된 입력은 400이며 과금하지 않습니다. 유효 호출은 업스트림 전에 티어 비용을 원자적으로 차감합니다.
- 03
캐시 또는 조회
platform, resource, params로 캐시 키를 만듭니다. 히트면 즉시 반환하고 credits_used는 0입니다. 미스면 업스트림을 실시간으로 읽습니다. quote와 markets는 가격 신선도를 위해 TTL이 짧습니다. 5xx와 네트워크 오류는 재시도하며 불건전 시 서킷 브레이커가 동작합니다.
- 04
정규화 후 반환
업스트림 JSON을 Quote 또는 QuoteList로 매핑합니다. Zod로 검증한 뒤 성공 봉투로 감싸 빌링 감사에 남깁니다.
과금 규칙
- 티커 검색 라이브 미스는 1 크레딧입니다.
- 시장 개요 라이브 미스는 1 크레딧입니다.
- quote 라이브 미스는 5 크레딧입니다.
- 캐시 히트는 0 크레딧입니다.
- 빈 응답과 하드 실패는 자동 환불됩니다.
- 잘못된 파라미터는 400이며 과금하지 않습니다.
- 잔액이 없으면 402이며 과금하지 않습니다.
- 잘못된 거래소 접미사는 빈 결과 또는 오류 형태이며 문서화된 환불 규칙이 적용됩니다.
- 차감 후 업스트림 장애는 환불 경로가 적용됩니다.
데이터 수집
Finance는 공개 읽기 시장 데이터 SERP입니다. 종목을 Quote로 정규화하므로 두 번째 시세 SDK를 코드에 넣을 필요가 없습니다.
API에서의 Finance
종목 검색, 단일 종목 상세 시세, 시장 개요 보드를 제공합니다. 검색 카테고리는 주식, ETF, 지수, 뮤추얼 펀드, 통화, 선물입니다. 읽기 전용이며 주문 라우팅은 없습니다.
업스트림
quote, ticker-search, markets는 공개 금융 SERP를, history, statements, options, news는 별도의 실시간 시장 데이터 소스를 읽습니다. quote가 비용이 큰 상세 조회입니다. keyword가 정확한 TICKER:EXCHANGE 또는 페어 id가 되도록 ticker-search를 먼저 쓰는 것이 좋습니다.
응답 형태
success, data, credits_used, request_id, cached를 담은 통합 JSON 봉투를 반환합니다. 검색과 시장은 목록 형태입니다. quote는 가격, 그래프, 프로필, 가능 시 펀더멘털이 있는 Quote 1건입니다.
미제공 항목
증권사 인증은 없습니다. 업스트림이 제공하는 quote 그래프 창을 넘는 별도 캔들 제품은 없습니다. 포트폴리오·워치리스트 쓰기는 없습니다.
필드 매핑
instrument match row→ QuoteList item id종목 매칭 행은 QuoteList item id가 됩니다.
price + graph + fundamentals→ Quote fields가격, 그래프, 펀더멘털은 Quote 필드로 매핑됩니다.
indices + movers board→ markets QuoteList지수·모버 보드는 markets QuoteList가 됩니다.
이 API의 활용 분야
이 API가 가장 많이 사용되는 작업입니다.
3active Google Finance endpoints in the registry
1 / 5검색·시장 1 크레딧, quote 5 크레딧 사다리
심볼 확정 후 시세 보강
호출은 ticker-search 후 quote에 집중됩니다. 대시보드 헤더와 모버 위젯에는 markets가 사용됩니다. 주식, ETF, 지수, 암호화, 외환에 공통 Quote 형태를 씁니다. 티커 검색은 1 크레딧, 전체 시세는 5 크레딧입니다. 소셜·SERP와 같은 SocialCrawl 키를 사용합니다.
티커 검색과 시장 개요는 보통 수 초입니다. quote는 그래프, 펀더멘털, 프로필을 묶기 때문에 라이브 미스 시 더 무겁고 수 초가 걸리는 경우가 많습니다.
활용 사례
이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.
리서치 노트북
Python, pandas, cronticker-search로 이름을 확정한 뒤 quote로 펀더멘털과 그래프를 가져옵니다. 심볼과 가격 스냅샷을 일정에 따라 저장합니다.
제품 시세 위젯
Node, SSR, Explorer지수·모버 보드에 markets를 사용합니다. 짧은 캐시로 1분 창 안 반복 페이지 로드 비용을 낮춥니다.
알림 워커
Go, 큐, 웹훅한 번 확정한 뒤 주기로 quote하고 가격 또는 일 변동이 임계값을 넘으면 알립니다. 카탈로그와 같은 API 키를 사용합니다.
호출 예시
티커 검색과 시장 개요는 라이브 호출당 1 크레딧입니다. quote는 5 크레딧입니다. 캐시 히트는 무료입니다.
curl "https://www.socialcrawl.dev/v1/finance/ticker-search?keyword=Apple&category=stock" \
-H "x-api-key: sc_your_api_key_here"curl "https://www.socialcrawl.dev/v1/finance/quote?keyword=AAPL:NASDAQ" \
-H "x-api-key: sc_your_api_key_here"엔드포인트
Finance API는 어떤 데이터를 돌려주나요
모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.
QuoteGet a financial instrument quoteTicker SearchSearch financial instruments by nameMarketsGet a markets overview (indices + movers)NewsGet recent news for a financial instrumentHistoryGet daily price history for an instrumentStatementsGet financial statements for a companyOptionsGet an options chain for an instrument
비교
SocialCrawl과 Yahoo Finance / Alpha Vantage, 뭐가 다른가요?
같은 Finance 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.
| 항목 | SocialCrawl | Yahoo Finance / Alpha Vantage |
|---|---|---|
| 데이터 출처 | 현재 구글 파이낸스 스냅샷이에요. quote·markets는 60초, ticker-search는 2분까지 캐시되고 정확히 같은 캐시 요청은 0크레딧이에요 | 야후 파이낸스 스크래핑과 요청 제한이 걸린 무료 API를 섞어 써요 |
| 통합 스키마 | 주식·ETF·지수·암호화폐·환율이 같은 Quote 형태로 와요 | 제공처마다 형태가 달라서 데이터 소스마다 다시 매핑해야 해요 |
| 호출 횟수 | 현재가·차트·지표·재무·동종 종목이 요청 한 번에 와요 | 각 항목마다 엔드포인트나 제공처를 따로 호출해야 해요 |
| 상품 범위 | 주식·ETF·지수·암호화폐·환율을 하나의 API로 받아요 | 주식은 잘 되지만 암호화폐·환율은 별도 상품인 경우가 많아요 |
| 요금 | 시세 5 크레딧, 검색 1 크레딧, 신용카드 없이 100 크레딧 무료예요 | 무료 플랜은 요청을 제한하고 전체 접근은 유료 플랜이 필요해요 |
데이터 출처
SocialCrawl
현재 구글 파이낸스 스냅샷이에요. quote·markets는 60초, ticker-search는 2분까지 캐시되고 정확히 같은 캐시 요청은 0크레딧이에요
Yahoo Finance / Alpha Vantage
야후 파이낸스 스크래핑과 요청 제한이 걸린 무료 API를 섞어 써요
통합 스키마
SocialCrawl
주식·ETF·지수·암호화폐·환율이 같은 Quote 형태로 와요
Yahoo Finance / Alpha Vantage
제공처마다 형태가 달라서 데이터 소스마다 다시 매핑해야 해요
호출 횟수
SocialCrawl
현재가·차트·지표·재무·동종 종목이 요청 한 번에 와요
Yahoo Finance / Alpha Vantage
각 항목마다 엔드포인트나 제공처를 따로 호출해야 해요
상품 범위
SocialCrawl
주식·ETF·지수·암호화폐·환율을 하나의 API로 받아요
Yahoo Finance / Alpha Vantage
주식은 잘 되지만 암호화폐·환율은 별도 상품인 경우가 많아요
요금
SocialCrawl
시세 5 크레딧, 검색 1 크레딧, 신용카드 없이 100 크레딧 무료예요
Yahoo Finance / Alpha Vantage
무료 플랜은 요청을 제한하고 전체 접근은 유료 플랜이 필요해요
자주 묻는 질문
자주 묻는 질문
API, 요금제, 기능에 대한 질문과 답변입니다.
문의하기구글 파이낸스 API로 주식 시세는 어떻게 받나요?
keyword에 TICKER:EXCHANGE 형식(예: GOOGL:NASDAQ)을 담아 GET /v1/google_finance/quote를 호출하면 돼요. 한 번 호출로 현재가, 분 단위 차트, 지표, 기업 정보, 재무, 동종 종목이 통합 Quote JSON으로 와요.
어떤 종류의 금융 상품까지 다루나요?
주식, ETF, 지수, 암호화폐, 환율을 모두 같은 코드로 받을 수 있어요. quote.type 구분자와 비어 있을 수 있는 상세 필드 덕분에 한 번만 연동하면 모든 자산 군을 읽을 수 있어요. 환율·암호화폐 쌍(EUR-USD, BTC-USD)은 quote.pair로 와요.
회사 이름으로 티커 심볼을 검색할 수 있나요?
네. /v1/google_finance/ticker-search에 keyword=Apple을 넣으면 최대 5개 행이 와요. 각 행에는 quote에 바로 넣을 수 있는 id(AAPL:NASDAQ)와 함께 티커, 이름, 거래소, 현재가, 상품 유형이 담겨 있어요.
시장 지수나 등락 종목도 받아볼 수 있나요?
네. /v1/google_finance/markets는 파라미터 없이 호출돼요. 미국·유럽·아시아 주요 지수와 그날의 거래량 상위·급등·급락 종목을 하나의 Quote 목록(약 47개)으로 받아볼 수 있어요.
구글 파이낸스 API 요금은 얼마인가요?
전체 시세 조회는 5 크레딧(어드밴스드 티어), 티커 검색과 마켓은 각각 1 크레딧(스탠다드 티어)이 소진돼요. 새 계정에는 100 크레딧이 무료로 제공되고, 없는 티커는 404와 함께 자동 환불돼요.
Finance 데이터 스크래핑, 법적으로 괜찮을까요?
SocialCrawl은 누구나 볼 수 있는 공개 Finance 데이터만 돌려드리고, 로그인이 필요한 비공개 콘텐츠에는 접근하지 않아요. 다만 실제 적법성은 활용 목적과 국가별 법률에 따라 달라져요. Finance 이용약관과 GDPR·CCPA 같은 개인정보 보호 법규를 지키는 책임은 이용자에게 있어요. 이 답변은 일반 안내일 뿐, 법률 자문은 아니에요.
Finance 스크래핑 API와 공식 Finance API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 Finance 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.
AI에게 SocialCrawl을 물어보세요