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 (46 series):

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

• Teleconnections: EA, SCAND, EAWR, TNH, POL, EPNP

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

• Atlantic SST: TNA, TSA, AMM

• Indian Ocean: IOD

• 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, noaa_ncei, bom, sidc, wisc_aos

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

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

Query parameters for climate indices timeseries data.

sourcesstring[] · nullableOptional

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

start_timestring · date-timeRequired

Start time for the query (inclusive)

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

end_timestring · date-time · nullableOptional

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

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

time_zonestring · nullableOptional

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

Example: UTC

Responses

200

Successfully retrieved climate indices data

anyOptional

400

Invalid query parameters

401

Authentication required

422

Validation Error

application/json

post/v1/climate-indices/data

POST /v1/climate-indices/data HTTP/1.1
Host: query.jua.ai
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"
}

{
  "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

Responses

200

Successful Response

application/json

Result for available climate indices query.

422

Validation Error

application/json

get/v1/climate-indices/indices

GET /v1/climate-indices/indices HTTP/1.1
Host: query.jua.ai
Accept: */*

{
  "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

Responses

200

Successful Response

application/json

Result for available climate indices data sources query.

sourcesstring[]Required

422

Validation Error

application/json

get/v1/climate-indices/sources

GET /v1/climate-indices/sources HTTP/1.1
Host: query.jua.ai
Accept: */*

{
  "sources": [
    "text"
  ]
}