Trading Partners Ranked
trade.partnersEvery country one reporter traded a commodity with in a year, ranked by value, each with the implied unit value it paid or received. Use for 'where does Ghana sell its cocoa and at what price to each buyer' and for comparing prices across markets. Pass the reporter as ISO alpha-3 (GHA, IND). Annual data. Completeness is verifiable for this shape: the response says whether the partner rows reconcile with the upstream's own World total.
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>",
"reporter": "<reporter>",
"year": "<year>"
},
"name": "trade.partners"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | Direction from the reporter's view. | |
| year | Yes | Four-digit year. Example: 2023. | |
| limit | No | Maximum rows returned, 1-200 (default 25). | |
| reporter | Yes | Reporting country, ISO alpha-3 preferred. Example: GHA. | |
| 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 | Whether the partner rows reconcile with the upstream's World total | |
| partners | Yes | Partners, highest value first | |
| reporter | Yes | ||
| returned | No | ||
| commodity | Yes | ||
| license_tag | No | ||
| partner_count | No | Partners the upstream returned, before any limit | |
| shortfall_usd | No | ||
| world_total_usd | No |