# DataNexusAI Trade Partners Lookup

> DataNexusAI Trade Partners Lookup is a paid API for AI agents from api.datanexusai.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns trade partner data (import/export flows, values, quantities, and shares) for a given reporter country and product code, optionally filtered by period and flow direction.

## Facts

- Endpoint: GET https://api.datanexusai.org/api/v1/trade/partners?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datanexusai-trade-partners-lookup-1467bb1a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eTEORQNXfUz376D50j93D

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 datanexusai-trade-partners-lookup-1467bb1a
```

Example prompt: Show me the top 20 trade partners for Bulgaria (BG) importing product code 1001 in 2025, sorted by value — I want to see both imports and exports.

## When to prefer this

Use this endpoint when you need structured bilateral trade flow data for a specific reporter country and product code, especially when filtering by period, flow direction, or ranking partners by value, quantity, or share. Prefer this over general web search when you need machine-readable, analytics-ready trade partner data payable via USDC micropayment.

## Known failure modes

- Missing required 'reporter' or 'product' query parameters returns a 400 error
- Invalid country code or product code returns empty results or a 404
- Payment not provided or insufficient USDC balance triggers an x402 payment-required response
- Invalid flow value (not import/export/both) may return an error or default to 'both'
- Date range with no available data returns an empty result set
- Unsupported sort field returns an error or defaults to a fallback ordering

## How this service works

Public data API for SEBRA payments, PTP road accidents, Hearthstone cards, EU agri-food prices, and trade/market analytics. Paid data endpoints use x402 (USDC micropayments). Docs and discovery endpoints are free.

Machine-readable discovery: `https://api.datanexusai.org/openapi.json`, `https://api.datanexusai.org/llms.txt`, `https://api.datanexusai.org/.well-known/x402`.

Human docs: `/docs` and `/api/`.

## Output

Returns a list of trade partner countries with associated trade metrics including flow direction (import/export), trade value, quantity, and market share for the specified reporter country and product code, filtered by any provided period or date range.

## 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",
     "required": [
      "reporter",
      "product"
     ],
     "properties": {
      "flow": {
       "type": "string",
       "description": "import|export|both (default both)."
      },
      "sort": {
       "type": "string",
       "description": "value|quantity|share."
      },
      "limit": {
       "type": "integer",
       "example": 20
      },
      "period": {
       "type": "string",
       "example": "2025",
       "description": "Period filter."
      },
      "date_to": {
       "type": "string",
       "description": "End."
      },
      "product": {
       "type": "string",
       "example": "1001",
       "description": "Product code."
      },
      "reporter": {
       "type": "string",
       "example": "BG",
       "description": "Reporter country."
      },
      "date_from": {
       "type": "string",
       "description": "Start."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datanexusai-trade-partners-lookup-1467bb1a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.datanexusai.org](https://www.zero.xyz/host/api.datanexusai.org/llms.txt)