Agent Revenue Network Providers API

openapi: 3.2.0
info:
  title: Agent Revenue Network Providers API
  version: 1.2.8
  description: Translation, data quality, execution verification and agent utilities. Paid operations use x402 USDC on Base mainnet.
servers:
- url: https://www.agentrevenuenetwork.com
tags:
- name: Providers
paths:
  /v1/providers/route:
    post:
      operationId: route_provider
      summary: Route Provider
      description: Rank up to 1,000 caller-supplied providers by quality, success rate, price and latency, returning one selection plus at most three alternates. Candidates marked unhealthy or priced above requirements.maxPrice are excluded; quality defaults to successRate and an empty eligible set returns selected=null with a reason. Use this free read-only calculation only with comparable metrics you already hold because it neither discovers providers nor verifies measurements.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Rank a caller-supplied provider set. ARN does not discover providers or independently verify these metrics in this free call.
              required:
              - providers
              properties:
                requirements:
                  type: object
                  properties:
                    maxPrice:
                      type: number
                      minimum: 0
                      description: Optional maximum provider price. Providers above it are excluded.
                  additionalProperties: true
                  description: Routing constraints. maxPrice is the currently enforced constraint.
                providers:
                  type: array
                  maxItems: 1000
                  items:
                    type: object
                    description: Caller-supplied provider candidate and measured/estimated routing attributes.
                    properties:
                      id:
                        type: string
                        description: Optional stable provider identifier.
                      name:
                        type: string
                        description: Optional provider display name.
                      healthy:
                        type: boolean
                        default: true
                        description: Set false to exclude this provider from routing.
                      successRate:
                        type: number
                        minimum: 0
                        maximum: 1
                        default: 0.5
                        description: Observed or estimated success rate.
                      quality:
                        type: number
                        minimum: 0
                        maximum: 1
                        description: Observed or estimated quality score. Defaults to successRate.
                      price:
                        type: number
                        minimum: 0
                        default: 0
                        description: Comparable per-execution price used by the ranking formula.
                      latencyMs:
                        type: number
                        minimum: 0
                        default: 1000
                        description: Comparable latency in milliseconds.
                    additionalProperties: true
                  description: Up to 1,000 provider candidates to rank. An empty list returns no eligible provider; unhealthy candidates are excluded.
              additionalProperties: false
      responses:
        '200':
          description: Successful tool result
      tags:
      - Providers
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer