Census Trade Balance
census_trade_balanceCheck US trade balance with a specific country for a given year. Returns net trade value and breakdown by end-use commodity category.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": "2024",
"country": "China"
},
"name": "census_trade_balance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Trade year (e.g., "2024") | |
| country | No | Country name in plain English (e.g., "Mexico", "China"). Preferred, resolved for you. Pass this OR country_code. | |
| country_code | No | Census Schedule C country code (e.g., "5700" China, "2010" Mexico). NOT an ISO code. Prefer `country`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | Trade year | |
| country | Yes | Country name | |
| country_code | Yes | Census country code | |
| total_exports_usd | Yes | Total exports in USD | |
| total_imports_usd | Yes | Total imports in USD | |
| trade_balance_usd | Yes | Net trade balance (exports minus imports) | |
| deficit_or_surplus | Yes | Trade balance classification |