Base URL
https://finance.search-etf.com/python-api
응답 형식
JSON
API 요청 시 아래 두 가지 방법 중 하나로 인증합니다.
방법 1: Header
X-API-Key: YOUR_API_KEY
방법 2: Query Parameter
?api_key=YOUR_API_KEY
# Header 방식 curl -H "X-API-Key: YOUR_API_KEY" \ "https://finance.search-etf.com/python-api/api/stock/005930" # Query Parameter 방식 curl "https://finance.search-etf.com/python-api/api/stock/005930?api_key=YOUR_API_KEY"
/python-api/api/stock/{symbol}
한국/해외 주식의 가격 데이터를 조회합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
symbol |
Yes | 종목코드 (005930, AAPL 등) |
start_date |
No | 시작일 (YYYY-MM-DD) |
end_date |
No | 종료일 (YYYY-MM-DD) |
예시:
/python-api/api/stock/005930?start_date=2024-12-01&api_key=YOUR_KEY /python-api/api/stock/AAPL?start_date=2024-12-01&api_key=YOUR_KEY
/python-api/api/listing/{market}
특정 시장의 상장 종목 목록을 조회합니다.
지원 시장:
KRX 한국거래소
KOSPI 코스피
KOSDAQ 코스닥
NASDAQ 나스닥
NYSE 뉴욕증권거래소
SP500 S&P 500
예시:
/python-api/api/listing/KOSPI?api_key=YOUR_KEY /python-api/api/listing/NASDAQ?api_key=YOUR_KEY
/python-api/api/index/{index_code}
주요 지수의 시계열 데이터를 조회합니다.
지원 지수:
KS11 코스피
KQ11 코스닥
KS200 코스피200
DJI 다우존스
IXIC 나스닥
US500 S&P 500
VIX 변동성지수
N225 닛케이225
HSI 항셍
예시:
/python-api/api/index/KS11?start_date=2024-12-01&api_key=YOUR_KEY /python-api/api/index/IXIC?start_date=2024-12-01&api_key=YOUR_KEY
/python-api/api/etf/{country}
국가별 ETF 목록을 조회합니다.
KR 한국
US 미국
예시:
/python-api/api/etf/KR?api_key=YOUR_KEY /python-api/api/etf/US?api_key=YOUR_KEY
/python-api/api/crypto/{symbol}
암호화폐 가격 데이터를 조회합니다.
BTC-USD
BTC-KRW
ETH-USD
ETH-KRW
XRP-USD
예시:
/python-api/api/crypto/BTC-USD?start_date=2024-12-01&api_key=YOUR_KEY
/python-api/api/exchange/{currency_pair}
통화 쌍의 환율 데이터를 조회합니다.
USD/KRW 달러/원
EUR/USD 유로/달러
JPY/KRW 엔/원
CNY/KRW 위안/원
예시:
/python-api/api/exchange/USD/KRW?start_date=2024-12-01&api_key=YOUR_KEY
/python-api/api/search
키워드로 종목을 검색합니다.
| 파라미터 | 필수 | 설명 |
|---|---|---|
q |
Yes | 검색 키워드 |
market |
No | 시장 코드 (KOSPI, NASDAQ 등) |
예시:
/python-api/api/search?q=삼성&api_key=YOUR_KEY /python-api/api/search?q=APPLE&market=NASDAQ&api_key=YOUR_KEY
/python-api/api/commodity/{symbol}
원유, 금, 은, 구리 등 상품 선물 가격 데이터를 조회합니다.
지원 심볼:
CL=F WTI유 (NYMEX)
BZ=F 브렌트유 (NYMEX)
NG=F 천연가스 (NYMEX)
GC=F 금 (COMEX)
SI=F 은 (COMEX)
HG=F 구리 (COMEX)
예시:
/python-api/api/commodity/GC=F?start_date=2024-12-01&api_key=YOUR_KEY /python-api/api/commodities/major?days=30&api_key=YOUR_KEY
/python-api/api/treasury/{symbol}
미국 국채 채권 수익률 데이터를 조회합니다.
지원 심볼:
US5YT 5년 만기
US10YT 10년 만기
US30YT 30년 만기
예시:
/python-api/api/treasury/US10YT?start_date=2024-12-01&api_key=YOUR_KEY /python-api/api/treasury/major?days=30&api_key=YOUR_KEY
const API_KEY = 'YOUR_API_KEY';
const BASE_URL = 'https://finance.search-etf.com/python-api';
// Header 방식
fetch(`${BASE_URL}/api/stock/005930`, {
headers: { 'X-API-Key': API_KEY }
})
.then(res => res.json())
.then(data => console.log(data));
// Query Parameter 방식
fetch(`${BASE_URL}/api/stock/005930?api_key=${API_KEY}`)
.then(res => res.json())
.then(data => console.log(data));
import requests
API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://finance.search-etf.com/python-api'
# Header 방식
response = requests.get(
f'{BASE_URL}/api/stock/005930',
headers={'X-API-Key': API_KEY}
)
# Query Parameter 방식
response = requests.get(
f'{BASE_URL}/api/stock/005930',
params={'api_key': API_KEY, 'start_date': '2024-12-01'}
)
data = response.json()
print(data)
# Header 방식 curl -H "X-API-Key: YOUR_API_KEY" \ "https://finance.search-etf.com/python-api/api/stock/005930" # Query Parameter 방식 curl "https://finance.search-etf.com/python-api/api/stock/005930?api_key=YOUR_API_KEY"