# KMDE Data API — Korea HS854232 Trade Statistics by Country (CN Slice)

> KMDE Data API — Korea HS854232 Trade Statistics by Country (CN Slice) is a paid API for AI agents from kmde-snapshot-candidate.onrender.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-15).

Returns a 24-month time series of South Korea's HS854232 (electronic memory ICs) export trade statistics to China, including FOB USD amounts, period-over-period comparisons, and data provenance metadata.

## Facts

- Endpoint: GET https://kmde-snapshot-candidate.onrender.com/v1/trade/hs854232/CN.json?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kmde-data-api-korea-hs854232-trade-statistics-by-country-cn-slice-a50f91c1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cRlEJjp_NpPv1hOHTT_GX

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 kmde-data-api-korea-hs854232-trade-statistics-by-country-cn-slice-a50f91c1
```

Example prompt: Can you pull the South Korea HS854232 electronic memory IC export trade statistics to China — I need the monthly FOB USD figures and year-over-year changes for the past 24 months.

## When to prefer this

Choose this endpoint when you specifically need South Korea's HS854232 (electronic memory IC) bilateral export trade statistics broken down by month for one of the six supported destination countries (CN, HK, VN, TW, US, JP). It is best suited for semiconductor trade analysis, supply chain research, or economic monitoring tasks requiring verified, FOB-denominated USD figures with data provenance hashes. Not suitable for other HS codes, import data, or countries outside the supported set.

## Known failure modes

- Invalid or unsupported country code (only CN, HK, VN, TW, US, JP are accepted) returns an error
- Service unavailability on Render.com free tier may cause cold-start delays or 502 errors
- Stale snapshot if data has not been refreshed recently — check snapshot.collected_at
- Payment failure via x402 protocol may block access
- Data may show NO_MATCHING_PRIOR_PERIOD for yoy_percent if historical baseline is absent

## How this service works

한국 HS854232 무역 통계, 코스닥 OpenDART 7일 공시 목록과 Base ERC-20 계약 기초 사실의 무료 목록·샘플 및 x402 고정 버전 JSON API.

## Output

A JSON object containing: a scope block describing the HS code, direction, period range, destination country, and units; an array of monthly trade records (each with period, country, HS code, direction, amount_usd in FOB, weight_kg if collected, yoy_percent, row_state, and source XML SHA256); a product_id; record_count (typically 24); a snapshot block with collection timestamp and data integrity SHA256; and a schema version string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "headers": {
     "type": "object",
     "properties": {
      "Idempotency-Key": {
       "type": "string",
       "pattern": "^[!-~]+$",
       "maxLength": 128,
       "minLength": 1,
       "description": "Optional stable key for an exact signed retry."
      }
     },
     "additionalProperties": false
    },
    "pathParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "country": {
       "enum": [
        "CN",
        "HK",
        "VN",
        "TW",
        "US",
        "JP"
       ],
       "type": "string",
       "description": "Destination ISO alpha-2 code."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "format",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "format": {
     "type": "string",
     "const": "application/json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "format": "application/json",
 "example": {
  "scope": {
   "hs_code": "854232",
   "hs_label": "Memories (electronic integrated circuits)",
   "direction": "export",
   "period_end": "202608",
   "amount_unit": "USD FOB",
   "period_start": "202409",
   "weight_state": "NOT_COLLECTED",
   "destination_name": "China",
   "reporting_country": "KR",
   "destination_country": "CN"
  },
  "records": [
   {
    "period": "202409",
    "country": "CN",
    "hs_code": "854232",
    "direction": "export",
    "row_state": "OBSERVED",
    "weight_kg": null,
    "yoy_state": "NO_MATCHING_PRIOR_PERIOD",
    "amount_usd": "2230456350",
    "yoy_percent": null,
    "amount_basis": "FOB",
    "amount_state": "OBSERVED",
    "source_xml_sha256": "63610bbd98cb269e699ab8babd3e3fe0645a45c900352d9403a7139e75e8e27b",
    "source_detail_count": 7
   }
  ],
  "version": "1.0.0-202608",
  "snapshot": {
   "id": "pc2-20261001T132500Z-hs854232-24m-metadata-v2",
   "sha256": "bc3efe5fceb8379f3540822f9536ffc1acddeb3a88b44fbae1d4e05d766660f7",
   "collected_at": "2026-10-01T13:05:16.471745+00:00",
   "source_published_at": null
  },
  "product_id": "korea-hs854232-country-slice-v1",
  "record_count": 24
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kmde-data-api-korea-hs854232-trade-statistics-by-country-cn-slice-a50f91c1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kmde-snapshot-candidate.onrender.com](https://www.zero.xyz/host/kmde-snapshot-candidate.onrender.com/llms.txt)