Trade Partner Ranking
get_trade_partner_rankingPurpose: rank partner countries for one reporter, period and flow direction by quantity, returning rank, partner, quantity, value, unit price and share. Guidelines: reporter (ISO3 alpha), period (YYYY) and flow (X =export, M = import) are required; raise top_n above the default 10 (max 50) only when a longer tail is needed.Limits: one reporter-period-flow combination per call; World aggregate rows are excluded; shares are computed within the returned set, not against global trade. Ex: get_trade_partner_ranking(reporter='CHN', period='2025', flow='X'), get_trade_partner_ranking(reporter='USA', period='2024', flow='M', top_n=20).
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": {
"reporter": "<reporter>",
"period": "<period>"
},
"name": "get_trade_partner_ranking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | 流向 X=出口/M=进口 | |
| top_n | No | Top N 伙伴国(默认 10,最大 50) | |
| period | Yes | 期间 YYYY(必填,如 2024) | |
| reporter | Yes | 报告国 ISO3,必要 | |
| response_format | No | Output format: 'markdown' (default, human-readable) or 'json' (machine-readable). | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Human-readable result (markdown, or a JSON string when response_format=json). |