# Comtrade Annual Imports Total

> Comtrade Annual Imports Total is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the total annual merchandise import value (all commodities, all partners) for a given reporter country in 2023, identified by numeric UN Comtrade country code.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/comtrade-annual-imports-total
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/comtrade-annual-imports-total-31f1623d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Yxufh8cCdk6DlmdSEAU_r

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 comtrade-annual-imports-total-31f1623d -d '<json body>'
```

Example prompt: What were the total merchandise imports for the USA in 2023? Use the Comtrade annual imports endpoint with country code 842.

## When to prefer this

Use this endpoint when you need a single aggregated total of all merchandise imports for a specific country in 2023, across all commodities and all trade partners, identified by the UN Comtrade numeric reporter code. Prefer this over more granular trade endpoints when you only need the top-line import figure rather than commodity- or partner-level breakdowns.

## Known failure modes

- Invalid or unrecognized numeric country code returns an error or empty result
- Country code not found in Comtrade 2023 dataset returns null or empty data
- Missing q parameter causes a bad request error
- Non-numeric value for q parameter causes a parse or validation error
- Network timeout or service unavailability returns a 5xx error

## How this service works

Total annual merchandise imports (all commodities, all partners) for a reporter country in 2023; q = numeric reporter code (e.g. 842=USA, 156=China, 392=Japan). Query: ?q= Returns JSON.

## Output

A JSON object containing the total annual merchandise import value (all commodities, all partner countries) for the requested reporter country in 2023, keyed by the numeric UN Comtrade country code provided.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/comtrade-annual-imports-total-31f1623d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)