{"uid":"cap_X36e7kQmfG0_nQJW62WI8","slug":"trade-exposure-by-country-halowerk-d72b7e81","name":"Trade Exposure by Country (Halowerk)","description":"Returns the main trading partners of a country for exports and imports, each with its share, and the concentration of that distribution measured by the Herfindahl-Hirschman index over partner shares. Concentration is the measure that carries the signal: a country sending thirty percent of exports to one state with the rest spread over twenty others is exposed differently from one sending thirty percent to one state and sixty to a second, and the largest partner is identical in both cases.","url":"https://stat.halowerk.com/v1/trade-exposure","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"flow":{"enum":["exports","imports","both"],"type":"string","default":"both"},"reporter":{"type":"string","default":"EU27_2020","maxLength":12,"minLength":2,"description":"Reporting economy. The source publishes partner-level long-term trade for the EU aggregate (EU27_2020) and the euro area (EA20); individual member states are not carried in this series."},"top_partners":{"type":"integer","default":12,"maximum":30,"minimum":3}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zdER5E5Y76My8nsgrDhm0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a country's top trading partners for exports and imports with their share breakdown and trade concentration measured by the Herfindahl-Hirschman Index (HHI).","exampleAgentPrompt":"Can you pull the trade exposure data for Germany — I want to see the main export partners with their shares and the HHI concentration index so I can assess how exposed they are to any single market?","exampleUseCases":[{"title":"Geopolitical supply chain risk assessment","prompt":"Give me the import partner breakdown and HHI concentration score for Taiwan — I want to understand how dependent it is on any single country for its imports and flag if the concentration is dangerously high."},{"title":"Export market diversification analysis","prompt":"Pull the export trading partners and Herfindahl-Hirschman index for Brazil so I can see whether its export revenues are spread across many countries or heavily concentrated in one or two."},{"title":"Comparative trade vulnerability screening","prompt":"I need the trade exposure data for both South Korea and Mexico — exports and imports — with their HHI scores so I can compare which country has more concentrated trade relationships and therefore higher geopolitical risk."}],"resultDescription":"A structured response listing the top trading partners for exports and imports of the requested country, each with its percentage share of total trade, plus the Herfindahl-Hirschman Index (HHI) value summarizing the overall concentration of the partner distribution — higher HHI signals greater dependence on fewer partners.","failureModes":["Unsupported or invalid country code returns an error","Country has insufficient trade data available, resulting in empty or partial results","Trade direction parameter not recognized","API call quota exceeded or payment not processed"],"whenToPreferThis":"Use this endpoint when you need to quantify a country's trade partner concentration and dependency risk beyond just identifying the top partner. Unlike simple rankings, this endpoint provides the HHI metric which captures the full shape of the distribution — ideal for risk models, geopolitical exposure analysis, and supply chain diversification assessments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:41:51.453Z","isFirstParty":false}