# KMDE Data API — Korea HS854232 Trade Statistics (Vietnam)

> KMDE Data API — Korea HS854232 Trade Statistics (Vietnam) 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 24-month Korea-to-Vietnam export trade statistics for HS code 854232 (electronic memory integrated circuits) as a signed, versioned JSON snapshot.

## Facts

- Endpoint: GET https://kmde-snapshot-candidate.onrender.com/v1/trade/hs854232/VN.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-vietnam-793fcc42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QrmzDputpenYJ0jblsstM

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-vietnam-793fcc42
```

Example prompt: Pull the Korea HS854232 electronic memory chip export statistics for Vietnam — I need the monthly USD FOB figures and year-over-year data from the KMDE snapshot.

## When to prefer this

Choose this endpoint when you need structured, versioned, machine-readable Korean export trade statistics specifically for electronic memory integrated circuits (HS 854232) to a specific partner country. It is preferable to scraping raw Korean customs or KITA portals because it provides pre-parsed JSON with provenance hashes. The fixed $0.005 USDC per-call pricing via x402 makes it suitable for automated agent pipelines. Use it over generic trade data APIs when you need the specific HS 854232 semiconductor memory category with Korean origin data.

## Known failure modes

- Unsupported country code returns validation error (only CN, HK, VN, TW, US, JP accepted)
- Payment not provided or rejected returns HTTP 402 requiring x402 USDC micropayment
- Service unavailable on Render cold start may cause slow initial response or timeout
- Snapshot data may have lag if upstream Korean customs XML has not been published for latest period
- SHA-256 mismatch if snapshot file is corrupted in transit

## How this service works

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

## Output

A versioned JSON snapshot containing: scope metadata (HS code, direction, period, destination country), an array of monthly export records (period, USD FOB amount, YoY percent change, row state, source XML hash), snapshot identity (ID, SHA-256, collection timestamp), product ID, and record count — typically 24 monthly records covering a rolling 2-year window.

## 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": "Vietnam",
   "reporting_country": "KR",
   "destination_country": "VN"
  },
  "records": [
   {
    "period": "202409",
    "country": "VN",
    "hs_code": "854232",
    "direction": "export",
    "row_state": "OBSERVED",
    "weight_kg": null,
    "yoy_state": "NO_MATCHING_PRIOR_PERIOD",
    "amount_usd": "698290997",
    "yoy_percent": null,
    "amount_basis": "FOB",
    "amount_state": "OBSERVED",
    "source_xml_sha256": "4c982c524166f0daf3e9beed5f3e94927a5cf80f58141a2a3e0f07edd73153da",
    "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-vietnam-793fcc42/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)