# OpenTariff — US HTS code lookup & the full stacked duty

> Data version: HTS-2026-Rev.11
> What is different here: the US duty stack is computed correctly (MFN + Section 301 list + Section 301 forced-labour surcharge + Section 232), and every line is traceable to an official source. Section 122 expired 2026-07-24.

## What this is
Describe a product, get the real stacked US import duty. Rates are computed only by a deterministic TypeScript rule engine; an LLM is used solely for the semantic step "product description -> HS code" and never touches any rate arithmetic. Every rate line carries an official source_url and an effective_from date.

## Stable interfaces for agents (MCP / API)
- classify_product(description, country) -> HS code + confidence
- get_tariff(hs_code, origin, dest) -> full stacked duty breakdown (with source_url, effective date, data version)
- calculate_landed_cost(hs_code, origin, dest, value) -> duty + MPF/HMF + landed cost
- list_recent_changes(country, since) -> stream of rate changes
Docs: /api-docs and /mcp

## Stable URL patterns
- Code detail page: /hts/{code}  e.g. /hts/8517.13.00.00
- Chapter index page: /hts/chapter-{nn}  e.g. /hts/chapter-85
- Chapter directory: /hts
- Product landing page: /hts-code-for/{product}  e.g. /hts-code-for/laptop
    The first paragraph answers with the code (AEO friendly), followed by a variant table, the US stacked-duty receipt, and FAQPage markup.
    Product-to-code mapping comes from a rule base; low-confidence items get no page (manual review), so published codes are trustworthy.
    Product index: /hts-code-for
- Guides: /guides/{slug}  e.g. /guides/hs-code-vs-hts-code
    Concept and platform guides. First paragraph answers the question directly, with internal links to related product and code pages, plus FAQPage markup.
    Guide index: /guides
- De-minimis table: /de-minimis
- Change stream: /changes
- Sitemap: /sitemap.xml

## Data sources
USITC HTS 2026 · USTR Section 301 · BIS Section 232 · Federal Register · national customs authorities.
The code catalogue and MFN base rates (Column 1 General) come from a full USITC HTS HTS-2026-Rev.11 export (genuinely parsed; compound, specific and cross-reference rates keep their original text in rate_raw). Section 301/232 surcharge mappings are being reconciled line by line against the official annexes; see DECISIONS/TODO in the repo.

## Recent US rate changes
- 2026-07-24 Forced-labor Section 301 takes effect: 10% or 12.5% added for 60 economies (China 12.5%), goods already subject to Section 232 excluded (https://www.federalregister.gov/documents/2026/07/28/2026-15181/notice-of-actions-in-section-301-investigations-of-acts-policies-and-practices-of-various-economies)
- 2026-07-24 Section 122 global surcharge of 10% expires (successor measure yet to be seen) (https://www.federalregister.gov/documents/2026/02/10)
- 2026-07-01 US-EU framework: 15% all-inclusive cap on EU-origin goods takes effect, replacing Section 122 (https://ec.europa.eu/commission/presscorner/)
- 2026-02-24 Section 122 global surcharge of 10% takes effect (statutory 150-day window, expires 2026-07-24) (https://www.federalregister.gov/documents/2026/02/10)
- 2026-02-20 Supreme Court struck down IEEPA country-specific reciprocal tariffs (9903.01/9903.02 series voided) (https://www.supremecourt.gov/)

## Terms of use
Crawl it, quote it, call it. Please keep the source_url attribution. Rates are estimates for reference; the final assessment is made by customs.