{
  "openapi": "3.1.0",
  "info": {
    "title": "AI Fusion One API",
    "version": "0.10.3-discover-testnet",
    "termsOfService": "https://theaiworldnetwork.com/v1/terms",
    "x-privacy-policy": "https://theaiworldnetwork.com/v1/privacy",
    "x-legal-status": "DRAFT - pending legal review; not yet in effect for real-money use",
    "description": "AI-to-AI intelligence, verification and transaction-assistance API. Phase C: x402 payments in TESTNET mode only (Base Sepolia test USDC, no real value) for basic_lookup, basic_verification and supplier_matching; advanced tiers and quote_preparation are stubs; prices are provisional.",
    "contact": {
      "name": "All AI LLC (AI Fusion One)",
      "email": "urbanek-jeff-z3hzjs@mail.grokbot.com",
      "url": "https://theaiworldnetwork.com"
    },
    "summary": "Pay-per-call, source-attributed intelligence and verification for AI agents (x402, testnet only).",
    "x-testnet-only": true,
    "x-logo": {
      "url": "https://theaiworldnetwork.com/logo.png",
      "altText": "AI Fusion One"
    }
  },
  "servers": [
    {
      "url": "https://theaiworldnetwork.com",
      "description": "Production (Cloudflare Workers). Payments are Base Sepolia TESTNET only."
    }
  ],
  "paths": {
    "/v1/health": {
      "get": {
        "operationId": "getHealth",
        "summary": "Service health",
        "responses": {
          "200": {
            "description": "OK"
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Monitoring"
        ],
        "security": []
      }
    },
    "/v1/terms": {
      "get": {
        "operationId": "getTerms",
        "summary": "Terms of service incl. refund policy (DRAFT pending legal review)",
        "responses": {
          "200": {
            "description": "Terms"
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Discovery"
        ],
        "security": []
      }
    },
    "/v1/privacy": {
      "get": {
        "operationId": "getPrivacy",
        "summary": "Privacy notice: what is logged and retention (DRAFT pending legal review)",
        "responses": {
          "200": {
            "description": "Privacy notice"
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Discovery"
        ],
        "security": []
      }
    },
    "/v1/services": {
      "get": {
        "operationId": "listServices",
        "summary": "Machine-readable service catalog",
        "responses": {
          "200": {
            "description": "Catalog"
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Discovery"
        ],
        "security": []
      }
    },
    "/v1/discover": {
      "get": {
        "operationId": "discover",
        "summary": "Service catalog and discovery links (alias of /v1/services)",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "Catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/v1/pricing": {
      "get": {
        "operationId": "getPricing",
        "summary": "Provisional pricing (not enabled)",
        "responses": {
          "200": {
            "description": "Pricing"
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Discovery"
        ],
        "security": []
      }
    },
    "/v1/intelligence/search": {
      "post": {
        "operationId": "intelligenceSearch",
        "summary": "Entity lookup. basic = $0.05, paid via x402 (Base Sepolia TESTNET, X-PAYMENT header; first call without it returns a 402 challenge) or free demo when payments are off; advanced = 402 stub",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload, base64 JSON (scheme exact, network base-sepolia). Success returns X-PAYMENT-RESPONSE.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 200
                  },
                  "tier": {
                    "enum": [
                      "basic",
                      "advanced"
                    ],
                    "default": "basic"
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 5,
                    "default": 3
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT): limited calls per client per UTC day; result marked mode=trial."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Intelligence"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-service-id": "basic_lookup"
      }
    },
    "/v1/verification/check": {
      "post": {
        "operationId": "verificationCheck",
        "summary": "Evidence report for a supplier (name/website) or product (GTIN/UPC or name). basic = $0.10 x402 TESTNET (X-PAYMENT); advanced = 402 stub",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "subject_type",
                  "subject"
                ],
                "properties": {
                  "subject_type": {
                    "enum": [
                      "supplier",
                      "product",
                      "offer"
                    ]
                  },
                  "subject": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 200,
                    "description": "Supplier: company name (or a domain). Product: GTIN/UPC digits or a name."
                  },
                  "tier": {
                    "enum": [
                      "basic",
                      "advanced"
                    ],
                    "default": "basic"
                  },
                  "website": {
                    "type": "string",
                    "description": "Optional supplier/product website (public domain or URL) for DNS/HTTPS/RDAP/consistency checks."
                  },
                  "name": {
                    "type": "string",
                    "description": "Company name when subject is a domain."
                  },
                  "brand": {
                    "type": "string",
                    "description": "Optional claimed brand to compare with product records."
                  },
                  "country": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{2}$",
                    "description": "Supplier country, ISO 3166-1 alpha-2 (e.g. DE). Narrows GLEIF and selects a keyless national registry (FR, NO, CZ, FI, PL)."
                  },
                  "vat_number": {
                    "type": "string",
                    "maxLength": 24,
                    "description": "EU VAT number with member-state prefix (e.g. DE811128135, EL..., XI...) to validate through VIES."
                  },
                  "registry_id": {
                    "type": "string",
                    "maxLength": 24,
                    "description": "National registry id with country: SIREN/SIRET (FR), organisasjonsnummer (NO, 9 digits) or IČO (CZ, 8 digits)."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Source-attributed result (standard contract)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Intelligence"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.10",
        "x-testnet-only": true,
        "x-service-id": "basic_verification"
      }
    },
    "/v1/transactions/quote": {
      "post": {
        "operationId": "transactionsQuote",
        "summary": "service=supplier_matching: candidate suppliers from Wikidata, $0.25 x402 TESTNET (X-PAYMENT). service=quote_preparation: 402 stub",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "service",
                  "requirement"
                ],
                "properties": {
                  "service": {
                    "enum": [
                      "supplier_matching",
                      "quote_preparation"
                    ]
                  },
                  "requirement": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 1000
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10
                  },
                  "sector": {
                    "enum": [
                      "robotics",
                      "drones",
                      "industrial_machinery",
                      "sensors_iot"
                    ],
                    "description": "Optional sector: restricts curated category mapping (robotics, drones, industrial_machinery, sensors_iot). Unmappable requirements return no_candidates, never a guess."
                  },
                  "country": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{2}$",
                    "description": "Optional ISO 3166-1 alpha-2 filter: only candidates whose Wikidata country matches."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Source-attributed result (standard contract)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Intelligence"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.25",
        "x-testnet-only": true,
        "x-service-id": "supplier_matching"
      }
    },
    "/v1/transactions/{id}": {
      "get": {
        "operationId": "getTransaction",
        "summary": "Get receipt/record; requires the receipt token as Bearer auth",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "receiptToken": []
          }
        ],
        "responses": {
          "200": {
            "description": "Transaction record",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "401": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Receipts"
        ]
      }
    },
    "/v1/data/cyber_threats": {
      "post": {
        "operationId": "cyber_threats",
        "summary": "Cyber threat intelligence: $0.05 x402 TESTNET (provisional). Known-exploited status (CISA KEV), exploitation probability (FIRST EPSS) and open-source vulnerability records (OSV.dev, permissively licensed sources only) for a CVE id or an open-source package version. Free sources, no sign-up. Not a vulnerability scan of your systems.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "cve": {
                    "type": "string",
                    "pattern": "^CVE-[0-9]{4}-[0-9]{4,19}$",
                    "description": "CVE id, e.g. CVE-2021-44228."
                  },
                  "ecosystem": {
                    "enum": [
                      "npm",
                      "PyPI",
                      "Go",
                      "crates.io",
                      "Maven",
                      "NuGet",
                      "Packagist",
                      "RubyGems",
                      "Hex",
                      "Pub",
                      "Julia",
                      "GitHub Actions",
                      "Hackage",
                      "ConanCenter",
                      "SwiftURL"
                    ],
                    "description": "Package ecosystem (with package and version)."
                  },
                  "package": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 214,
                    "description": "Package name, e.g. lodash."
                  },
                  "version": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 64,
                    "description": "Exact package version, e.g. 4.17.15."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 20,
                    "default": 10,
                    "description": "Max vulnerabilities (package mode)."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "cve": "CVE-2021-44228"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "cyber_threats"
      }
    },
    "/v1/data/weather_alerts": {
      "post": {
        "operationId": "weather_alerts",
        "summary": "Weather forecast and alerts: $0.05 x402 TESTNET (provisional). Short-range forecast plus active official alerts for a point in the US (NOAA National Weather Service, public domain) or a forecast anywhere in the world (MET Norway api.met.no, CC BY 4.0 / NLOD 2.0). provider=auto uses NWS inside the US and MET Norway elsewhere. US state alert lookup supported. Not a substitute for official warnings.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "lat": {
                    "type": "number",
                    "minimum": -90,
                    "maximum": 90,
                    "description": "Latitude (decimal degrees)."
                  },
                  "lon": {
                    "type": "number",
                    "minimum": -180,
                    "maximum": 180,
                    "description": "Longitude (decimal degrees)."
                  },
                  "state": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{2}$",
                    "description": "US state/territory code for active alerts only (e.g. KS), instead of lat/lon."
                  },
                  "provider": {
                    "enum": [
                      "auto",
                      "nws",
                      "metno"
                    ],
                    "default": "auto"
                  },
                  "periods": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 14,
                    "default": 6,
                    "description": "NWS forecast periods (MET Norway returns 12 hourly steps)."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "lat": 39.0997,
                    "lon": -94.5786
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "weather_alerts"
      }
    },
    "/v1/data/transport_disruptions": {
      "post": {
        "operationId": "transport_disruptions",
        "summary": "US airport delays and closures: $0.05 x402 TESTNET (provisional). Current FAA National Airspace System status: arrival/departure delays, ground delay programs, ground stops and airport closures, for all US airports or one airport (IATA code). US government data (public domain). Absence of an entry is not a guarantee of no delay.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "airport": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3,4}$",
                    "description": "Optional 3-letter IATA (or K+3 ICAO) airport code, e.g. JFK."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "airport": "JFK"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "transport_disruptions"
      }
    },
    "/v1/data/hazards": {
      "post": {
        "operationId": "hazards",
        "summary": "Global natural hazards: $0.05 x402 TESTNET (provisional). Recent earthquakes (USGS), open natural events such as storms, wildfires, volcanoes (NASA EONET) and GDACS orange/red disaster alerts (EC-JRC/UN, CC BY 4.0), globally or within a radius of a point. Each source reported separately.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "lat": {
                    "type": "number",
                    "minimum": -90,
                    "maximum": 90,
                    "description": "Latitude (decimal degrees)."
                  },
                  "lon": {
                    "type": "number",
                    "minimum": -180,
                    "maximum": 180,
                    "description": "Longitude (decimal degrees)."
                  },
                  "radius_km": {
                    "type": "integer",
                    "minimum": 10,
                    "maximum": 20000,
                    "default": 500,
                    "description": "Radius around lat/lon (needs lat and lon)."
                  },
                  "days": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 7,
                    "default": 2
                  },
                  "min_magnitude": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 9,
                    "default": 4.5,
                    "description": "Minimum earthquake magnitude."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 30,
                    "default": 15,
                    "description": "Max items per source."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "lat": 35.68,
                    "lon": 139.69,
                    "radius_km": 1000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "hazards"
      }
    },
    "/v1/data/trade_rules": {
      "post": {
        "operationId": "trade_rules",
        "summary": "Tariffs and trade regulations: $0.05 x402 TESTNET (provisional). kind=tariff_us: US Harmonized Tariff Schedule lines/rates (USITC HTS). kind=tariff_uk: UK Global Tariff duty, VAT and measures for a commodity code (GOV.UK Trade Tariff, Open Government Licence v3). kind=regulations: US eCFR sections and Federal Register documents matching a query. Informational, not customs or legal advice.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "kind",
                  "query"
                ],
                "additionalProperties": false,
                "properties": {
                  "kind": {
                    "enum": [
                      "tariff_us",
                      "tariff_uk",
                      "regulations"
                    ]
                  },
                  "query": {
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 200,
                    "description": "HTS code or product keyword (tariff_us); 10-digit commodity code or keyword (tariff_uk); search terms (regulations)."
                  },
                  "country": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{2}$",
                    "description": "tariff_uk only: ISO alpha-2 origin country to include country-specific measures."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 25,
                    "default": 10
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "kind": "tariff_us",
                    "query": "8471.30"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "trade_rules"
      }
    },
    "/v1/data/news_events": {
      "post": {
        "operationId": "news_events",
        "summary": "Global news events: $0.05 x402 TESTNET (provisional). Recent worldwide news articles matching a query from the GDELT Project (open, citation required): title, URL, domain, language, source country, time seen. Metadata only, no article text. Reports are machine-collected media coverage, not verified facts.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "additionalProperties": false,
                "properties": {
                  "query": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 200,
                    "description": "Search terms (GDELT DOC syntax, e.g. earthquake Japan)."
                  },
                  "timespan": {
                    "type": "string",
                    "pattern": "^[0-9]{1,3}(min|h|d)$",
                    "default": "24h",
                    "description": "Look-back window, e.g. 60min, 24h, 3d (15min to 7d)."
                  },
                  "limit": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 25,
                    "default": 10
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "query": "port strike",
                    "timespan": "24h",
                    "limit": 5
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "news_events"
      }
    },
    "/v1/data/api_status": {
      "post": {
        "operationId": "api_status",
        "summary": "API availability and x402 price probe: $0.05 x402 TESTNET (provisional). AI Fusion One probes a public http(s) URL from the Cloudflare edge and reports availability, HTTP status, latency (1-3 samples) and, if the endpoint answers HTTP 402, the x402 payment requirements (network, asset, price). SSRF-protected: only public hostnames on ports 80/443, GET only, redirects reported not followed, 8 s timeout, 64 KB cap. Measured by us, from one vantage point.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "url"
                ],
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "type": "string",
                    "minLength": 8,
                    "maxLength": 500,
                    "description": "Public http(s) URL with a hostname (no IP literals, no credentials, default port only)."
                  },
                  "samples": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 3,
                    "default": 1
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "url": "https://theaiworldnetwork.com/v1/health"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "api_status"
      }
    },
    "/v1/data/currency_convert": {
      "post": {
        "operationId": "currency_convert",
        "summary": "Currency conversion (ECB daily reference rates): $0.05 x402 TESTNET (provisional). Convert an amount between EUR and the ~30 currencies in the European Central Bank's euro foreign exchange reference rates (cross rates computed through EUR). Returns the rate date, the unmodified ECB rates used, and attribution (Source: ECB statistics). Published for information only; the ECB strongly discourages using these rates for transactions. Not a live market quote.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "amount",
                  "from",
                  "to"
                ],
                "additionalProperties": false,
                "properties": {
                  "amount": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1000000000000,
                    "description": "Amount in the 'from' currency."
                  },
                  "from": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3}$",
                    "description": "ISO 4217 code, e.g. USD (EUR or an ECB-quoted currency)."
                  },
                  "to": {
                    "type": "string",
                    "pattern": "^[A-Za-z]{3}$",
                    "description": "ISO 4217 code, e.g. JPY."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "amount": 100,
                    "from": "USD",
                    "to": "EUR"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "currency_convert"
      }
    },
    "/v1/data/email_validate": {
      "post": {
        "operationId": "email_validate",
        "summary": "Email address validation (syntax + DNS MX): $0.05 x402 TESTNET (provisional). Checks an email address's syntax (RFC 5321 dot-atom subset), whether its domain exists and can receive mail (DNS MX, with the A/AAAA fallback, via DNS-over-HTTPS), whether the domain is on a CC0 disposable-email blocklist, and whether the local part is a role account (info@, admin@). Does NOT contact the mail server (no SMTP probing), so it cannot confirm that a mailbox exists. The address is not stored by AI Fusion One.",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "email"
                ],
                "additionalProperties": false,
                "properties": {
                  "email": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 254,
                    "description": "Email address to check, e.g. someone@example.com."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "email": "someone@gmail.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "email_validate"
      }
    },
    "/v1/data/web_check": {
      "post": {
        "operationId": "web_check",
        "summary": "Website DNS, TLS, redirect and security-header check: $0.05 x402 TESTNET (provisional). Public-website health check measured by AI Fusion One from the Cloudflare edge: DNS records via DNS-over-HTTPS (A, AAAA, CNAME, NS, MX, CAA, SPF), HTTPS reachability with certificate validation by the edge, HTTP-to-HTTPS redirect, the redirect chain (each hop re-checked), and common security headers (HSTS, CSP, X-Content-Type-Options, X-Frame-Options, Referrer-Policy, Permissions-Policy, COOP/CORP). SSRF-protected: public DNS hostnames on ports 80/443 only, GET only, redirects followed manually (max 4) with",
        "parameters": [
          {
            "name": "X-PAYMENT",
            "in": "header",
            "required": false,
            "description": "x402 v1 payment payload (base64 JSON). Omit to receive the 402 challenge.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "url"
                ],
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 500,
                    "description": "Public website URL or hostname (https assumed if no scheme). No IP literals, credentials or custom ports."
                  },
                  "trial": {
                    "type": "boolean",
                    "description": "Free trial (no X-PAYMENT)."
                  }
                }
              },
              "examples": {
                "sample": {
                  "summary": "Example request",
                  "value": {
                    "url": "https://theaiworldnetwork.com"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source-attributed result with receipt",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataResult"
                }
              }
            }
          },
          "400": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "Payment required: x402 v1 challenge with exact payment requirements (also returned when trial capacity is exhausted)",
            "headers": {
              "x-aifusion-trial-remaining": {
                "description": "Remaining free trial calls today (on trial responses)",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentRequired"
                }
              }
            }
          },
          "413": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "502": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "tags": [
          "Data"
        ],
        "security": [
          {},
          {
            "x402": []
          }
        ],
        "x-price-usd": "0.05",
        "x-testnet-only": true,
        "x-mcp-tool": "web_check"
      }
    },
    "/openapi.json": {
      "get": {
        "operationId": "getOpenApi",
        "summary": "This OpenAPI 3.1 document",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "OpenAPI document",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/status": {
      "get": {
        "operationId": "getStatus",
        "summary": "Human status page (HTML) or JSON health with Accept: application/json",
        "tags": [
          "Monitoring"
        ],
        "responses": {
          "200": {
            "description": "Status",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "Degraded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/performance": {
      "get": {
        "operationId": "getPerformancePage",
        "summary": "Public performance history page (HTML); JSON with Accept: application/json",
        "tags": [
          "Monitoring"
        ],
        "responses": {
          "200": {
            "description": "Performance history",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              },
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Performance"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/v1/performance": {
      "get": {
        "operationId": "getPerformance",
        "summary": "Public performance history as JSON: uptime, success rate, latency histogram percentiles, targets vs measured",
        "tags": [
          "Monitoring"
        ],
        "responses": {
          "200": {
            "description": "Performance history",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Performance"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsTxt",
        "summary": "llms.txt: plain-text guide for AI agents",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "llms.txt",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/apis.json": {
      "get": {
        "operationId": "getApisJson",
        "summary": "APIs.json discovery document",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "APIs.json",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/.well-known/agent-card.json": {
      "get": {
        "operationId": "getAgentCard",
        "summary": "A2A agent card",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "Agent card",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "operationId": "getMcpDiscovery",
        "summary": "MCP discovery document",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "MCP discovery",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/docs": {
      "get": {
        "operationId": "getDocsQuickstart",
        "summary": "Quickstart page (HTML): 5-minute path, free trial, MCP, x402",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "HTML page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/docs/try": {
      "get": {
        "operationId": "getDocsSandbox",
        "summary": "Sandbox page (HTML): run free-trial calls in the browser",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "HTML page",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/docs/try.js": {
      "get": {
        "operationId": "getDocsSandboxScript",
        "summary": "Sandbox script (same-origin JavaScript used only by /docs/try)",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "JavaScript",
            "content": {
              "application/javascript": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/.well-known/service-catalog.json": {
      "get": {
        "operationId": "getServiceCatalogWellKnown",
        "summary": "Service catalog (same as /v1/services)",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "Catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "operationId": "getMcpServerCard",
        "summary": "MCP static server card (Smithery format: serverInfo + tools)",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "Server card",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/robots.txt": {
      "get": {
        "operationId": "getRobots",
        "summary": "robots.txt",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "robots.txt",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/sitemap.xml": {
      "get": {
        "operationId": "getSitemap",
        "summary": "sitemap.xml",
        "tags": [
          "Discovery"
        ],
        "responses": {
          "200": {
            "description": "Sitemap",
            "content": {
              "application/xml": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited (per-IP, per-network or daily capacity)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    },
    "/mcp": {
      "post": {
        "operationId": "mcpRpc",
        "summary": "Model Context Protocol (Streamable HTTP, JSON-RPC 2.0). Tools: get_pricing, get_receipt (free) and one tool per paid service; paid tools take x402_payment or trial:true.",
        "tags": [
          "MCP"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "method"
                ],
                "properties": {
                  "jsonrpc": {
                    "const": "2.0"
                  },
                  "id": {
                    "type": [
                      "string",
                      "integer"
                    ]
                  },
                  "method": {
                    "type": "string",
                    "examples": [
                      "tools/list",
                      "tools/call"
                    ]
                  },
                  "params": {
                    "type": "object",
                    "additionalProperties": true
                  }
                }
              },
              "examples": {
                "listTools": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "tools/list"
                  }
                },
                "getPricing": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 2,
                    "method": "tools/call",
                    "params": {
                      "name": "get_pricing",
                      "arguments": {}
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response (application/json or text/event-stream)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": []
      }
    }
  },
  "components": {
    "securitySchemes": {
      "receiptToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "Receipt token returned when a transaction is created."
      },
      "x402": {
        "type": "apiKey",
        "in": "header",
        "name": "X-PAYMENT",
        "description": "x402 v1 payment payload (base64 JSON; scheme exact, network base-sepolia, test USDC). Optional: omit it to receive the 402 challenge with exact requirements, or send trial:true in the body for a free trial call."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "status",
              "request_id"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "invalid_json",
                  "invalid_parameter",
                  "payload_too_large",
                  "not_found",
                  "method_not_allowed",
                  "unauthorized",
                  "payment_required",
                  "payment_verification_unavailable",
                  "payment_already_used",
                  "payment_settlement_unknown",
                  "rate_limited",
                  "daily_capacity_reached",
                  "challenge_capacity_reached",
                  "trial_unavailable",
                  "demo_capacity_reached",
                  "upstream_error",
                  "service_disabled",
                  "internal_error"
                ]
              },
              "message": {
                "type": "string"
              },
              "status": {
                "type": "integer"
              },
              "request_id": {
                "type": "string"
              },
              "payment": {
                "type": "object",
                "description": "Present on 402: machine-readable price and (stub) protocol status."
              }
            }
          }
        }
      },
      "PaymentRequired": {
        "type": "object",
        "required": [
          "x402Version",
          "accepts"
        ],
        "properties": {
          "x402Version": {
            "type": "integer",
            "const": 1
          },
          "error": {
            "type": "string"
          },
          "error_code": {
            "type": "string"
          },
          "accepts": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "scheme",
                "network",
                "maxAmountRequired",
                "resource",
                "payTo",
                "asset"
              ],
              "properties": {
                "scheme": {
                  "type": "string",
                  "const": "exact"
                },
                "network": {
                  "type": "string",
                  "const": "base-sepolia"
                },
                "maxAmountRequired": {
                  "type": "string",
                  "description": "Atomic USDC units (6 decimals); 50000 = $0.05"
                },
                "resource": {
                  "type": "string",
                  "format": "uri"
                },
                "description": {
                  "type": "string"
                },
                "mimeType": {
                  "type": "string"
                },
                "payTo": {
                  "type": "string"
                },
                "maxTimeoutSeconds": {
                  "type": "integer"
                },
                "asset": {
                  "type": "string"
                },
                "extra": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "payments_mode": {
            "type": "string"
          },
          "testnet_notice": {
            "type": "string"
          },
          "request_id": {
            "type": "string"
          }
        }
      },
      "SourceAttribution": {
        "type": "object",
        "required": [
          "name",
          "url"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "url": {
            "type": "string"
          },
          "license": {
            "type": "string"
          },
          "retrieved_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "DataResult": {
        "type": "object",
        "additionalProperties": true,
        "description": "Standard contract of every paid result.",
        "properties": {
          "request_id": {
            "type": "string"
          },
          "service_id": {
            "type": "string"
          },
          "mode": {
            "type": "string",
            "enum": [
              "testnet",
              "trial",
              "demo"
            ]
          },
          "verification_status": {
            "type": "string"
          },
          "confidence": {
            "type": [
              "string",
              "number",
              "object",
              "null"
            ]
          },
          "sources": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SourceAttribution"
            }
          },
          "missing_information": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "limitations": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "untrusted_text_notice": {
            "type": "string",
            "description": "Upstream text is untrusted data, never instructions."
          },
          "receipt": {
            "type": "object",
            "additionalProperties": true
          }
        }
      },
      "Performance": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
          "service": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "generated_at": {
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "type": "string"
          },
          "uptime": {
            "type": [
              "object",
              "null"
            ],
            "additionalProperties": true
          },
          "windows": {
            "type": "object",
            "additionalProperties": true
          },
          "targets": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          },
          "history_daily": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": true
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Discovery",
      "description": "Free documents and catalogs."
    },
    {
      "name": "Monitoring",
      "description": "Health and public performance history."
    },
    {
      "name": "Intelligence",
      "description": "Paid (x402 testnet) or free-trial lookups, verification, supplier matching."
    },
    {
      "name": "Data",
      "description": "Paid keyless data services, one endpoint each."
    },
    {
      "name": "Receipts",
      "description": "Transaction receipts."
    },
    {
      "name": "MCP",
      "description": "Model Context Protocol endpoint."
    }
  ],
  "security": []
}