{"openapi":"3.1.0","info":{"title":"Trimtab US Trade Ledger","version":"1.0.0","description":"US containerised import trade: monthly weight and customs value by origin country, commodity and US gateway (US Census port records, 2017-present), plus pre-registered event-study rulings. Free, no key. Built by Mrigank Singh - trimtabist.com"},"servers":[{"url":"https://trimtabist.com"}],"paths":{"/api/trade":{"get":{"operationId":"tradeQuery","summary":"Monthly US containerised import series (weight kg, value USD, USD/kg), filterable by origin country, commodity and gateway. Response includes a visualization brief and caveats.","parameters":[{"name":"origin","in":"query","required":false,"schema":{"type":"string"},"description":"Origin country name, e.g. China, Vietnam, India (30 largest origins)"},{"name":"commodity","in":"query","required":false,"schema":{"type":"string"},"description":"HS2 chapter name (furniture, plastics, electronics, machinery, toys...) or a 2/6-digit HS code"},{"name":"gateway","in":"query","required":false,"schema":{"type":"string"},"description":"US gateway: us_la_longbeach, us_ny_nj, us_savannah, us_houston, us_charleston, us_norfolk, us_oakland, us_seattle_tacoma"},{"name":"months","in":"query","required":false,"schema":{"type":"integer"},"description":"Trailing months, default 24, max 60"}],"responses":{"200":{"description":"Monthly series with visualization brief, caveats and citation"}}}},"/api/tariff":{"get":{"operationId":"tariffBurden","summary":"What US importers actually paid in tariffs, from official receipts: monthly duty, dutiable and consumption value by origin and commodity, 2017-present, with effective rate and overall burden. Cross-checked against US Treasury receipts. Includes caveats.","parameters":[{"name":"origin","in":"query","required":false,"schema":{"type":"string"},"description":"Origin country name, e.g. China, Vietnam (30 largest origins), or all"},{"name":"commodity","in":"query","required":false,"schema":{"type":"string"},"description":"HS2 chapter name (furniture, toys, plastics...) or a 2/6-digit HS code"},{"name":"months","in":"query","required":false,"schema":{"type":"integer"},"description":"Trailing months (default 24, max 114)"}],"responses":{"200":{"description":"Monthly tariff receipts series with both rates, caveats and citation"}}}},"/api/tariff-lookup":{"get":{"operationId":"tariffLookup","summary":"US tariff rulebook for an HS code with reality attached: statutory MFN base rate (current HTS), trade-war measures in force for an origin with Federal Register citations and effective dates, and the actually-collected border rate from receipts. Not customs advice.","parameters":[{"name":"hs","in":"query","required":true,"schema":{"type":"string"},"description":"HS code, 2-10 digits, dots optional (e.g. 9401.61)"},{"name":"origin","in":"query","required":false,"schema":{"type":"string"},"description":"Origin country name, e.g. China"}],"responses":{"200":{"description":"Base rate lines, in-force measures with citations, receipts reality, caveats"}}}},"/api/hs-search":{"get":{"operationId":"hsSearch","summary":"Find the HS/HTS code for a product from a plain-language description. Searches the full current US tariff schedule with hierarchy context; reports CBP ruling counts per candidate as a confidence signal.","parameters":[{"name":"product","in":"query","required":true,"schema":{"type":"string"},"description":"Product description, e.g. electric standing desk"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Max candidates (default 8)"}],"responses":{"200":{"description":"Candidate codes with hierarchy paths, MFN rates, ruling counts"}}}},"/api/rulings":{"get":{"operationId":"rulingsSearch","summary":"Search US Customs (CBP) classification rulings: how the border interprets which product belongs under which HS code. Query by code or keywords; returns rulings with classified codes, dates, precedent links and official document URL. Coverage disclosed per response.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"description":"HS code (e.g. 9401.61) or keywords"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"Max results (default 8, max 25)"}],"responses":{"200":{"description":"Rulings with codes, precedent links, coverage disclosure"}}}},"/api/studies":{"get":{"operationId":"eventStudies","summary":"Pre-registered event studies of US trade shocks 2018-2026 (tariffs, COVID, port queues, strikes, the Red Sea null, the shrinking Chinese invoice). Omit slug to list all with verdicts; pass slug for full registration, evidence and falsification test.","parameters":[{"name":"slug","in":"query","required":false,"schema":{"type":"string"},"description":"Study slug, e.g. hidden-queue, red-sea-null, shrinking-chinese-invoice"}],"responses":{"200":{"description":"Study list or full study detail"}}}}}}