API 문서
계정 API 키로 시장 데이터와 원래 날짜의 관측값을 조회합니다.
인증 및 접근
HTTPS의 X-API-Key 헤더로 키를 전송하세요. 로그인 토큰과 수집 키는 조회 키로 사용할 수 없습니다. URL에 넣거나 공개하지 마세요.
아직 구독을 판매하지 않습니다. 평가 이용은 초대제로 요금이 부과되지 않습니다.
데이터셋 및 관측값
먼저 목록을 조회하고 반환된 ID를 사용하세요. 가격에는 frequency·startDate·endDate, 수주에는 원래 월간·연간 형식의 startPeriod·endPeriod가 필요합니다.
원래 단위·통화·지역·빈도·통계 기준을 유지하며 보간, 가상 가격 및 자동 환산을 하지 않습니다.
limit는 1~1,000이며 nextAfter를 다음 after로 사용하고 필터는 유지하세요. 커서는 제외되며 빈 응답은 0 가격이 아닙니다.
사용량 및 오류
인증 후 허용된 조회는 오류도 월 요청량에 포함됩니다. 반환된 목록 행과 관측값은 기록량에 포함되며 키가 계정 한도를 공유하고 UTC 월초에 초기화됩니다.
400은 매개변수, 401은 키, 403은 비활성 권한, 404는 공개 데이터 없음, 429는 한도, 503은 평가 비활성화입니다. Retry-After 60초는 최소 대기이며 월 한도 복구를 뜻하지 않습니다.
조회는 GET만 지원하며 거래 실행, 투자 권유, 계정·초안·관리 기록 노출을 하지 않습니다.
GET /api/v1/datasets?limit=100 GET /api/v1/prices/{id}/observations?frequency=daily&startDate=2026-01-01&endDate=2026-01-31 GET /api/v1/ship-orders/{id}/observations?startPeriod=2025-01&endPeriod=2025-12 X-API-Key: YOUR_API_KEY