{"uid":"cap_yI7MkGllAlYgbM2eKC-x8","slug":"econsignalpulse-trade-flows-505c2761","name":"EconSignalPulse Trade Flows","description":"Global trade-flow intelligence — World Bank data, shipping AIS and news synthesis: bilateral balances, export composition, route activity and supply-chain risk. For supply-chain and macro agents.","url":"https://econsignalpulse.vercel.app/api/econsignal/trade-flows","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"iso2":{"type":"string","description":"ISO2 code for World Bank"},"iso3":{"type":"string","description":"ISO3 code for IMF"},"lang":{"type":"string","description":"en | es | fr | de | ja | zh | ko | pt | ar | hi (default: en)"},"country":{"type":"string","description":"Primary country — e.g. \"Mexico\" | \"South Korea\" | \"Netherlands\" | \"UAE\" | \"Singapore\""},"partner":{"type":"string","description":"Trade partner country (optional) — e.g. \"United States\" | \"China\" | \"Germany\""}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"opportunity":"Mexico is the top US trade partner as of 2023, overtaking China for first time since 1990s. Nearshoring wave has 5-10 years to run.","risk_factors":["US tariff policy uncertainty — 25% auto tariffs threatened","Drug cartel extortion of logistics companies in Jalisco/Michoacán","Power shortage limiting new factory capacity"],"query_summary":{"iso2":"MX","country":"Mexico","partner":"United States"},"trade_profile":{"total_exports_usd_bn":593,"total_imports_usd_bn":551,"trade_balance_usd_bn":42,"export_growth_3yr_pct":38,"current_account_pct_gdp":-0.3},"bilateral_with_us":{"top_exports":["Vehicles and auto parts (35%)","Electronics/machinery (22%)","Petroleum products (8%)","Medical devices (6%)"],"nearshoring_signal":"FDI into Mexican manufacturing +45% since 2022 USMCA nearshoring acceleration","mexico_exports_to_us_usd_bn":475,"mexico_imports_from_us_usd_bn":262,"us_trade_deficit_with_mexico_usd_bn":213},"shipping_intelligence":{"key_ports":["Veracruz (Gulf coast)","Manzanillo (Pacific)","Altamira (industrial)"],"rail_crossings":"Kansas City Southern/CPKC rail crossings at record levels — $400B annual freight","container_volume_trend":"Pacific coast ports up 28% YoY driven by Asia-Mexico-US corridor growth"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jTRcDnjm_5-jz1IJikz_e","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns global trade-flow intelligence synthesizing World Bank data, shipping AIS signals, and news — covering bilateral balances, export composition, shipping route activity, and supply-chain risk.","exampleAgentPrompt":"Give me a full trade-flow intelligence report on the US-China corridor — bilateral balances, export composition breakdown, current AIS shipping route activity, and any supply-chain risk flags, synthesizing World Bank data with live shipping signals.","exampleUseCases":null,"resultDescription":"A structured report covering bilateral trade balances, export composition by sector/commodity, shipping AIS route activity metrics, supply-chain risk indicators, and synthesized news signals — combining World Bank official data with alternative shipping and news sources for the queried trade corridor.","failureModes":["Country or corridor not found — returns 404 or empty result if the requested pair lacks sufficient data","AIS data lag — shipping signals may be delayed by hours for remote corridors","World Bank data staleness — official figures may be 1-2 years behind for some developing nations","Rate limit or payment failure — 402 payment required if x402 header is missing or USDC balance insufficient","Ambiguous country specification — may return an error if country codes are not ISO-standard"],"whenToPreferThis":"Choose this endpoint when you need a multi-source synthesis of trade intelligence combining official (World Bank) and alternative (AIS shipping, news) data for bilateral or corridor-level trade analysis, supply-chain risk assessment, or macro trade research. Prefer over single-source trade APIs when you need AIS-augmented signals or supply-chain risk scoring rather than just official statistics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:41:48.297Z","isFirstParty":false}