# KMDE Data API — Korea HS854232 Trade Statistics (Japan Slice)

> KMDE Data API — Korea HS854232 Trade Statistics (Japan 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 24 months of South Korea's electronic memory (HS 854232) export trade statistics to Japan, including monthly USD FOB amounts and year-over-year comparisons.

## Facts

- Endpoint: GET https://kmde-snapshot-candidate.onrender.com/v1/trade/hs854232/JP.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-japan-slice-52def804
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2fkoMWyWh-uSgwvrMbtl0

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-japan-slice-52def804
```

Example prompt: Can you pull South Korea's monthly export statistics for electronic memory chips (HS 854232) to Japan for the past 24 months, including the USD FOB amounts and year-over-year changes?

## When to prefer this

Choose this endpoint when you need structured, time-series South Korean export trade data specifically for electronic memory integrated circuits (HS 854232) to one of six supported destination countries, delivered as clean JSON with integrity hashes. It is ideal for trade analysis, supply chain monitoring, and semiconductor market research where official Korea Customs-sourced FOB data is required. Prefer this over scraping raw customs XML yourself, or over general trade databases that lack HS-code-level granularity or machine-readable snapshots.

## Known failure modes

- Invalid or unsupported country code returns an error (only CN, HK, VN, TW, US, JP are accepted)
- Payment not processed (x402 payment required, insufficient USDC balance causes rejection)
- Snapshot data may be stale if source has not been refreshed (source_published_at may be null)
- YoY values absent if no matching prior-period record exists (yoy_state: NO_MATCHING_PRIOR_PERIOD)
- Weight data not collected for all records (weight_kg may be null)
- Service downtime on Render.com free/low-tier hosting may cause intermittent 503 errors

## How this service works

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

## Output

Returns a JSON object containing: a scope block (HS code, label, direction, period range, units, destination), an array of up to 24 monthly records (each with period, USD FOB amount, YoY percent change, row state, and source XML hash), a product ID, version, record count, and a snapshot block with collection timestamp and SHA-256 integrity hash.

## 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": "Japan",
   "reporting_country": "KR",
   "destination_country": "JP"
  },
  "records": [
   {
    "period": "202409",
    "country": "JP",
    "hs_code": "854232",
    "direction": "export",
    "row_state": "OBSERVED",
    "weight_kg": null,
    "yoy_state": "NO_MATCHING_PRIOR_PERIOD",
    "amount_usd": "59737434",
    "yoy_percent": null,
    "amount_basis": "FOB",
    "amount_state": "OBSERVED",
    "source_xml_sha256": "e7bc70c863f548cdce24daa946f07682eb9cca1a1a86b6674415072dc5a952b0",
    "source_detail_count": 6
   }
  ],
  "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-japan-slice-52def804/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)