문서
데이터 최신성
Narwhal은 승인된 공식 발표를 저장한 뒤 API 요청 중 출처를 호출하지 않고 이를 제공합니다.
최신은 Narwhal이 검증하고 게시한 가장 최근의 완전한 공식 발표를 의미합니다. 고객 요청이 매번 공식 출처를 실시간으로 호출한다는 뜻은 아닙니다.
응답의 출처
성공한 각 REST 또는 MCP 요청은 Narwhal에 저장된 현재 발표를 읽습니다. 출처 웹사이트, 파일 및 API는 수집 시스템이 별도로 확인합니다.
이를 통해 고객 응답 시간은 공식 출처의 속도나 일시적 장애와 무관하게 유지됩니다.
발표를 업데이트하는 방법
- 예약된 워커가 새 발행본이 있는지 공식 소스를 확인합니다.
- Narwhal은 출처 자료를 가져와 식별 정보, 기간, 필드 및 완전성을 검증합니다.
- 정규화된 관측값과 보조 근거가 함께 저장됩니다.
- 전체 발표가 통과된 후에만 Narwhal은 이를 고객에게 반환할 버전으로 지정합니다.
불완전하거나 유효하지 않은 후보는 공개 응답에 절대 섞이지 않습니다.
최신성 필드의 의미
| 필드 또는 신호 | 의미 |
|---|---|
period | 공식 관측값이 나타내는 월, 분기 또는 연도입니다. |
released_on | 공식 발표일입니다. Narwhal의 조회 또는 게시 시각이 아닙니다. |
as_of | 과거 데이터 응답에서, 페이지의 가장 최근 관측값을 소스가 마지막으로 갱신한 시각입니다. UTC의 정수 초 단위입니다. |
observed_at | 단일 캘린더 발표에서, Narwhal이 발표 기관의 캘린더에서 해당 발표를 마지막으로 확인한 시각입니다. |
timestamp, market_session | FX와 현물 가격에서는 가격이 속하는 UTC 시각입니다. FX에서는 시장 상태도 나타냅니다. |
| 최신 데이터 요청 | 생략 period 매개변수를 생략하면 현재 Narwhal에 저장된 승인 완료 상태의 완전한 최신 발표 데이터를 요청합니다. |
| 정확한 기간 요청 | 전달 period 매개변수에 지정한 발표 기간을 요청합니다. 해당 기간은 현재 공식 발표에서 계속 제공되고 있어야 합니다. |
stale | 원자재 현물, FX, 예측 이벤트 응답에는 stale이 포함됩니다. 현물과 FX에서 stale: true는 시장이 열린 동안 값이 오래된 상태라는 뜻입니다. 소스가 오래된 값으로 표시했거나, 시장이 열린 시간만 계산하여 값이 10분 넘게 갱신되지 않은 경우입니다. 시장 폐장만으로 현물이나 FX 값이 오래된 것으로 처리되지는 않습니다. 예정 또는 거래 중인 예측 이벤트는 거래소 확인 없이 3분이 지나면 오래된 것으로 처리됩니다. 예측 레퍼런스를 참조하세요. 값은 마지막으로 알려진 값이며, timestamp는 그 값이 설정된 시각을 나타냅니다(예측 이벤트에서는 as_of). |
응답은 위 필드 외에 Narwhal의 수집 타임스탬프를 노출하지 않습니다. 알려진 발표가 지연되는 것으로 보이면 공식 발표 캘린더를 확인하고 요청 ID와 함께 지원팀에 문의하세요.
출처 확인에 실패할 때
Narwhal은 마지막 승인 발표를 계속 제공합니다. 이를 삭제하거나 누락값을 0으로 바꾸거나 부분 업데이트를 게시하지 않습니다.
출처 확인에 실패하면 정해진 일정에 따라 다시 시도합니다. Narwhal이 승인된 발표 데이터를 안전하게 제공할 수 없으면 불확실한 데이터를 반환하는 대신 문서에 명시된 오류로 요청을 실패 처리합니다. 오류 상태: 503 문제 응답입니다.
공개 베타 이용 시 기대 사항
- 베타 기간에는 출처의 발표부터 Narwhal의 게시까지 걸리는 시간을 일정하게 보장하지 않습니다.
- 고객 API 지연 시간은 저장된 데이터를 읽는 데 걸리는 시간이며 새로운 공식 발표를 수집하는 데 필요한 시간은 포함하지 않습니다.
- 공식 기관은 특정 기간의 데이터를 수정할 수 있으므로, 이후 승인된 발표 데이터가 이전에 저장된 값을 대체할 수 있습니다.
- Narwhal API의 코어 엔드포인트와 MCP 도구가 제공하는 주요 경제 지표 수치는 잠정적인 최초 추정치일 수 있으며, 응답에는 잠정치임이 표시되지 않고, 출처에서 확정치를 발표하면 해당 값으로 대체됩니다.
다음으로 계속 진행하세요: 경제 데이터 API 레퍼런스 또는 검토합니다 오류 및 재시도.