timzinin-com China Fdi Flow Position Monitor API

openapi: 3.2.0
info:
  title: Zinin M2M Hub China Fdi Flow Position Monitor API
  description: Pay-per-call data & tool APIs
  version: 1.0.0
  x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: China Fdi Flow Position Monitor
paths:
  /api/china-fdi-flow-position-monitor:
    post:
      summary: China FDI Flow & Position Monitor
      description: Monitor official OECD China FDI financial flows and positions by assets and liabilities, with paid-delivery-safe deltas.
      operationId: call_china_fdi_flow_position_monitor
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: http://json-schema.org/draft-07/schema#
              schemaVersion: 1
              title: China FDI Flow & Position Monitor input
              description: Select one or both fixed OECD FDI datasets for China and an inclusive window of at most 10 years. The Actor makes at most two official data requests and never uses a proxy or VPN.
              type: object
              additionalProperties: false
              properties:
                datasets:
                  title: FDI datasets
                  description: Official OECD aggregate financial flows (quarterly), positions (annual), or both. Values use the assets/liabilities accounting principle; they are not inbound/outbound labels.
                  type: array
                  editor: select
                  minItems: 1
                  maxItems: 2
                  uniqueItems: true
                  default:
                  - flow
                  - position
                  prefill:
                  - flow
                  - position
                  items:
                    type: string
                    enum:
                    - flow
                    - position
                    enumTitles:
                    - Quarterly FDI financial flows
                    - Annual FDI financial positions
                startYear:
                  title: Start year
                  description: Inclusive first year. Runtime validation enforces 2005 or later and a maximum 10-year window.
                  type: integer
                  minimum: 2005
                  default: 2021
                  prefill: 2021
                endYear:
                  title: End year
                  description: Inclusive last year, not later than the current UTC year.
                  type: integer
                  minimum: 2005
                  default: 2025
                  prefill: 2025
                watchName:
                  title: Watch name
                  description: Stable private baseline scope. Reuse it in scheduled runs to compare only against a previously confirmed paid delivery.
                  type: string
                  editor: textfield
                  minLength: 1
                  maxLength: 80
                  pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,79}$
                  default: china-fdi-main
                  prefill: china-fdi-main
                cacheMaxAgeMinutes:
                  title: Source cache age
                  description: Reuse a validated official OECD response for 0-120 minutes. Set 0 to disable cache reads. Cache state never changes the paid-delivery baseline.
                  type: integer
                  editor: number
                  minimum: 0
                  maximum: 120
                  default: 60
                  prefill: 60
                  unit: minutes
      responses:
        '200':
          description: Actor run succeeded and payment settled
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                    description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
                  meta:
                    type: object
                    properties:
                      run_ms:
                        type: integer
                        description: Actor run duration in milliseconds
                      item_count:
                        type: integer
                        description: len(results)
                      settled:
                        type: boolean
                        description: Whether the x402 payment was confirmed settled by the facilitator
                      transaction:
                        type:
                        - string
                        - 'null'
                        description: On-chain settlement transaction hash, null if unsettled
                    required:
                    - run_ms
                    - item_count
                    - settled
                    - transaction
                required:
                - results
                - meta
        '400':
          description: Malformed PAYMENT-SIGNATURE header or request body
        '402':
          description: Payment required or invalid — see PAYMENT-REQUIRED header
        '409':
          description: Payment payload already used
        '502':
          description: Actor run failed
        '504':
          description: Actor run timed out
      tags:
      - China Fdi Flow Position Monitor