# SiteCheck Trade & Energy – China Customs Tariff Lookup (WITS/TRAINS)

> SiteCheck Trade & Energy – China Customs Tariff Lookup (WITS/TRAINS) is a paid API for AI agents from api.tradeenergy-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns China's applied MFN import tariff rates (simple average, min, max), number of tariff lines, and data year for a given 6-digit HS code from the World Bank WITS/UNCTAD TRAINS database.

## Facts

- Endpoint: GET https://api.tradeenergy-api.workers.dev/api/logistics/china-customs-tariffs?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-trade-energy-china-customs-tariff-lookup-wits-trains-ebbe6ea6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vcsrfFegd452kvZSuASKo

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 sitecheck-trade-energy-china-customs-tariff-lookup-wits-trains-ebbe6ea6
```

Example prompt: What is China's current MFN import tariff rate for HS code 731815 (bolts)? I need the simple average, minimum, and maximum duty rates and the number of tariff lines.

## When to prefer this

Use this endpoint when you need official World Bank WITS/UNCTAD TRAINS MFN tariff data for China (or another reporting country) at the HS-6 level, including aggregate statistics (simple average, min, max, line count). Prefer this over scraping customs authority websites when you need structured, programmatic access to internationally standardized tariff data. Note: this does not include VAT, consumption tax, retaliatory surcharges, or preferential/FTA rates — use alternative sources for those.

## Known failure modes

- Invalid or non-existent HS code returns an error or empty result
- HS code provided at 8 or 10 digit level instead of 6 digits may not match
- No tariff data available for a given reporter/HS combination returns null or empty
- Invalid ISO numeric country code returns an error
- WITS upstream database unavailable causes a service error
- Data may lag by 1-2 years depending on country reporting to UNCTAD TRAINS

## How this service works

China's applied import tariff for a 6-digit HS code from the World Bank WITS tariff database (UNCTAD TRAINS, as reported by China): MFN simple average, minimum and maximum duty rate across the national tariff lines, number of lines and the year. HS-6 level, not the 8/10-digit China customs line; VAT, consumption tax and retaliatory surcharges are not included. Another reporting country can be chosen with its ISO numeric code.

## Output

A JSON object containing the 6-digit HS code, the reporting country ISO code, the tariff type (MFN), the simple average duty rate percentage, the minimum and maximum duty rate percentages, the number of national tariff lines, the data year, the nomenclature level (H6), a timestamp of when the data was checked, and the source URL pointing to the World Bank WITS API.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "hs"
     ],
     "properties": {
      "hs": {
       "type": "string",
       "description": "6-digit HS code, e.g. 731815 (bolts)"
      },
      "reporter": {
       "type": "string",
       "description": "Optional ISO numeric country code of the importer (default 156 = China), e.g. 392 Japan, 356 India"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hs": "731815",
  "year": 2023,
  "source": "https://wits.worldbank.org/API/V1/SDMX/V21/datasource/TRN/reporter/156/partner/000/product/731815/year/2023/datatype/reported",
  "reporter": "156",
  "checkedAt": "2026-10-23T09:38:06.509Z",
  "maxRatePct": 8,
  "minRatePct": 8,
  "tariffType": "MFN",
  "tariffLines": 4,
  "nomenclature": "H6",
  "simpleAveragePct": 8
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-trade-energy-china-customs-tariff-lookup-wits-trains-ebbe6ea6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeenergy-api.workers.dev](https://www.zero.xyz/host/api.tradeenergy-api.workers.dev/llms.txt)
