# EconSignalPulse Trade Flows

> EconSignalPulse Trade Flows is a paid API for AI agents from econsignalpulse.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-16).

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.

## Facts

- Endpoint: GET https://econsignalpulse.vercel.app/api/econsignal/trade-flows
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/econsignalpulse-trade-flows-505c2761
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yI7MkGllAlYgbM2eKC-x8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability econsignalpulse-trade-flows-505c2761
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/econsignalpulse-trade-flows-505c2761/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from econsignalpulse.vercel.app](https://www.zero.xyz/host/econsignalpulse.vercel.app/llms.txt)