Countries Ranked by Trade
trade.rankingLargest exporting or importing countries for a commodity in a year, ranked by value, each with the implied unit value it realised. Use for 'who are the biggest cocoa exporters' and 'which sourcing market is cheapest'. EXPORTS ARE NOT PRODUCTION: a country can be a large exporter of something it does not grow — the Netherlands ranks sixth in cocoa exports and grows none. Completeness cannot be verified for this shape, so complete is always null.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"commodity": "<commodity>",
"year": "<year>"
},
"name": "trade.ranking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | export ranks exporters, import ranks importers. | |
| year | Yes | Four-digit year. Example: 2023. | |
| limit | No | Maximum rows returned, 1-200 (default 25). | |
| commodity | Yes | Instrument code with an HS heading. Example: CC for cocoa. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | ||
| year | Yes | ||
| notes | Yes | Caveats the numbers cannot carry. Read these before presenting a unit value. | |
| source | No | ||
| complete | No | Always null here: the upstream publishes no aggregate over all reporters to reconcile against | |
| returned | No | ||
| commodity | Yes | ||
| reporters | Yes | Countries, highest value first. Ranked by this service, not by the upstream, which returns rows ordered by country code. | |
| license_tag | No | ||
| reporter_count | No | Reporters the upstream returned, before any limit |