openapi: 3.2.0
info:
  title: Qorevia Market Intelligence Data API
  version: 2.0.0
  description: Agent-payable market intelligence, data profiling and deterministic utility tools.
  x-guidance: Use these tools for market/session/risk/backtest context and local data profiling. Paid routes use HTTP 402/x402 and settle USDC directly to the provider wallet.
servers:
- url: https://api.flowhomes.eu
tags:
- name: Data
paths:
  /api/csv-profile:
    post:
      summary: 'Profile supplied CSV locally: rows, columns, missing values, unique counts…'
      operationId: csv_profile
      tags:
      - Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                csv:
                  type: string
                  description: CSV text to profile. Request body is bounded by the service HTTP limit.
                delimiter:
                  type: string
                  description: auto, comma, semicolon, tab, pipe, or the literal delimiter character.
                hasHeader:
                  type: boolean
                  description: Defaults to true.
              required:
              - csv
            example:
              csv: 'name,age

                Ada,36

                Bob,

                Cara,29'
              delimiter: auto
              hasHeader: true
      responses:
        '200':
          description: Paid response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                delimiter: ','
                rows: 3
                columnCount: 2
                columns:
                - name: name
                  inferredType: string
                  nonEmpty: 3
                  missing: 0
                  uniqueCount: 3
                - name: age
                  inferredType: integer
                  nonEmpty: 2
                  missing: 1
                  uniqueCount: 2
                  numeric:
                    count: 2
                    min: 29
                    max: 36
                    mean: 32.5
        '402':
          description: x402 payment required
        '503':
          description: Upstream market-data source unavailable; payment is not requested for MT5 routes during preflight failure.
      x-payment-info:
        price: '0.002500'
        currency: USDC
        network: eip155:8453
        protocol: x402
  /api/json-shape:
    post:
      summary: Describe the structural shape of supplied JSON locally using normalized paths…
      operationId: json_shape
      tags:
      - Data
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                value:
                  description: Any JSON value to inspect.
                maxDepth:
                  type: integer
                  minimum: 1
                  maximum: 12
                  description: Maximum traversal depth; defaults to 8.
                maxPaths:
                  type: integer
                  minimum: 10
                  maximum: 1000
                  description: Maximum distinct normalized paths returned; defaults to 500.
              required:
              - value
            example:
              value:
                user:
                  id: 1
                  name: Ada
                items:
                - sku: A
                - sku: B
              maxDepth: 8
      responses:
        '200':
          description: Paid response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                rootType: object
                pathCount: 6
                paths:
                - path: $
                  types:
                  - object
                  occurrences: 1
                - path: $.user.id
                  types:
                  - integer
                  occurrences: 1
                - path: $.items[]
                  types:
                  - object
                  occurrences: 2
                - path: $.items[].sku
                  types:
                  - string
                  occurrences: 2
        '402':
          description: x402 payment required
        '503':
          description: Upstream market-data source unavailable; payment is not requested for MT5 routes during preflight failure.
      x-payment-info:
        price: '0.002500'
        currency: USDC
        network: eip155:8453
        protocol: x402