FIN:FRAME / JSON API

YOUR NEXT SPREADSHEET. YOUR NEXT SCRIPT.

시장 데이터를 찾는 시간,
한 번의 API 호출로.

공식 경제지표·미 국채 금리·선물 포지션을 같은 형식으로 받아보세요. 관측기간, 단위, 원자료 링크와 갱신 상태까지 묶어 개인 대시보드와 자동화에 바로 연결합니다.

7일 무료 체험 시작 ↗실제 JSON 먼저 보기 ↓

체험은 7일 · 총 200회 · 카드 등록 없이 시작합니다. 공개 웹사이트의 시장 정보는 계속 무료입니다.

WHAT YOU CAN BUILD

보고, 비교하고, 자동으로 기록하세요.

세 가지 일을 위한 작은 API입니다. 데이터가 없는 곳을 추정치로 채우지 않고, 실제 제공 범위를 먼저 보여드립니다.

01 / PERSONAL DASHBOARD

내 경제지표 보드

물가·고용·국채 금리를 한 번에 조회해 스프레드시트나 개인 화면을 갱신하세요. 값과 관측기간이 같이 오므로 오래된 발표를 오늘 수치로 읽지 않습니다.

02 / CHANGE TRACKING

바뀐 사실만 모으기

cursor로 새 자료와 정정을 가져오세요. 이미 가진 기록을 매번 내려받을 필요가 없습니다. 누락과 삭제도 변경 종류로 구분합니다.

03 / RESEARCH NOTEBOOK

근거가 남는 분석

단위와 원자료 링크를 함께 보관하세요. 이력은 원천의 현재 수정본 기준입니다. 과거 당시 발표값을 재현하는 빈티지 데이터와는 범위가 다릅니다.

LIVE SAMPLE / NO KEY REQUIRED

샘플도 실제 자료입니다.

키 없이 확인하는 제한된 예제입니다. 관측값을 지어내지 않으며, 지연·미제공 상태도 그대로 표시합니다.

GET /api/v1/demo

지표	값·단위	관측기간	상태·출처
미 소비자물가 CPI`us_cpi`	334.131 지수 · 1982–84=100	2026-08	okSource: U.S. Bureau of Labor Statistics. 변화율은 FIN:FRAME 계산. ↗
미 실업률`us_unemployment`	4.1 %	2026-08	okSource: U.S. Bureau of Labor Statistics. 변화율은 FIN:FRAME 계산. ↗
미 실질 GDP · 전기비 연율`us_real_gdp_saar`	2.2 % 전기비 연율	2026-Q2	okSource: U.S. Bureau of Economic Analysis. 전기비 연율의 차이는 FIN:FRAME 계산. ↗
미 국채 10년`us_treasury_10y`	5.29 %	2026-09-30	okSource: U.S. Department of the Treasury. 스프레드와 변화량은 FIN:FRAME 계산. ↗
비트코인 · CME 표준 선물 · 미결제약정`cftc_btc_cme_standard_open_interest`	22,315 계약	2026-09-22	okSource: CFTC, Traders in Financial Futures — Futures Only. 변화·비율·한국어 설명은 FIN:FRAME 계산. ↗

규격 1.0 · API 자료 갱신 2026. 10. 1. 오후 7:15

공개 샘플입니다. 전체 지표·이력·변경분은 개인 API 키로 조회합니다.

COVERAGE & PROVENANCE

가져올 지표를 직접 고르세요.

선택하면 아래 연동 예제의 지표 ID가 바뀝니다. 최신값 조회는 최대 100개 지표를 한 요청으로 묶을 수 있습니다.

51전체 지표

51현재 자료 제공

4별개 CFTC 선물 계약

66공식 발표 일정

지표 찾기분류3개 선택

지표·ID	분류·주기	단위	현재 제공
비트코인 · CME 마이크로 선물 · 자산운용 순포지션`cftc_btc_cme_micro_asset_managers_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
비트코인 · CME 마이크로 선물 · 레버리지 펀드 순포지션`cftc_btc_cme_micro_leveraged_funds_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
비트코인 · CME 마이크로 선물 · 미결제약정`cftc_btc_cme_micro_open_interest`	선물 포지션주간	계약	자료 있음cftc-cot ↗
비트코인 · CME 표준 선물 · 자산운용 순포지션`cftc_btc_cme_standard_asset_managers_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
비트코인 · CME 표준 선물 · 레버리지 펀드 순포지션`cftc_btc_cme_standard_leveraged_funds_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
비트코인 · CME 표준 선물 · 미결제약정`cftc_btc_cme_standard_open_interest`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 마이크로 선물 · 자산운용 순포지션`cftc_eth_cme_micro_asset_managers_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 마이크로 선물 · 레버리지 펀드 순포지션`cftc_eth_cme_micro_leveraged_funds_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 마이크로 선물 · 미결제약정`cftc_eth_cme_micro_open_interest`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 표준 선물 · 자산운용 순포지션`cftc_eth_cme_standard_asset_managers_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 표준 선물 · 레버리지 펀드 순포지션`cftc_eth_cme_standard_leveraged_funds_net`	선물 포지션주간	계약	자료 있음cftc-cot ↗
이더 · CME 표준 선물 · 미결제약정`cftc_eth_cme_standard_open_interest`	선물 포지션주간	계약	자료 있음cftc-cot ↗
미 설비가동률`us_capacity_utilization`	growth월간	%	자료 있음fed-g17 ↗
미 근원 CPI`us_core_cpi`	inflation월간	지수 · 1982–84=100	자료 있음bls-series ↗
미 근원 PCE 물가 · 전월비`us_core_pce_inflation_mom`	inflation월간	% 전월비	자료 있음bea-pce ↗
미 소비자물가 CPI`us_cpi`	inflation월간	지수 · 1982–84=100	자료 있음bls-series ↗
미 가처분소득 · 전월비`us_disposable_income_mom`	income월간	% 전월비	자료 있음bea-pce ↗
미 가정 내 식료품 CPI`us_food_home_cpi`	inflation월간	지수 · 1982–84=100	자료 있음bls-series ↗
미 민간 평균 시간당 임금`us_hourly_earnings`	employment월간	달러 / 시간	자료 있음bls-series ↗
미 산업생산`us_industrial_production`	growth월간	지수 · 2017=100	자료 있음fed-g17 ↗
미 구인 건수 JOLTS`us_job_openings`	employment월간	천 건	자료 있음bls-series ↗
미 M1 통화량`us_m1`	liquidity월간	십억 달러	자료 있음fed-h6 ↗
미 M2 통화량`us_m2`	liquidity월간	십억 달러	자료 있음fed-h6 ↗
미 명목 GDP · 전기비 연율`us_nominal_gdp_saar`	growth분기	% 전기비 연율	자료 있음bea-gdp ↗
미 비농업 취업자`us_payrolls`	employment월간	천 명	자료 있음bls-series ↗
미 PCE 물가 · 전월비`us_pce_inflation_mom`	inflation월간	% 전월비	자료 있음bea-pce ↗
미 개인소비지출 · 전월비`us_pce_spending_mom`	consumption월간	% 전월비	자료 있음bea-pce ↗
미 개인소득 · 전월비`us_personal_income_mom`	income월간	% 전월비	자료 있음bea-pce ↗
미 최종수요 생산자물가 PPI`us_ppi`	inflation월간	지수 · 2009.11=100	자료 있음bls-series ↗
미 실질 가처분소득 · 전월비`us_real_disposable_income_mom`	income월간	% 전월비	자료 있음bea-pce ↗
미 실질 GDP · 전기비 연율`us_real_gdp_saar`	growth분기	% 전기비 연율	자료 있음bea-gdp ↗
미 실질 개인소비지출 · 전월비`us_real_pce_spending_mom`	consumption월간	% 전월비	자료 있음bea-pce ↗
미 민간 국내 최종수요 · 전기비 연율`us_real_private_demand_saar`	growth분기	% 전기비 연율	자료 있음bea-gdp ↗
미 주거비 CPI`us_shelter_cpi`	inflation월간	지수 · 1982–84=100	자료 있음bls-series ↗
미 국채 10년`us_treasury_10y`	미 국채일간	%	자료 있음treasury ↗
미 국채 10년−2년 금리차`us_treasury_10y_2y_spread`	미 국채일간	bp	자료 있음treasury ↗
미 국채 1.5개월`us_treasury_1_5m`	미 국채일간	%	자료 있음treasury ↗
미 국채 1개월`us_treasury_1m`	미 국채일간	%	자료 있음treasury ↗
미 국채 1년`us_treasury_1y`	미 국채일간	%	자료 있음treasury ↗
미 국채 20년`us_treasury_20y`	미 국채일간	%	자료 있음treasury ↗
미 국채 2개월`us_treasury_2m`	미 국채일간	%	자료 있음treasury ↗
미 국채 2년`us_treasury_2y`	미 국채일간	%	자료 있음treasury ↗
미 국채 30년`us_treasury_30y`	미 국채일간	%	자료 있음treasury ↗
미 국채 3개월`us_treasury_3m`	미 국채일간	%	자료 있음treasury ↗
미 국채 3년`us_treasury_3y`	미 국채일간	%	자료 있음treasury ↗
미 국채 4개월`us_treasury_4m`	미 국채일간	%	자료 있음treasury ↗
미 국채 5년`us_treasury_5y`	미 국채일간	%	자료 있음treasury ↗
미 국채 6개월`us_treasury_6m`	미 국채일간	%	자료 있음treasury ↗
미 국채 7년`us_treasury_7y`	미 국채일간	%	자료 있음treasury ↗
미 실업률`us_unemployment`	employment월간	%	자료 있음bls-series ↗
미 민간 평균 주당 근로시간`us_weekly_hours`	employment월간	시간	자료 있음bls-series ↗

경제지표 24개 · 국채 15개(만기 금리·계산 스프레드) · CFTC 12개(4개 계약별 포지션 지표). 15분마다 수집 필요 여부를 점검합니다. 원천별 실제 수집 간격은 상세 JSON에서 확인하며 발표 직후 수신을 보장하지 않습니다.

START IN MINUTES

붙여 넣고, 연결하고, 바뀐 값만 읽으세요.

OpenAPI 규격 ↗

GET /api/v1/snapshot?ids=…

선택한 최신값을 묶어 조회합니다. ids를 생략하면 상품의 전체 지표를 반환합니다. 이력은 함께 보내지 않습니다.

GET /api/v1/series/{id}?limit=120

지표 정의와 원천이 실제 제공한 관측 이력을 조회합니다. 최대 370개. 이력의 가용 길이는 지표마다 다릅니다.

GET /api/v1/changes?cursor=…

이전 snapshot 이후의 변경과 정정을 가져옵니다. 변경을 모두 반영한 뒤 next_cursor를 저장하세요.

GET /api/v1/calendar

공식 기관이 공개한 미국 경제·정책 발표 일정을 조회합니다. 미확정 발표 시각을 만들어 넣지 않습니다.

PUBLIC /catalog · /demo · /openapi.json

상품 목록·샘플·규격은 키 없이 확인할 수 있으며 유료 한도에 포함되지 않습니다.

Python 완성 예제 ↓Google Sheets 예제 ↓

# 키는 내 컴퓨터의 환경 변수에 설정하세요.
# 공유 문서·URL·Git 저장소에 키를 넣지 마세요.
curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${FINFRAME_API_KEY}" \
  -H "Accept: application/json" \
  "https://fin.ksmzzang.duckdns.org/api/v1/snapshot?ids=us_cpi%2Cus_unemployment%2Cus_treasury_10y"

Authorization: Bearer 헤더로 인증합니다. API 키를 URL·브라우저 로컬 저장소·공유 저장소에 넣지 마세요. 반복 조회는 ETag / If-None-Match를 사용하면 304 응답에 요청 한도가 차감되지 않습니다.

A CONTRACT YOU CAN READ

숫자를 해석하기 전에, 형식을 확인하세요.

날짜는 세 가지입니다.

observation_period는 수치의 기준기간, published_at는 확인된 실제 발표 시각, fetched_at는 수집 시각입니다. 발표 시각이 없으면 null이며 수집 시각으로 대신하지 않습니다.

빈 값과 단위를 보존합니다.

미제공 값은 null입니다. 0과 구분하세요. unit의 code·label·scale·kind와 변화 단위를 확인하면 %와 %포인트를 혼동하지 않을 수 있습니다.

지연을 숨기지 않습니다.

각 지표의 freshness에 상태와 수집 시각이 담깁니다. 수집 실패 시 마지막 정상 자료를 유지하며 지연을 표시합니다. 기관의 실제 발표 주기를 바꾸지는 않습니다.

BEFORE YOU SUBSCRIBE

이용 전에 확인할 내용.

무료 사이트가 있는데 무엇을 구매하나요?

공개 시장 화면과 기존 공개 JSON은 계속 무료입니다. 이 상품은 문서화한 v1 규격, 지표 일괄 조회, 관측 이력과 변경분, 개인 API 키 및 이용량 관리를 하나로 제공합니다. 원자료의 독점권이나 투자 성과를 구매하는 상품이 아닙니다.

국내 실시간 시세나 뉴스 전문도 포함되나요?

3,000회면 어느 정도 쓸 수 있나요?

여러 지표를 묶은 snapshot 1회는 성공 요청 1회입니다. 31일 동안 15분마다 1번이면 2,976회이므로 추가 조회와 재시도 여유가 적습니다. 처음에는 30분 갱신을 권장합니다. 한도는 계정의 모든 키가 공유하며 새 키를 만들어도 늘어나지 않습니다. 자동 초과 과금은 하지 않습니다. 304 응답·HEAD 확인과 실패 응답은 월간 성공 요청 한도에서 제외됩니다.

금리가 업데이트되면 과거 당시 수치까지 재현할 수 있나요?

이력은 수집 당시 원천이 제공한 현재 수정본입니다. 소급 정정은 변경분으로 알 수 있지만, 과거 각 발표 당일에 알 수 있었던 값을 모두 보관한 빈티지 데이터는 아닙니다. CFTC 주간 자료는 보고 기준일과 공개 시점이 다르며, 계약 크기가 다른 표준·마이크로 선물은 별개 지표입니다.

상업용 서비스에 다시 판매해도 되나요?

1,500원 상품의 요청 한도와 지원 범위는 개인 자동화용입니다. 데이터 원천의 권리와 필요한 출처 표시를 확인하세요. 정부가 공개한 원자료에 없는 독점적 제한을 주장하지 않습니다. 다수 이용자를 위한 서비스·대량 연동·보장된 응답시간이 필요하면 별도 서비스 계약을 검토해야 합니다. 현재 가용성 SLA는 제공하지 않습니다.

체험 종료와 구독 취소는 어떻게 되나요?

무료 체험은 카드 없이 시작하고 7일 후 종료합니다. 결제 연동이 활성화된 경우에만 별도 화면에서 월 1,500원 자동결제에 명시적으로 동의할 수 있습니다. 갱신 취소는 계정에서 처리하며 이미 결제한 기간 말까지 이용할 수 있습니다. 결제 오류나 환불은 실제 PG 결제 상태와 확인된 운영자 창구를 통해 처리합니다.

원천: BLS · BEA · Federal Reserve · U.S. Treasury · CFTC. 원기관의 제휴·보증을 뜻하지 않습니다. 기관 원자료·정의·권리 안내는 API 목록과 각 응답의 source에서 확인하세요. 개인정보 안내 · 이용 안내