canonical: https://jentic.com/apis/apiportal.wto.org/wto-timeseries

# Apiportal Wto WTO Timeseries API

The WTO Timeseries API serves international trade and tariff statistics published by the World Trade Organization over a REST interface. It exposes the indicators, reporting and partner economies, product classifications, and time periods that describe the data, and it returns the numeric time series itself for a chosen indicator, economy, and product. Calls authenticate with a subscription key passed as a query parameter.

## For AI agents

Lets an AI agent query World Trade Organization trade statistics, first discovering the available indicators, economies, and products and then retrieving the numeric time series.

## Scope

Serves World Trade Organization trade and tariff statistics only; it does not cover company-level data or non-trade indicators, so pair it with another dataset for those.

## Capabilities

- List the trade and tariff indicators available in the dataset
- List reporting and partner economies and territory regions
- List product classifications and individual products
- List available time periods, frequencies, and years
- Retrieve numeric trade statistics time series for a query
- Look up indicator categories, units, and value flags

## Use cases

### Build trade statistics dashboards

Analysts building dashboards need consistent, sourced trade figures. The WTO Timeseries API lists the available indicators and economies and returns the numeric series for a chosen query, so a dashboard can pull tariff and trade-flow data straight from the source.

Example prompt: Retrieve the annual export values for a chosen economy and present them as a series.

### Discover the dataset structure before querying

Trade data queries need valid indicator, economy, and product codes. The API lists indicators, reporting and partner economies, product classifications, and time periods, letting an integration resolve the right codes before it requests the numbers.

Example prompt: List the indicators and reporting economies so a user can pick a valid combination.

### Feed trade data into research models

Economic research pipelines ingest official trade series over time. The API returns the numeric data for an indicator, economy, and product across the covered years, so a pipeline can pull a clean series for modelling or comparison.

Example prompt: Retrieve a trade indicator series for two economies across all available years.

### Let an agent answer trade-data questions

An AI agent fielding trade or economics questions can resolve the right codes and fetch the numbers itself. Through Jentic the agent discovers the metadata and data operations by intent and runs them under the integration's subscription key, returning a sourced answer.

Example prompt: Given two economies, find the right indicator and return their trade values over time.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/indicators` | List the available trade and tariff indicators |
| GET | `/reporters` | List the reporting economies |
| GET | `/partners` | List the partner economies |
| GET | `/products` | List products in the classifications |
| GET | `/data` | Retrieve the numeric trade statistics time series |
| GET | `/years` | List the years covered by the dataset |
| GET | `/topics` | List the topics that group indicators |

## Key resources

- **Indicators** — The trade and tariff indicators available in the dataset
- **Reporters and partners** — The reporting and partner economies for a query
- **Products** — Product classifications and individual products
- **Data** — The numeric trade statistics time series
- **Periods** — Available years, frequencies, and time periods

## Why Jentic

- **Setup:** Querying WTO data yourself means learning the indicator, economy, and product codes, tracking the subscription key, and chaining metadata calls before the data call. With Jentic you install once, import WTO Timeseries from the Directory, and store the subscription key a single time.
- **Permission scoping:** Running Jentic in your own instance, you decide which WTO Timeseries operations the agent may call, so you can allow metadata and data reads while keeping the surface narrow. Access is granted per operation.
- **Credential handling:** Your WTO subscription key is held encrypted by your own Jentic One instance and injected only when a call runs, so it never appears in the agent's prompt, logs, or context.
- **Discovery method:** Agents find WTO Timeseries through Jentic's intent search: a request like get export values between two economies resolves to the right operation with inputs and auth prepared.

## Related APIs

- **US Census Bureau** — Publishes US trade and economic statistics over an API.
- **Statistics Canada** — Serves Canadian economic and trade statistics over an API.
- **Biron Analytics** — Provides access to curated statistical datasets over an API.

## FAQ

### Is there an MCP server for the WTO Timeseries API?

You do not need a dedicated MCP server. Through Jentic your self-hosted agent can call WTO Timeseries operations directly by intent, so you connect the API without maintaining separate MCP tooling.

### Can I limit which WTO Timeseries operations my agent can call?

Yes. Because you run Jentic yourself, you choose which WTO Timeseries operations your agent can call, so you can allow metadata and data reads while withholding anything you would rather keep off. Scoping is applied per operation.

### What authentication does the WTO Timeseries API use?

The API authenticates with a subscription key sent as the `subscription-key` query parameter. Jentic injects the key from your stored credential when a call runs, so it never appears in your agent's prompt.

### How do I know which indicator and economy codes to use?

The API lists indicators, reporting and partner economies, product classifications, and time periods, so you can resolve valid codes before requesting the numeric data.

### What does the data endpoint return?

The data endpoint returns the numeric trade statistics time series for a chosen indicator, economy, and product across the covered years, along with units and value flags.

### How does an agent find WTO Timeseries operations in Jentic?

The agent searches Jentic by intent, such as retrieving export values between two economies, and Jentic returns the matching operations ready to run under your subscription key.