Import Totals for an HS Code on One Origin-to-Destination Route (Import Records, All Importers Combined)

omnial/trade-importer-statistics

From customs import records for one product (an HS code) shipped from one origin country to one destination country in a date window, returns the combined totals across all importers: how many importing companies the records name, the number of trade records, the total USD value, the total weight and quantity as recorded, and the average USD value per unit of weight and per unit of quantity. One summary per call; no company names.

activeper callv1

Price

Up to $0.0874 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Tendata

Data from Tendata.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/trade-importer-statistics" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/trade-importer-statistics" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/trade-importer-statistics", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/trade-importer-statistics", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0874

Updated: Oct 14, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "hsCode",
    "countryOfOriginCode",
    "countryOfDestinationCode",
    "startDate",
    "endDate",
    "catalog"
  ],
  "properties": {
    "hsCode": {
      "type": "string",
      "pattern": "^[0-9]{4,10}$",
      "description": "The product's customs HS code, 4 to 10 digits."
    },
    "catalog": {
      "enum": [
        "imports"
      ],
      "type": "string",
      "description": "The records searched; only \"imports\" (import records), the one tested, is offered."
    },
    "endDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of the date window, YYYY-MM-DD."
    },
    "startDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start of the date window, YYYY-MM-DD. The window may span at most three years."
    },
    "countryOfOriginCode": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "The country the goods come from (origin), as one ISO 3166 three-letter code in capitals."
    },
    "countryOfDestinationCode": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "The importing (destination) country, as one ISO 3166 three-letter code in capitals."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "weight": {
      "type": "number",
      "description": "Total weight of the matching records, as recorded; the unit is not stated, and records can omit weight, so it can be below the true weight."
    },
    "quantity": {
      "type": "number",
      "description": "Total quantity of the matching records, as recorded; the unit is not stated and can differ between records."
    },
    "sumOfUSD": {
      "type": "number",
      "description": "Total value of the matching records, in USD."
    },
    "tradeCount": {
      "type": "number",
      "description": "The number of matching trade records."
    },
    "companyCount": {
      "type": "number",
      "description": "How many importing companies the matching import records name."
    },
    "weightAvgPrice": {
      "type": "number",
      "description": "USD value per unit of weight (sumOfUSD divided by weight); inflated when the recorded weight is incomplete."
    },
    "quantityAvgPrice": {
      "type": "number",
      "description": "USD value per unit of quantity (sumOfUSD divided by quantity)."
    }
  },
  "description": "Totals over every matching import record, all importers combined."
}