주식, 암호화폐 및 마켓 검색 API
글로벌 및 미국 주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버를 단일 엔드포인트로 조회. AI 기반 가격 조회, 시장 데이터 검색, 트레이딩 리서치를 위한 미리 정형화된 JSON.
마켓 검색 API란?
주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능한 순위화된 레코드와 출처 URL 반환.
- 엔드포인트
- POST /api/search/markets
- 인증
- API 키 · x-api-key 헤더
- 비용
- 120 크레딧 / 호출
- 속도 제한
- 30 요청 / 분
- 응답
- 구조화된 JSON
통합 가이드
스니펫을 복사하고 API 키를 교체한 뒤 실행하세요. 모든 HTTP 클라이언트에서 작동합니다 — 아래에 cURL, JavaScript, Python 예제가 있습니다.
/api/search/marketshttps://www.apipick.com주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능한 순위화된 레코드와 출처 URL 반환.
querystring필수Natural-language search query
max_num_resultsinteger선택1–5, default 5
relevance_thresholdnumber선택0.0–1.0 quality filter
country_codestring선택ISO country code (e.g. US, GB)
start_datestring선택ISO date YYYY-MM-DD
end_datestring선택ISO date YYYY-MM-DD
curl -X POST "https://www.apipick.com/api/search/markets" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "Current price and market cap of Apple (AAPL)",
"max_num_results": 5,
"country_code": "US",
"start_date": "2026-01-01"
}'{
"query": "Current price and market cap of Apple (AAPL)",
"results": [
{
"title": "Example result",
"url": "https://example.com/article",
"snippet": "Short excerpt of the page content…",
"source_type": "web",
"published_at": "2026-04-15",
"score": 0.92
}
],
"result_count": 1,
"credits_used": 120,
"remaining_credits": 99
}요청 제한
스로틀링은 API 키 단위, 60초 슬라이딩 윈도우입니다. 한도에 도달하면 Retry-After 헤더가 포함된 깔끔한 429를 받습니다.
30req/min
API 키별, 엔드포인트별. 60초 슬라이딩 윈도우.
3concurrent
API 키당 동시에 처리 중인 최대 요청 수.
X-RateLimit-Limit분당 허용되는 최대 요청 수X-RateLimit-Remaining현재 윈도우에 남은 요청 수X-RateLimit-Reset현재 윈도우가 초기화되기까지의 초Retry-After재시도 전 대기 초 (429일 때만)HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 30 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}자주 묻는 질문
왜 호출당 120크레딧인가요?
시장 데이터 — 75개 거래소 주식, 암호화폐, 외환, 펀드, 무버 — 는 라이선스와 인덱스 유지보수가 필요하므로 엔드포인트는 120크레딧(호출당 약 $0.12)으로 책정됩니다. 전용 시장 데이터 API 좌석보다 훨씬 저렴합니다.
어떤 시장이 포함되나요?
글로벌 및 미국 주식, 암호화폐, 외환 페어, ETF, 뮤추얼 펀드, 원자재 선물, 미국 마켓 무버(상승·하락·거래활발 상위). 모두 병렬로 조회됩니다.
데이터는 실시간인가요?
결과는 각 종목의 최신 가용 데이터를 반환합니다. 특정 시점 이력은 날짜 필터로 범위를 좁히거나 특정 종목과 기간을 조회하세요.
날짜 필터링은요?
예. start_date와 end_date를 YYYY-MM-DD 형식으로 전달하면 특정 기간으로 좁힐 수 있습니다.
OpenAI / Claude용 도구 스키마는요?
GET /api/search/markets/tool-schema가 바로 붙여넣을 수 있는 OpenAI 함수 및 Claude 도구 사용 정의를 반환합니다.
다른 검색 API 살펴보기
LLM 도구 호출을 위해 제작된 실시간 시맨틱 웹 검색. 에이전트 소비용으로 미리 정형화된 순위 제목, URL, 깔끔한 스니펫을 반환. 국가·날짜 필터 지원.
주요 매체에 걸친 실시간 뉴스 검색. 시간 민감 쿼리를 위한 날짜 범위·국가 필터링. 아침 브리핑, 시장 뉴스 에이전트, RAG 파이프라인을 위해 제작.
한 번의 호출로 최대 25개 URL에서 깔끔하고 읽기 쉬운 콘텐츠를 추출. 광고·내비·보일러플레이트 제거 후 LLM이 바로 소비할 수 있는 마크다운풍 텍스트 반환. URL당 2 크레딧.
단일 엔드포인트로 arXiv, PubMed, bioRxiv, medRxiv의 동료 평가 논문과 프리프린트를 검색. AI 기반 문헌 검토, 과학 코퍼스 RAG, 인용 추출을 위해 제작.
임상시험, FDA 약물 라벨, ChEMBL 생물활성을 검색. 의학 연구, 약물 재포지셔닝, AI 기반 임상 의사결정 지원 워크플로를 위해 제작.
SEC 공시(10-K, 10-Q, 8-K), 미국 실적 발표 트랜스크립트, 주식 통계를 검색. AI 기반 실사, 펀더멘털 분석, 금융 RAG 파이프라인을 위해 제작.
USPTO, EPO, WIPO, 주요 국가 특허청에 걸친 글로벌 특허 출원 시맨틱 검색. 선행기술 조사, IP 풍경 분석, AI 기반 경쟁 인텔리전스를 위해 제작.
정치, 경제, 스포츠, 시사에 대한 Polymarket과 Kalshi 예측 시장 계약을 검색. 군중 예측 검색과 LLM 답변의 확률 근거 제공을 위해 제작.
단일 엔드포인트로 영국 판례법과 1차 입법을 시맨틱 검색. 법률 리서치, 컴플라이언스 검토, 법령 해석, AI 기반 리걸테크 워크플로를 위해 제작.
CISA 알려진 악용 취약점(KEV), NVD CVE 레코드, EPSS 악용 점수, MITRE ATT&CK 기법을 검색. AI 기반 취약점 분류, 위협 인텔리전스, 보안 운영을 위해 제작.
FRED, 미국 노동통계국, 세계은행 지표, IMF 거시 데이터, 미국 연방 지출, 독일 노동 통계를 검색. AI 기반 거시경제 리서치와 분석을 위해 제작.
미국 상장기업의 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래를 검색. AI 기반 기본적 분석과 실사를 위해 제작.
미국 실적 발표 캘린더에서 예정 보고일, EPS/매출 추정치, 장전/장후 발표 시점을 검색. AI 기반 이벤트 트레이딩과 리서치를 위해 제작.
ChEMBL 생물활성, PubChem 화학 구조, Open Targets 표적-질환 연관성을 검색. AI 기반 신약 개발, 케모인포매틱스, 생의학 연구를 위해 제작.
NCBI Gene, dbSNP, ClinVar, dbVar, MedGen, GTR에서 유전자, 변이, 임상적 의의를 검색. AI 기반 유전체 및 변이 해석 연구를 위해 제작.
NCBI Nucleotide, Protein, Genome, Assembly, CDD, Structure에서 서열, 어셈블리, 단백질 도메인을 검색. AI 기반 생명정보학을 위해 제작.
NCBI SRA, GEO, BioSample, BioProject, dbGaP, Taxonomy에서 시퀀싱 런, 발현 데이터셋, 생물종 데이터를 검색. AI 기반 오믹스 데이터 탐색을 위해 제작.
WHO 글로벌 보건 통계, NIH 연구비, openFDA 약물 이상사례 보고를 검색. AI 기반 공중보건 연구, 연구비 탐색, 약물감시를 위해 제작.
영국 의회 토론, 서면 질의, 의원 활동(Hansard)을 검색. AI 기반 시빅테크 도구, 입법 모니터링, 정책 연구를 위해 제작.
라이선스가 부여된 Wiley 금융 저널과 교과서를 검색. AI 기반 학술 수준의 금융 연구, 문헌 검토, 투자 분석을 위해 제작.