> For the complete documentation index, see [llms.txt](https://doc.re-cast.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.re-cast.ai/encored-renewable-api-ko/api/recast-nwp.md).

# RE:Cast NWP

실시간 수치 예보 데이터를 제공합니다. 과거 기간의 예보 데이터를 조건에 맞게 가공하거나, 단일 또는 2개 이상의 수치 예보 데이터를 결합하여 하나의 데이터로 제공합니다.

사용 가능한 모델 조합 코드명(modelComb)은 담당자에게 문의하시기 바랍니다.

## 시간대(Timezone) 안내

기본적으로 입·출력 시각은 모두 **로컬타임(KST)** 기준입니다. 단, 예보자료의 **cycle을 특정하는 파라미터**만 예외적으로 **UTC**로 입력해야 합니다.

* **로컬타임(KST)** 로 입·출력되는 값
  * 대상시각 `basetime` (`yyyymmddhhmmss`)
  * 반환 자료 내 변수값 `issueddate` (`yyyymmdd`, str), `issuedhour` (`hhmm`, str)
  * 요청 파라미터 `startTime`, `endTime` (`yyyymmddhhmmss`)
* **UTC**로 입력해야 하는 값 (예보자료 cycle 특정)
  * `recent`의 기준일시 `issuedDateCycle` (`yyyymmddhh`, UTC)
  * `recent-dayahead`의 기준시각 `hh` (`hh`, UTC)

## most-recent

가장 마지막 cycle에 발표된 예보를 반환합니다. NWP 모델 조합을 선택하여 한 번의 조회로 복수의 모델 결과를 얻을 수 있습니다.

{% openapi src="/files/0GZ3sMA70guz0qUHDedF" path="/nwp/v2/most-recent" method="get" %}
[nwp\_v2\_ko.json](https://3936238488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtW5eNQOiW7uSnoYZgwz9%2Fuploads%2Fgit-blob-6acc03dcd8074c2a346305e7ba884bd1b361a402%2Fnwp_v2_ko.json?alt=media)
{% endopenapi %}

## recent

특정 일자(최근 90일 이내)의 특정 cycle에 발표된 예보를 반환합니다. NWP 모델 조합을 선택하여 한 번의 조회로 복수의 모델 결과를 얻을 수 있습니다.

{% openapi src="/files/0GZ3sMA70guz0qUHDedF" path="/nwp/v2/recent" method="get" %}
[nwp\_v2\_ko.json](https://3936238488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtW5eNQOiW7uSnoYZgwz9%2Fuploads%2Fgit-blob-6acc03dcd8074c2a346305e7ba884bd1b361a402%2Fnwp_v2_ko.json?alt=media)
{% endopenapi %}

## recent-dayahead

최근 14일간의 예보에 대해서 특정 hh 시각의 cycle에 발표된 D+1에 대한 예보만을 반환합니다.

{% openapi src="/files/0GZ3sMA70guz0qUHDedF" path="/nwp/v2/recent-dayahead" method="get" %}
[nwp\_v2\_ko.json](https://3936238488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtW5eNQOiW7uSnoYZgwz9%2Fuploads%2Fgit-blob-6acc03dcd8074c2a346305e7ba884bd1b361a402%2Fnwp_v2_ko.json?alt=media)
{% endopenapi %}

## recent-latest

최근 14일간의 모든 기준일시(`yyyymmddhh`) cycle 자료 내에서 각 basetime마다 가장 마지막 예보값만을 반환합니다.

{% openapi src="/files/0GZ3sMA70guz0qUHDedF" path="/nwp/v2/recent-latest" method="get" %}
[nwp\_v2\_ko.json](https://3936238488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtW5eNQOiW7uSnoYZgwz9%2Fuploads%2Fgit-blob-6acc03dcd8074c2a346305e7ba884bd1b361a402%2Fnwp_v2_ko.json?alt=media)
{% endopenapi %}

## past

과거 예보기상 데이터로부터 해당 basetime 범위 + filters 조건을 적용한 결과를 반환합니다. `filters` 파라미터로 `dayoffset`, `issuedhour` 등의 조건을 적용하면 최대 3주+ 범위까지 요청 가능합니다. 데이터 보관 상한은 90일(s3 수명주기)입니다.

{% openapi src="/files/0GZ3sMA70guz0qUHDedF" path="/nwp/v2/past" method="get" %}
[nwp\_v2\_ko.json](https://3936238488-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtW5eNQOiW7uSnoYZgwz9%2Fuploads%2Fgit-blob-6acc03dcd8074c2a346305e7ba884bd1b361a402%2Fnwp_v2_ko.json?alt=media)
{% endopenapi %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.re-cast.ai/encored-renewable-api-ko/api/recast-nwp.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.