# Trade Exposure by Country (Halowerk)

> Trade Exposure by Country (Halowerk) is a paid API for AI agents from stat.halowerk.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-14).

Returns a country's top trading partners for exports and imports with their share breakdown and trade concentration measured by the Herfindahl-Hirschman Index (HHI).

## Facts

- Endpoint: POST https://stat.halowerk.com/v1/trade-exposure
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trade-exposure-by-country-halowerk-d72b7e81
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X36e7kQmfG0_nQJW62WI8

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 trade-exposure-by-country-halowerk-d72b7e81 -d '<json body>'
```

Example prompt: Can you pull the trade exposure data for Germany — I want to see the main export partners with their shares and the HHI concentration index so I can assess how exposed they are to any single market?

## When to prefer this

Use this endpoint when you need to quantify a country's trade partner concentration and dependency risk beyond just identifying the top partner. Unlike simple rankings, this endpoint provides the HHI metric which captures the full shape of the distribution — ideal for risk models, geopolitical exposure analysis, and supply chain diversification assessments.

## Known failure modes

- Unsupported or invalid country code returns an error
- Country has insufficient trade data available, resulting in empty or partial results
- Trade direction parameter not recognized
- API call quota exceeded or payment not processed

## How this service works

Returns the main trading partners of a country for exports and imports, each with its share, and the concentration of that distribution measured by the Herfindahl-Hirschman index over partner shares. Concentration is the measure that carries the signal: a country sending thirty percent of exports to one state with the rest spread over twenty others is exposed differently from one sending thirty percent to one state and sixty to a second, and the largest partner is identical in both cases.

## Output

A structured response listing the top trading partners for exports and imports of the requested country, each with its percentage share of total trade, plus the Herfindahl-Hirschman Index (HHI) value summarizing the overall concentration of the partner distribution — higher HHI signals greater dependence on fewer partners.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "flow": {
   "enum": [
    "exports",
    "imports",
    "both"
   ],
   "type": "string",
   "default": "both"
  },
  "reporter": {
   "type": "string",
   "default": "EU27_2020",
   "maxLength": 12,
   "minLength": 2,
   "description": "Reporting economy. The source publishes partner-level long-term trade for the EU aggregate (EU27_2020) and the euro area (EA20); individual member states are not carried in this series."
  },
  "top_partners": {
   "type": "integer",
   "default": 12,
   "maximum": 30,
   "minimum": 3
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trade-exposure-by-country-halowerk-d72b7e81/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stat.halowerk.com](https://www.zero.xyz/host/stat.halowerk.com/llms.txt)