Skip to content
EximAgent Docs

Market and shipment signals

Answer market questions with server-side signal verbs instead of paging raw shipment rows: attractiveness, recurrence, price direction, and lanes.

For any question about a market — size, price, concentration, recurrence, direction — call a signal verb. Do not page raw shipment rows and aggregate them yourself.

The signal verbs aggregate server-side over the full matching corpus and return a small, business-ready result.

The four verbs

eximagent shipments market-signals --hs6 090111 --dest DE
eximagent shipments buyer-recurrence --hs6 090111 --dest DE
eximagent shipments price-trend --hs6 090111 --dest DE
eximagent shipments route-signals --hs6 090111 --dest DE
VerbThe question it answers
market-signalsIs this market attractive? Shipment count, unique buyers and sellers, average and median price per kg, top-five buyer share, month-over-month volume and price direction
buyer-recurrenceWhich buyers are durable accounts? Active months, recurring/new/returning counts, retention, repeat-shipment ratio, per-buyer scale
price-trendWhere are prices heading? Monthly average, median, p25, p75, standard deviation, and month-over-month change
route-signalsWhich origin→destination lanes lead, ranked by traded value

All four scope with --hs6 or --dest, plus optional --origin, --source, --from, and --to (months as YYYY-MM).

The chain worth following

  1. market-signals — is it worth entering?
  2. buyer-recurrence — who are the durable accounts? This ranks the outreach shortlist.
  3. price-trend — what negotiating posture does the price direction imply?
  4. route-signals — which lane?
  5. Verify one account before acting on the picture.

Lead with the commercial read — concentrated or broadening, rising or falling, who recurs — not with the data source.

Verifying a single account

eximagent company shipments --name "Example Handels GmbH"
eximagent shipments get --id <recordId> --view detail
eximagent evidence show --id <recordId> --normalized

shipments get --view projects richer fields (detail, logistics, financials, parties, evidence); the 24-field summary view stays the default. evidence show --normalized returns English-normalized semantic fields next to the raw source record.

Full-corpus analytics

When the question does not fit a signal verb, push the computation down rather than pulling rows up:

eximagent analytics catalog
eximagent analytics query --groupBy importer --measures shipments --filters '{"hs6":"090111"}'
eximagent analytics sql --query "SELECT ..."

Read analytics catalog first for the schema. analytics sql accepts a guarded read-only SELECT.

For a genuine bulk export, write it to disk instead of into your context:

eximagent analytics query --groupBy importer --measures shipments --out buyers.ndjson --format ndjson

The CLI auto-pages the entire result set to the file and prints only a summary. Analyse the file with duckdb, jq, or pandas, and read only your computed aggregates back.

Next