{"uid":"cap_bJ8TR2oWhN_PbiXegqe2w","slug":"1gateway-korea-trade-by-hs-code-3ba28168","name":"1gateway Korea Trade by HS 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). 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","url":"https://1gateway.dev/v1/trade/hs?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["hs"],"properties":{"hs":{"type":"string","pattern":"^\\d{2,10}$","examples":["8542"],"description":"HS code prefix, 2-10 digits (e.g. 8542 integrated circuits, 870323 passenger cars)"},"sort":{"enum":["exports","imports","balance","total"],"type":"string","default":"exports","examples":["exports"],"description":"Line order (default exports)"},"limit":{"type":"integer","default":20,"maximum":100,"minimum":1,"examples":[20],"description":"Max 10-digit lines returned (1-100, default 20)"},"month":{"type":"string","pattern":"^(19|20)\\d{2}(0[1-9]|1[0-2])$","examples":["202608"],"description":"Month YYYYMM (default: latest finalized month)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["hs","descriptionEn","descriptionLevel","month","compareMonth","unit","total","lineCount","sort","lines","notes","attribution"],"properties":{"hs":{"type":"string"},"sort":{"type":"string"},"unit":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"hs6":{"type":"string"},"hsCode":{"type":"string"},"nameKo":{"type":"string"},"exportsKg":{"type":"integer"},"importsKg":{"type":"integer"},"balanceUsd":{"type":"integer"},"exportsUsd":{"type":"integer"},"importsUsd":{"type":"integer"},"descriptionEn":{"type":"string"},"exportsYoyPct":{"type":"number"},"importsYoyPct":{"type":"number"}}}},"month":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}},"total":{"type":"object","properties":{"exportsKg":{"type":"integer"},"importsKg":{"type":"integer"},"balanceUsd":{"type":"integer"},"exportsUsd":{"type":"integer"},"importsUsd":{"type":"integer"},"exportsYoyPct":{"type":"number"},"importsYoyPct":{"type":"number"},"prevYearExportsUsd":{"type":"integer"},"prevYearImportsUsd":{"type":"integer"}}},"lineCount":{"type":"integer"},"attribution":{"type":"string"},"compareMonth":{"type":"string"},"descriptionEn":{"type":"string"},"descriptionLevel":{"type":"string"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0045","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0045/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0045","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DKRLzpbO76gw5s3FeNCv8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0045","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns South Korea's monthly trade statistics (exports, imports, balance, weight) for a given HS code prefix, sourced from Korea Customs Service, with year-on-year comparisons at both aggregate and 10-digit line level.","exampleAgentPrompt":"Pull the latest Korea Customs trade data for HS code 8542 integrated circuits — show me exports, imports, balance in USD and kg, sorted by exports, with up to 20 line items and year-on-year changes.","exampleUseCases":[{"title":"Semiconductor export trend monitoring","prompt":"What were South Korea's total semiconductor exports for HS 8542 in June 2026, and how does that compare to the same month last year? Sort by exports and give me the top 20 line items."},{"title":"Petroleum import analysis for energy report","prompt":"Get me the Korea Customs import figures for petroleum products under HS 2710 for August 2026, including the trade balance and year-on-year percentage changes, sorted by imports."},{"title":"Automotive trade balance snapshot","prompt":"Look up South Korea's monthly trade data for passenger cars, HS code 870323, for the latest available month — I need exports, imports, trade balance in USD, and the breakdown by 10-digit HSK lines sorted by balance."}],"resultDescription":"A JSON object containing aggregate trade totals (exports FOB in USD, imports CIF in USD, trade balance in USD, weights in kg) for the queried HS prefix and month, along with year-on-year percentage changes at the aggregate level. Also includes an array of up to 100 matching 10-digit HSK subheading lines, each with English HS descriptions, individual export/import/balance values in USD and kg, and their own YoY percentages. Metadata includes the queried month, comparison month, data attribution to Korea Customs Service, and any relevant notes.","failureModes":["Invalid HS code format (non-numeric or wrong digit count) returns a validation error","Requested month not yet finalized returns an error or falls back to latest available month","HS code prefix with no trade activity returns empty lines array with zero totals","Month parameter outside valid range returns a pattern validation error","limit out of range (below 1 or above 100) returns a parameter error","Network or upstream Korea Customs Service outage may return a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need official, finalized monthly trade statistics for South Korea at HS code granularity, especially for specific product categories like semiconductors, petroleum, or vehicles. It is the right choice when you need both aggregate totals and 10-digit HSK line-level breakdowns with year-on-year comparisons in a single call. Prefer this over general trade databases when you need Korea-specific data sourced directly from Korea Customs Service with FOB/CIF distinctions and weight data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:36:04.269Z","isFirstParty":false,"canonicalSlug":"1gateway-korea-trade-by-hs-code-3ba28168"}