# China FDI Flow & Position Monitor

> China FDI Flow & Position Monitor is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Returns OECD-sourced China foreign direct investment financial flows and positions, including revised quarterly observations with assets/liabilities breakdown in USD.

## Facts

- Endpoint: POST https://api.timzinin.com/api/china-fdi-flow-position-monitor
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/china-fdi-flow-position-monitor-5132bca7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YZJslXXg2kf2NUKqvsQ8A

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 china-fdi-flow-position-monitor-5132bca7 -d '<json body>'
```

Example prompt: Can you pull the latest OECD China FDI flow data for Q2 2024, showing both assets and liabilities sides in USD, and flag any revised figures?

## When to prefer this

Choose this endpoint when you need structured, OECD-sourced China FDI flow or position data with per-observation USD values, revision flags, and assets/liabilities accounting breakdowns — particularly when building macroeconomic dashboards, investment risk models, or research pipelines that require machine-readable quarterly FDI statistics without scraping OECD SDMX directly.

## Known failure modes

- No data available for requested period — returns empty results array
- OECD SDMX upstream unavailable — may time out or return error
- Invalid query parameters — malformed POST body may return 400
- Payment not settled — x402 payment protocol failure blocks response
- Confidential data flagged — some observations may be suppressed by OECD confidentiality rules

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object containing metadata (run time in ms, settlement status, item count) and an array of results. Each result includes the source OECD API URL and provider, dataset kind (flow or position) and title, adaptation marker and whether data was derived/adapted, change type (e.g. revision), terminology (assets_liabilities), and an array of observations each containing side (assets/liabilities), numeric value, period (e.g. 2024-Q2), currency, USD value, unit multiplier, accounting entry code, and confidentiality status.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endYear": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "datasets": {
   "type": "array",
   "items": {
    "enum": [
     "flow",
     "position"
    ],
    "type": "string"
   },
   "maxItems": 2,
   "minItems": 1,
   "uniqueItems": true
  },
  "startYear": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "watchName": {
   "type": "string",
   "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$",
   "maxLength": 80,
   "minLength": 1
  },
  "cacheMaxAgeMinutes": {
   "type": "integer",
   "maximum": 120,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "source": {
     "apiUrl": "https://sdmx.oecd.org/...",
     "provider": "OECD"
    },
    "dataset": {
     "kind": "flow",
     "title": "FDI financial flows"
    },
    "adaptation": {
     "marker": "ACTOR_DERIVED_DELTA",
     "isAdapted": true
    },
    "changeType": "revision",
    "terminology": "assets_liabilities",
    "observations": [
     {
      "side": "liabilities",
      "value": -8990,
      "period": "2024-Q2",
      "currency": "USD",
      "valueUsd": -8990000000,
      "unitMultiplier": 6,
      "accountingEntry": "L",
      "confidentialityStatus": "F"
     }
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/china-fdi-flow-position-monitor-5132bca7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)
