{"slug":"1gateway-dev-v1-trade-hs-fc412e","title":"Use when you need South Korea's monthly trade for a product by HS code (e.g","host":"1gateway.dev","method":"GET","resource":"https://1gateway.dev/v1/trade/hs","category":"code","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). Outpu","price_listed":0.0045,"price_asked":0.0045,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":453,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"hs":"8542","limit":20,"month":"202608","sort":"exports"},"type":"http"},"output_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"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.0045,"price_match":true,"latency_ms":453,"error":null}],"description_full":"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","last_updated":"2026-10-10T10:56:29.978Z","schemes":["exact"]}