# World Bank Trade History by Country

> World Bank Trade History by Country is a paid API for AI agents from economy.openverbs.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-29).

Returns annual imports and exports of goods and services (current USD and % of GDP) for a given ISO3 country over the last 1–10 complete years, sourced from World Bank WDI.

## Facts

- Endpoint: POST https://economy.openverbs.com/v1/trade?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/world-bank-trade-history-by-country-5400a609
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n37ldbGCEjlzrrvPfnJZt

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability world-bank-trade-history-by-country-5400a609 -d '<json body>'
```

Example prompt: Pull the last 8 years of World Bank trade data for Brazil — I want annual imports and exports both in current USD and as a share of GDP.

## When to prefer this

Choose this endpoint when you need official World Bank WDI annual aggregate trade totals (imports/exports in USD or % of GDP) for a single country. It is ideal for macroeconomic analysis, country risk profiling, and development research. Prefer it over bilateral trade databases when you need national-account-level figures rather than product, tariff, or partner-specific flows. Use sibling endpoints on economy.openverbs.com for GDP, inflation, labor, or population data from the same WDI source.

## Known failure modes

- Invalid or unsupported ISO3 country code returns an error (no region aggregates like EU or WLD accepted)
- Requested years out of range (less than 1 or more than 10) returns a validation error
- Recent years with missing World Bank observations are returned as null rather than filled or interpolated
- Payment failure (x402) if USDC balance is insufficient
- Network timeout if World Bank WDI upstream is slow

## How this service works

Country trade history from World Bank WDI: imports and exports of goods and services in current USD and as % of GDP. ISO3 country, last 1-10 complete years, independent latest values, units, nulls, source update date and CC BY attribution. Annual national-account totals, not bilateral flows, product-level trade, tariffs or shipments; USD values are not inflation-adjusted.

## Output

Returns a time series (up to 10 annual observations) for the requested country containing: imports of goods and services in current USD, exports of goods and services in current USD, imports as % of GDP, exports as % of GDP — plus metadata such as units, null flags for missing observations, source update date, and CC BY attribution. Values are nominal (not inflation-adjusted). No bilateral flows, product-level breakdowns, tariffs, or shipment data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "years": {
   "type": "integer",
   "default": 5,
   "maximum": 10,
   "minimum": 1,
   "description": "Last N complete calendar years in UTC, resolved before payment. Missing observations are not filled."
  },
  "country": {
   "type": "string",
   "pattern": "^[A-Za-z]{3}$",
   "description": "ISO 3166 alpha-3 code for one of 215 World Bank-supported countries/territories, e.g. BRA, IND or ZAF. No region aggregates."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/world-bank-trade-history-by-country-5400a609/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from economy.openverbs.com](https://www.zero.xyz/host/economy.openverbs.com/llms.txt)