apipick
[ search · endpoint ]검색 API · 마켓

주식, 암호화폐 및 마켓 검색 API

글로벌 및 미국 주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버를 단일 엔드포인트로 조회. AI 기반 가격 조회, 시장 데이터 검색, 트레이딩 리서치를 위한 미리 정형화된 JSON.

●120 크레딧 / 호출●30 요청 / 분POST /api/search/markets
[ 01 · live ]

마켓 검색 라이브 체험

API 키를 입력하고 라이브 엔드포인트에 실제 쿼리를 실행하세요.

auth · x-api-key

API 키가 없으신가요?

계정에 로그인하여 API 키를 생성하고 관리하세요.

로그인API 키 관리
5개 샘플 쿼리 — 클릭하여 불러오기
[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec
POST/api/search/markets
base
https://www.apipick.com

주식, 암호화폐, 외환, ETF, 펀드, 원자재, 미국 마켓 무버 전반의 시맨틱 검색. 다운스트림 LLM에 바로 사용 가능한 순위화된 레코드와 출처 URL 반환.

parameters
querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

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"
}'
● 200 · response
{
  "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
}
[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

30req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetSeconds until the current window resets
Retry-AfterSeconds to wait before retrying (only on 429)
● 429 · too many requests
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
}
[ faq ]

자주 묻는 질문

01

왜 호출당 120크레딧인가요?

시장 데이터 — 75개 거래소 주식, 암호화폐, 외환, 펀드, 무버 — 는 라이선스와 인덱스 유지보수가 필요하므로 엔드포인트는 120크레딧(호출당 약 $0.12)으로 책정됩니다. 전용 시장 데이터 API 좌석보다 훨씬 저렴합니다.

02

어떤 시장이 포함되나요?

글로벌 및 미국 주식, 암호화폐, 외환 페어, ETF, 뮤추얼 펀드, 원자재 선물, 미국 마켓 무버(상승·하락·거래활발 상위). 모두 병렬로 조회됩니다.

03

데이터는 실시간인가요?

결과는 각 종목의 최신 가용 데이터를 반환합니다. 특정 시점 이력은 날짜 필터로 범위를 좁히거나 특정 종목과 기간을 조회하세요.

04

날짜 필터링은요?

예. start_date와 end_date를 YYYY-MM-DD 형식으로 전달하면 특정 기간으로 좁힐 수 있습니다.

05

OpenAI / Claude용 도구 스키마는요?

GET /api/search/markets/tool-schema가 바로 붙여넣을 수 있는 OpenAI 함수 및 Claude 도구 사용 정의를 반환합니다.