Help

Sideboard: setting up your query

Finding the right customs code

Customs codes are series of digits corresponding to categories of goods. Shorter codes (2–4 digits) give you broad categories. Longer codes (6–8 digits) give you more specific goods.

The search box on the landing page proposes customs codes based on their official definition in the Combined Nomenclature. Everyday terms do not always line up with the exact wording used by customs. The full nomenclature applicable in the current year can also be browsed directly from the landing page.

This nomenclature does not include some of the more detailed codes used by customs officers and businesses at the border. No publically available data exists for those. Thus, the website will return an error if you try a code outside of the permissible range.

If nothing relevant comes up, you can use a search engine to find a code. There are various free websites which allow you to browse customs nomenclatures from the EU or other countries. Look for "Combined nomenclature + product_name".You can also browse the official EU website for the Combined nomenclature.

Here is what to know:

Two concrete examples. A Ferrari is a “motor vehicle principally designed for the transport of under 10 persons” (code 8703) with a petrol engine over 3,000 cm³ (sub-code 8703 24). Likewise, “Unleaded 95” is found under “motor spirit, with a lead content <= 0,013 g/l, with a research octane number (RON) of >= 95 but < 98 (excl. containing biodiesel)” (code 2710 12 45).

Custom country groups

Both the Reporter and Partner set dropdowns have a Custom… option at the bottom. They also have a search box at the top to quickly filter by name.

Price outlier removal

When 'Remove' is selected (the default), a period's unit price (€/t) is discarded only when it exceeds 20 times the median unit price of its own customs-code–reporter–partner–flow series, before the weighted averages are computed. This catches the isolated, misreported or abnormally small shipment whose extreme unit value would otherwise make a chart's scale unreadable, while leaving genuine price trends and volatility untouched.

Toggle to Keep if you want to see the raw unfiltered prices.

Saving query parameters

Every time you click Apply, the full query (customs code, reporter, partners, period, frequency, outlier setting, exact tab and colour palette) is saved in the page URL. You can copy the URL from your browser's address bar and share it. Anyone opening that link will see the same dashboard configuration and results.

Charts: explore and export

The 100 and % toggles

Line charts have a small 100 button in their top-right corner. Clicking it rebases all series so that the first data point equals 100. This makes it easy to compare relative changes over time between series that have very different absolute levels (e.g. import vs. export prices). Click the button again to switch back to absolute values.

Stacked bar charts have a % button that switches to percentage-share view, showing each entity's proportion of the total rather than absolute values.

Both toggles reset automatically when you run a new query.

Downloading data

Charts with entity breakdowns (partners, reporters, trade balance) have a Table button that flips the chart to reveal a full ranking of up to 50 entities. From that table view you can click Excel to download an .xlsx file with two sheets: Metadata (customs code, description, reporter, partner set, period, frequency, source, and export timestamp) and Data (the data from the graph). Click ✕ to flip back to the chart view.

Every chart also has a PNG button that downloads an image containing basic metadata. You can also take screenshots. Otherwise feel free to contact me if you want purpose-built graphs for your reports or presentations.

Chatbots and API access

The backend is independent of the frontend, so third-party software and chatbots can query the same data. API endpoints are documented in machine-readable and human-readable formats.

Use the standard connector or plugin in Claude, ChatGPT or Google Antigravity, or another MCP-compatible chatbot: add https://mcp.tradedashboard.eu/mcp as the server URL and follow the OAuth authentication flow in your browser. To prevent abuse, OAuth authentication is restricted to allowlisted MCP clients. Contact me to request support for your preferred client.

If your chatbot supports custom HTTP headers, you can instead generate a personal API key in your account. Choose Streamable HTTP, use the same server URL, and add the Authorization header from this example, replacing YOUR_API_KEY:

{
  "mcpServers": {
    "eu-trade": {
      "url": "https://mcp.tradedashboard.eu/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

Usage limits

Without an account, you can only explore the demonstration codes featured on the front page.

Every other customs code requires you to register with your email address. Registration is free and currently grants unlimited access, including a personal API key for scripts and MCP tools, and queries spanning several codes at once. A per-minute rate limit also applies to prevent abuse.

Back to the dashboard