Skip to main content
sdmx-dl
GitHub Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
  1. sdmx-dl
  2. /
  3. Features
  4. /
  5. Output and formats

Output and formats

Pick the right output for your use case: Java objects for the library, CSV for shell pipelines, or JSON/protobuf for a remote service.

The API is object-centric and can be used with the supported format modules and managers. A common entry point is the Java library or the standalone JAR distribution.

//JAVA 25+
//DEPS com.github.nbbrd.sdmx-dl:sdmx-dl-standalone:3.2.0
import sdmxdl.DataRequest;
import sdmxdl.web.SdmxWebManager;

void main() throws Exception {
    SdmxWebManager
            .ofServiceLoader()
            .usingName("ECB")
            .getData(DataRequest.builder()
                    .flowOf("EXR")
                    .keyOf("M.CHF.EUR.SP00.A")
                    .build())
            .forEach(series -> IO.println(series.getKey()));
}

The CLI writes RFC4180 CSV to standard output by default and supports file output, gzip, append, and encoding options.

sdmx-dl fetch data ECB EXR M.CHF.EUR.SP00.A -o chf.csv -z

The web service exposes two transport formats:

  • gRPC: protobuf messages on port 4557
  • REST: JSON over HTTP on port 4559

gRPC 

grpcurl -d '{"source":"ECB","flow":"EXR","key":"M.CHF.EUR.SP00.A"}' -plaintext localhost:4557 sdmxdl.grpc.v2.SdmxWebManager.GetData

REST 

curl "localhost:4559/sdmx-dl/v2/ECB/EXR/data?key=M.CHF.EUR.SP00.A"

Supported file formats

sdmx-dl also reads/writes several standard SDMX and interchange formats (SDMX-ML Generic/Compact Data, SDMX-ML Structure, CSV, protobuf, Kryo) — see the Formats section for details.

Notes

  • This page is about output shape per flavor, not wire formats; see Formats for the on-disk/on-wire encodings.
  • The CLI’s -o/-z/--encoding options only affect how CSV is written (file vs stdout, gzip, character set) — the CSV field layout itself doesn’t change.
gdoc_arrow_left_alt Monitor and status