{
  "x402Version": 2,
  "id": 34845,
  "slug": "34845",
  "resource": "https://1gateway.dev/v1/trade/hs",
  "description": "Use when you need South Korea's monthly trade for a product by HS code (e.g. 8542 chips, 870323 cars, 2710 petroleum). Data: Korea Customs Service, finalized monthly. Input: hs (2-10 digit prefix), optional month (YYYYMM, default latest), limit (1-100), sort (exports, imports, balance, total). Output: JSON totals (exports FOB, imports CIF, balance in USD, kg) with YoY % and 10-digit HSK lines with English HS descriptions and YoY. Example: ?hs=8542&month=202608",
  "type": "http",
  "serviceName": "1gateway",
  "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791609992/bazaar-icons/c4d9db8f8f483844.png",
  "resourceType": "Beauty & Personal Care",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x6246eee0355Dd7A93C888fE59e1151388A0cC5a1",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "4500",
      "amountUsd": 0.0045,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "properties": {
          "attribution": {
            "type": "string"
          },
          "compareMonth": {
            "type": "string"
          },
          "descriptionEn": {
            "type": "string"
          },
          "descriptionLevel": {
            "type": "string"
          },
          "hs": {
            "type": "string"
          },
          "lineCount": {
            "type": "integer"
          },
          "lines": {
            "items": {
              "properties": {
                "balanceUsd": {
                  "type": "integer"
                },
                "descriptionEn": {
                  "type": "string"
                },
                "exportsKg": {
                  "type": "integer"
                },
                "exportsUsd": {
                  "type": "integer"
                },
                "exportsYoyPct": {
                  "type": "number"
                },
                "hs6": {
                  "type": "string"
                },
                "hsCode": {
                  "type": "string"
                },
                "importsKg": {
                  "type": "integer"
                },
                "importsUsd": {
                  "type": "integer"
                },
                "importsYoyPct": {
                  "type": "number"
                },
                "nameKo": {
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "month": {
            "type": "string"
          },
          "notes": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "sort": {
            "type": "string"
          },
          "total": {
            "properties": {
              "balanceUsd": {
                "type": "integer"
              },
              "exportsKg": {
                "type": "integer"
              },
              "exportsUsd": {
                "type": "integer"
              },
              "exportsYoyPct": {
                "type": "number"
              },
              "importsKg": {
                "type": "integer"
              },
              "importsUsd": {
                "type": "integer"
              },
              "importsYoyPct": {
                "type": "number"
              },
              "prevYearExportsUsd": {
                "type": "integer"
              },
              "prevYearImportsUsd": {
                "type": "integer"
              }
            },
            "type": "object"
          },
          "unit": {
            "type": "string"
          }
        },
        "required": [
          "hs",
          "descriptionEn",
          "descriptionLevel",
          "month",
          "compareMonth",
          "unit",
          "total",
          "lineCount",
          "sort",
          "lines",
          "notes",
          "attribution"
        ],
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "hs": "8542",
            "limit": 20,
            "month": "202608",
            "sort": "exports"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "attribution": "Source: Korea Customs Service (관세청) trade statistics via data.go.kr (datasets 15157908, 15157941, 15101609; no usage restriction). 10-day figures are provision…",
            "compareMonth": "2025-08",
            "descriptionEn": "Electronic integrated circuits",
            "descriptionLevel": "8542",
            "hs": "8542",
            "lineCount": 20,
            "lines": [
              {
                "balanceUsd": 14762525118,
                "descriptionEn": "Electronic integrated circuits; memories",
                "exportsKg": 177730,
                "exportsUsd": 15733149397,
                "exportsYoyPct": 501.4,
                "hs6": "854232",
                "hsCode": "8542321010",
                "importsKg": 41627,
                "importsUsd": 970624279,
                "importsYoyPct": 54.7,
                "nameKo": "디램"
              }
            ],
            "month": "2026-08",
            "notes": [
              "Lines are Korea's 10-digit HSK codes under the requested prefix; descriptionEn is the international HS 6-digit description, nameKo the official Korean line nam…"
            ],
            "sort": "exports",
            "total": {
              "balanceUsd": 28613943758,
              "exportsKg": 1674296,
              "exportsUsd": 38235698070,
              "exportsYoyPct": 203.1,
              "importsKg": 635066,
              "importsUsd": 9621754312,
              "importsYoyPct": 85.5,
              "prevYearExportsUsd": 12615814759,
              "prevYearImportsUsd": 5185580976
            },
            "unit": "USD (exports FOB, imports CIF); weights in kg (net)"
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "additionalProperties": false,
                "properties": {
                  "hs": {
                    "description": "HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)",
                    "examples": [
                      "8542"
                    ],
                    "pattern": "^\\d{2,10}$",
                    "type": "string"
                  },
                  "limit": {
                    "default": 20,
                    "description": "Max 10-digit lines returned (1-100, default 20)",
                    "examples": [
                      20
                    ],
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "month": {
                    "description": "Month YYYYMM (default: latest finalized month)",
                    "examples": [
                      "202608"
                    ],
                    "pattern": "^(19|20)\\d{2}(0[1-9]|1[0-2])$",
                    "type": "string"
                  },
                  "sort": {
                    "default": "exports",
                    "description": "Line order (default exports)",
                    "enum": [
                      "exports",
                      "imports",
                      "balance",
                      "total"
                    ],
                    "examples": [
                      "exports"
                    ],
                    "type": "string"
                  }
                },
                "required": [
                  "hs"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "properties": {
                  "attribution": {
                    "type": "string"
                  },
                  "compareMonth": {
                    "type": "string"
                  },
                  "descriptionEn": {
                    "type": "string"
                  },
                  "descriptionLevel": {
                    "type": "string"
                  },
                  "hs": {
                    "type": "string"
                  },
                  "lineCount": {
                    "type": "integer"
                  },
                  "lines": {
                    "items": {
                      "properties": {
                        "balanceUsd": {
                          "type": "integer"
                        },
                        "descriptionEn": {
                          "type": "string"
                        },
                        "exportsKg": {
                          "type": "integer"
                        },
                        "exportsUsd": {
                          "type": "integer"
                        },
                        "exportsYoyPct": {
                          "type": "number"
                        },
                        "hs6": {
                          "type": "string"
                        },
                        "hsCode": {
                          "type": "string"
                        },
                        "importsKg": {
                          "type": "integer"
                        },
                        "importsUsd": {
                          "type": "integer"
                        },
                        "importsYoyPct": {
                          "type": "number"
                        },
                        "nameKo": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "type": "array"
                  },
                  "month": {
                    "type": "string"
                  },
                  "notes": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "sort": {
                    "type": "string"
                  },
                  "total": {
                    "properties": {
                      "balanceUsd": {
                        "type": "integer"
                      },
                      "exportsKg": {
                        "type": "integer"
                      },
                      "exportsUsd": {
                        "type": "integer"
                      },
                      "exportsYoyPct": {
                        "type": "number"
                      },
                      "importsKg": {
                        "type": "integer"
                      },
                      "importsUsd": {
                        "type": "integer"
                      },
                      "importsYoyPct": {
                        "type": "number"
                      },
                      "prevYearExportsUsd": {
                        "type": "integer"
                      },
                      "prevYearImportsUsd": {
                        "type": "integer"
                      }
                    },
                    "type": "object"
                  },
                  "unit": {
                    "type": "string"
                  }
                },
                "required": [
                  "hs",
                  "descriptionEn",
                  "descriptionLevel",
                  "month",
                  "compareMonth",
                  "unit",
                  "total",
                  "lineCount",
                  "sort",
                  "lines",
                  "notes",
                  "attribution"
                ],
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "korea",
    "trade-statistics",
    "hs-code",
    "imports-exports",
    "korea-customs",
    "bazaar"
  ],
  "sourceHost": "1gateway.dev",
  "lastUpdated": "2026-10-11T05:27:43.665Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-11T05:27:43.428Z"
  },
  "metadata": {
    "serviceName": "1gateway",
    "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791609992/bazaar-icons/c4d9db8f8f483844.png",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "hs": "8542",
              "limit": 20,
              "month": "202608",
              "sort": "exports"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "attribution": "Source: Korea Customs Service (관세청) trade statistics via data.go.kr (datasets 15157908, 15157941, 15101609; no usage restriction). 10-day figures are provision…",
              "compareMonth": "2025-08",
              "descriptionEn": "Electronic integrated circuits",
              "descriptionLevel": "8542",
              "hs": "8542",
              "lineCount": 20,
              "lines": [
                {
                  "balanceUsd": 14762525118,
                  "descriptionEn": "Electronic integrated circuits; memories",
                  "exportsKg": 177730,
                  "exportsUsd": 15733149397,
                  "exportsYoyPct": 501.4,
                  "hs6": "854232",
                  "hsCode": "8542321010",
                  "importsKg": 41627,
                  "importsUsd": 970624279,
                  "importsYoyPct": 54.7,
                  "nameKo": "디램"
                }
              ],
              "month": "2026-08",
              "notes": [
                "Lines are Korea's 10-digit HSK codes under the requested prefix; descriptionEn is the international HS 6-digit description, nameKo the official Korean line nam…"
              ],
              "sort": "exports",
              "total": {
                "balanceUsd": 28613943758,
                "exportsKg": 1674296,
                "exportsUsd": 38235698070,
                "exportsYoyPct": 203.1,
                "importsKg": 635066,
                "importsUsd": 9621754312,
                "importsYoyPct": 85.5,
                "prevYearExportsUsd": 12615814759,
                "prevYearImportsUsd": 5185580976
              },
              "unit": "USD (exports FOB, imports CIF); weights in kg (net)"
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "additionalProperties": false,
                  "properties": {
                    "hs": {
                      "description": "HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)",
                      "examples": [
                        "8542"
                      ],
                      "pattern": "^\\d{2,10}$",
                      "type": "string"
                    },
                    "limit": {
                      "default": 20,
                      "description": "Max 10-digit lines returned (1-100, default 20)",
                      "examples": [
                        20
                      ],
                      "maximum": 100,
                      "minimum": 1,
                      "type": "integer"
                    },
                    "month": {
                      "description": "Month YYYYMM (default: latest finalized month)",
                      "examples": [
                        "202608"
                      ],
                      "pattern": "^(19|20)\\d{2}(0[1-9]|1[0-2])$",
                      "type": "string"
                    },
                    "sort": {
                      "default": "exports",
                      "description": "Line order (default exports)",
                      "enum": [
                        "exports",
                        "imports",
                        "balance",
                        "total"
                      ],
                      "examples": [
                        "exports"
                      ],
                      "type": "string"
                    }
                  },
                  "required": [
                    "hs"
                  ],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "properties": {
                    "attribution": {
                      "type": "string"
                    },
                    "compareMonth": {
                      "type": "string"
                    },
                    "descriptionEn": {
                      "type": "string"
                    },
                    "descriptionLevel": {
                      "type": "string"
                    },
                    "hs": {
                      "type": "string"
                    },
                    "lineCount": {
                      "type": "integer"
                    },
                    "lines": {
                      "items": {
                        "properties": {
                          "balanceUsd": {
                            "type": "integer"
                          },
                          "descriptionEn": {
                            "type": "string"
                          },
                          "exportsKg": {
                            "type": "integer"
                          },
                          "exportsUsd": {
                            "type": "integer"
                          },
                          "exportsYoyPct": {
                            "type": "number"
                          },
                          "hs6": {
                            "type": "string"
                          },
                          "hsCode": {
                            "type": "string"
                          },
                          "importsKg": {
                            "type": "integer"
                          },
                          "importsUsd": {
                            "type": "integer"
                          },
                          "importsYoyPct": {
                            "type": "number"
                          },
                          "nameKo": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "month": {
                      "type": "string"
                    },
                    "notes": {
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "sort": {
                      "type": "string"
                    },
                    "total": {
                      "properties": {
                        "balanceUsd": {
                          "type": "integer"
                        },
                        "exportsKg": {
                          "type": "integer"
                        },
                        "exportsUsd": {
                          "type": "integer"
                        },
                        "exportsYoyPct": {
                          "type": "number"
                        },
                        "importsKg": {
                          "type": "integer"
                        },
                        "importsUsd": {
                          "type": "integer"
                        },
                        "importsYoyPct": {
                          "type": "number"
                        },
                        "prevYearExportsUsd": {
                          "type": "integer"
                        },
                        "prevYearImportsUsd": {
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "unit": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "hs",
                    "descriptionEn",
                    "descriptionLevel",
                    "month",
                    "compareMonth",
                    "unit",
                    "total",
                    "lineCount",
                    "sort",
                    "lines",
                    "notes",
                    "attribution"
                  ],
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "1gateway.dev",
    "manifest_name": "1gateway.dev",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {
      "attribution": "string",
      "compareMonth": "string",
      "descriptionEn": "string",
      "descriptionLevel": "string",
      "hs": "string",
      "lineCount": 0,
      "lines": [
        {
          "balanceUsd": 0,
          "descriptionEn": "string",
          "exportsKg": 0,
          "exportsUsd": 0,
          "exportsYoyPct": 0,
          "hs6": "string",
          "hsCode": "string",
          "importsKg": 0,
          "importsUsd": 0,
          "importsYoyPct": 0,
          "nameKo": "string"
        }
      ],
      "month": "string",
      "notes": [
        "string"
      ],
      "sort": "string",
      "total": {
        "balanceUsd": 0,
        "exportsKg": 0,
        "exportsUsd": 0,
        "exportsYoyPct": 0,
        "importsKg": 0,
        "importsUsd": 0,
        "importsYoyPct": 0,
        "prevYearExportsUsd": 0,
        "prevYearImportsUsd": 0
      },
      "unit": "string"
    },
    "type": "string"
  }
}