AveDaris Network API

openapi: 3.2.0
info:
  title: Agent Utility Public Network API
  version: 0.6.0
  contact:
    name: AveDaris
    url: https://api.avedaris.com/docs
    email: hello@schednest.com
  description: '35 pay-per-call agent utilities from $0.001: JSON repair/validate, normalization, DNS/web and company intelligence. USDC on Base, no keys, MCP included. Outcome-first paid APIs for AI agents over x402 on Base USDC, led by AveDaris-routed Company Intelligence.'
  x-guidance: For company or supplier research, prefer POST /v1/paid/vendor-intelligence and include the buyer's real research objective. Use POST /v1/network/task-fit for other jobs. Paid routes return x402 V2 402 challenges before execution. Inspect /v1/network/reputation, /v1/network/preference, and /v1/network/utility-factory for quality and portfolio evidence.
servers:
- url: https://api.avedaris.com
tags:
- name: Network
paths:
  /v1/network/metrics:
    get:
      security: []
      summary: Aggregate network economics
      responses:
        '200':
          description: Network metrics
      tags:
      - Network
      operationId: getV1NetworkMetrics
      x-operation-id-source: derived
  /v1/network/reputation:
    get:
      security: []
      summary: Settlement and execution backed reputation
      responses:
        '200':
          description: Network reputation
      tags:
      - Network
      operationId: getV1NetworkReputation
      x-operation-id-source: derived
  /v1/network/distribution:
    get:
      security: []
      summary: External buyer and revenue acquisition metrics
      responses:
        '200':
          description: Distribution metrics
      tags:
      - Network
      operationId: getV1NetworkDistribution
      x-operation-id-source: derived
  /v1/network/acquisition-funnel:
    get:
      security: []
      summary: External 402 challenge, payment-attempt, and settlement funnel
      responses:
        '200':
          description: Acquisition funnel
      tags:
      - Network
      operationId: getV1NetworkAcquisitionFunnel
      x-operation-id-source: derived
  /v1/network/preference:
    get:
      security: []
      summary: Evidence-based utility preference scoring and optimization recommendations
      responses:
        '200':
          description: Agent Preference Engine snapshot
      tags:
      - Network
      operationId: getV1NetworkPreference
      x-operation-id-source: derived
  /v1/network/learning-closure:
    get:
      security: []
      summary: Settlement-to-learning closure health and eligibility totals
      responses:
        '200':
          description: Learning closure health
      tags:
      - Network
      operationId: getV1NetworkLearningClosure
      x-operation-id-source: derived
  /v1/network/pricing-experiments:
    get:
      security: []
      summary: Read-only bounded pricing experiment telemetry
      responses:
        '200':
          description: Pricing experiment snapshot
      tags:
      - Network
      operationId: getV1NetworkPricingExperiments
      x-operation-id-source: derived
  /v1/network/revenue-engine:
    get:
      security: []
      summary: Evidence-ranked direct utility revenue engine and repeat-buyer cohort gate
      responses:
        '200':
          description: Narrow revenue engine snapshot
      tags:
      - Network
      operationId: getV1NetworkRevenueEngine
      x-operation-id-source: derived
  /v1/network/utility-factory:
    get:
      security: []
      summary: Quality-gated live utility portfolio and expansion pipeline
      responses:
        '200':
          description: Utility Factory snapshot
      tags:
      - Network
      operationId: getV1NetworkUtilityFactory
      x-operation-id-source: derived
  /v1/network/task-fit:
    get:
      security: []
      summary: Natural-language task-fit catalog for AUN utilities
      responses:
        '200':
          description: Task-fit catalog
      tags:
      - Network
      operationId: getV1NetworkTaskFit
      x-operation-id-source: derived
    post:
      security: []
      summary: Rank AUN utilities for a natural-language task
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - task
              properties:
                task:
                  type: string
                budgetUsd:
                  type: number
                  exclusiveMinimum: 0
                minReliability:
                  type: number
                maxLatencyMs:
                  type: number
                  exclusiveMinimum: 0
      responses:
        '200':
          description: Ranked task-fit decision
        '404':
          description: No eligible utility
      tags:
      - Network
      operationId: postV1NetworkTaskFit
      x-operation-id-source: derived
  /v1/network/proof:
    get:
      security: []
      summary: Sanitized transaction proof
      responses:
        '200':
          description: Recent transaction evidence
      tags:
      - Network
      operationId: getV1NetworkProof
      x-operation-id-source: derived
  /v1/network/health:
    get:
      security: []
      summary: Utility health state
      responses:
        '200':
          description: Utility health
      tags:
      - Network
      operationId: getV1NetworkHealth
      x-operation-id-source: derived
x-discovery:
  ownershipProofs:
  - '0x6c10344d3f96511438458e07a6f2be568a76dfff'
  resources:
  - https://api.avedaris.com/v1/paid/json-repair
  - https://api.avedaris.com/v1/paid/entity-normalize
  - https://api.avedaris.com/v1/paid/text-extract-signals
  - https://api.avedaris.com/v1/paid/json-validate
  - https://api.avedaris.com/v1/paid/json-pretty
  - https://api.avedaris.com/v1/paid/json-minify
  - https://api.avedaris.com/v1/paid/url-parse
  - https://api.avedaris.com/v1/paid/url-normalize
  - https://api.avedaris.com/v1/paid/base64-encode
  - https://api.avedaris.com/v1/paid/base64-decode
  - https://api.avedaris.com/v1/paid/text-slugify
  - https://api.avedaris.com/v1/paid/email-normalize
  - https://api.avedaris.com/v1/paid/uuid-validate
  - https://api.avedaris.com/v1/paid/querystring-parse
  - https://api.avedaris.com/v1/paid/dns-lookup
  - https://api.avedaris.com/v1/paid/domain-http-probe
  - https://api.avedaris.com/v1/paid/robots-inspect
  - https://api.avedaris.com/v1/paid/page-metadata
  - https://api.avedaris.com/v1/paid/page-read
  - https://api.avedaris.com/v1/paid/web-read-batch
  - https://api.avedaris.com/v1/paid/company-quick-check
  - https://api.avedaris.com/v1/paid/base-wallet-lookup
  - https://api.avedaris.com/v1/paid/vendor-watch-recheck
  - https://api.avedaris.com/v1/paid/vendor-what-changed
  - https://api.avedaris.com/v1/paid/email-domain-check
  - https://api.avedaris.com/v1/paid/domain-rdap-lookup
  - https://api.avedaris.com/v1/paid/email-auth-check
  - https://api.avedaris.com/v1/paid/website-health-report
  - https://api.avedaris.com/v1/paid/vendor-intelligence
  - https://api.avedaris.com/v1/paid/vendor-intelligence-batch
  - https://api.avedaris.com/v1/paid/data-clean-pipeline
  - https://api.avedaris.com/v1/paid/counterparty-preflight
  - https://api.avedaris.com/v1/paid/domain-trust-score
  - https://api.avedaris.com/v1/paid/ephemeral-utility
  - https://api.avedaris.com/v1/paid/delivery-proof