trade — Customs records: who ships what to whom — openbash
US customs bills of lading: a company's counterparties, its shipments, and the firms already importing what you make. And India's monthly trade by partner country, from the Commerce Ministry.
trade
trade is a command on the openbash shell, reachable over HTTP, SSH and MCP with one key. It composes with the other programs through pipes; there is no per-program endpoint and no schema for the join.
trade supplier customers voltex-transformers
help
trade: US customs trade relationships, and India's trade by partner country, as JSON.
USAGE
trade supplier customers <SLUG> who this exporter ships to
trade company suppliers <SLUG> who ships to this importer
trade supplier shipments <SLUG> its bills of lading, one row each
trade company shipments <SLUG> the same, from the importing side
trade search companies <QUERY> companies matching a name
--hs CODE --from DATE --to DATE --limit N --refresh
trade india releases [--flow export|import]
trade india countries --flow F --month YYYY-MM [--country CC]
[--period month|ytd] [--vintage latest|all|YYYY-MM]
trade india commodities --flow F --month YYYY-MM [--commodity CODE]
[--currency usd|inr] [--period month|ytd] [--vintage V]
trade india series --flow F (--country CC | --commodity CODE [--currency C])
[--from YYYY-MM] [--to YYYY-MM] [--period P] [--vintage V]
trade india groups [--flow F] the commodity groups and their codes
--tsv on any India study prints tab-separated rows with a header.
WHAT A LEAD IS HERE
US customs publishes every sea import as a bill of lading naming BOTH
parties. So "who would buy this" has a factual answer: the firms already
importing it, and who supplies them today. Start from a competitor's slug
and `customers` is the prospect list.
FILTERS ARE FREE
A company page is visited once and kept centrally for thirty days, shared
across accounts — so filtering by HS chapter or date is a database read,
a second account asking the same question pays nothing, and a repeated
question costs nothing. `--refresh` overrides that; it is for repairing a
capture known to be wrong.
`--hs` is a PREFIX: 84 is the whole chapter, 8504 the heading beneath it.
Note that the upstream itself warns its HS codes are unreliable.
WHAT IT WILL NOT REPORT
No shipment value. The upstream publishes an estimate and states its own
coverage beside it — 37% on one company and 69% on another, measured the
same day. Sortable, that ranks coverage rather than trade. Weight, TEU and
container counts are counted by the ports themselves; those are reported.
INDIA: THE MINISTRY'S QUICK ESTIMATES
India's exports and imports by partner country, in million USD, from the
Commerce Ministry's DGCI&S monthly Quick Estimates: each month's top 20 (or
top 40 with OTHERS, on some 2025 releases), the Sub-Total and the GRAND
TOTAL, for the month and the fiscal year to date (April to the month).
And what India trades: the ministry's thirty principal commodity groups a
side (Engineering Goods, Electronic Goods, Petroleum, Gold...), in million
USD or, with --currency inr, rupees crore. These are the government's own
totals, not an estimate of shipments, so the no-value rule above does not
apply to them. Commodity by country is in neither table.
--month is the month the figures are FOR. --country is an ISO code (US, AE,
CN, GB) or TOTAL. A country outside a month's top list is absent, not zero.
VINTAGES. The directorate revises a year later: September 2025's exports
were printed at 36384.01, then at 36084.64. Both are kept. `latest` (the
default) takes each figure from the newest release that printed it; `all`
returns every printing; a release YYYY-MM returns that release as printed.
The release's own month and year to date carry is_provisional.
EVIDENCE. Every row names its source PDF by source_url and source_sha256,
and each cited PDF is filed into the account's web store under its url
from the exact bytes that were read, so the url is a citation that holds.
`documents` says per file: held, filed, differs or not filed.
Read from a central store, free. The ministry's site is polled daily from
the 15th to the 20th of each month and weekly otherwise; nothing a command
does reaches it. Coverage starts June 2024; months published only as scans
are listed by `releases` as refused and carry no figures.