Climate Indices

Query climate oscillation indices (ENSO, NAO, AO, PDO, QBO, sunspots, etc.).

Query climate indices data

post

Query climate oscillation indices timeseries data.

Available indices (43 series):

• Atmospheric oscillations: NAO, AO, AAO, PNA, PDO, QBO, AMO, SOI, WPO, EPO, GBI

• Teleconnections: EA, SCAND, EAWR, TNH

• ENSO: ENSO_NINO12, ENSO_NINO3, ENSO_NINO4, ENSO_NINO34 (and their _ANOM variants), MEI, ONI

• Atlantic SST: TNA, TSA, AMM

• MJO (Wheeler-Hendon RMM, daily): MJO_RMM1, MJO_RMM2, MJO_PHASE, MJO_AMPLITUDE

• MJO (CPC velocity-potential, pentad): MJO_20E..MJO_10W (10 longitude series)

• Solar: SUNSPOT

Sources: noaa_psl, noaa_cpc, bom, sidc

Temporal resolution: monthly for most indices; daily for BOM RMM MJO; pentad (5-day) for CPC VP-MJO.

Response Formats:

• json: Columnar JSON format {column: [values], ...}

• arrow: Apache Arrow IPC stream for efficient processing

Authentication: Requires API key.

Authorizations

HTTPBearer

Query parameters

formatstring · enumOptional

Response format: 'json' or 'arrow'

Default: jsonPossible values:

include_unitsbooleanOptional

When true, JSON responses are wrapped in {data, units}.

Default: false

Body

application/json

Query parameters for climate indices timeseries data.

indicesany ofOptional

Climate indices to query. If not set, returns all.

Example: ["NAO","ENSO_NINO34"]

or

nullOptional

sourcesany ofOptional

Data sources to filter by (e.g. 'noaa_psl', 'noaa_cpc', 'sidc').

string[]Optional

or

nullOptional

start_timestring · date-timeRequired

Start time for the query (inclusive)

Example: 2020-01-01T00:00:00Z

end_timeany ofOptional

End time for the query (exclusive). If None, no upper bound.

Example: 2025-01-01T00:00:00Z

string · date-timeOptional

or

nullOptional

time_zoneany ofOptional

IANA time zone for time formatting (e.g. 'Europe/Berlin').

Example: UTC

stringOptional

or

nullOptional

order_byany ofOptional

Columns to order by (e.g. 'time__desc').

Example: ["time"]

or

nullOptional

paginationany ofOptional

Pagination parameters

or

nullOptional

Responses

200

Successfully retrieved climate indices data

application/jsonapplication/vnd.apache.arrow.stream

anyOptional

400

Invalid query parameters

401

Authentication required

422

Validation Error

application/json

post

/v1/climate-indices/data

HTTPcURLJavaScriptPython

POST /v1/climate-indices/data HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 103

{
  "indices": [
    "ENSO_NINO34",
    "NAO"
  ],
  "start_time": "2020-01-01T00:00:00Z",
  "end_time": "2025-01-01T00:00:00Z"
}

Query ENSO and NAO indicesQuery all indices (recent)

{
  "time": [
    "2020-01-01T00:00:00Z",
    "2020-02-01T00:00:00Z"
  ],
  "index_name": [
    "NAO",
    "NAO"
  ],
  "value": [
    0.56,
    -0.3
  ],
  "unit": [
    "index",
    "index"
  ]
}

List available climate indices

get

Get a list of available climate oscillation indices with metadata.

Authentication: Requires API key.

Authorizations

HTTPBearer

Responses

200

Successful Response

application/json

Result for available climate indices query.

get

/v1/climate-indices/indices

HTTPcURLJavaScriptPython

GET /v1/climate-indices/indices HTTP/1.1
Accept: */*

200

Successful Response

{
  "indices": [
    {
      "name": "text",
      "description": "text",
      "unit": "text"
    }
  ]
}

List available climate indices data sources

get

Get a list of available data sources for climate indices.

Authentication: Requires API key.

Authorizations

HTTPBearer

Responses

200

Successful Response

application/json

Result for available climate indices data sources query.

sourcesstring[]Required

get

/v1/climate-indices/sources

HTTPcURLJavaScriptPython

GET /v1/climate-indices/sources HTTP/1.1
Accept: */*

200

Successful Response

{
  "sources": [
    "text"
  ]
}