EXVIV Paid market data API

Fixed-price x402 service-directory queries.

GitHub OpenAPI

Operations 1

GET /api/x402/v1/query Buy one filtered x402 service-directory query #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/exviv-com:exviv-com-paid-market-data-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

exviv-com-paid-market-data-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: EXVIV Agent Intel Paid market data API
  version: 1.0.0
  termsOfService: https://exviv.com/terms
  contact:
    email: info@exviv.com
  description: Accountless x402 market data and evidence-backed competitive intelligence. Discover inputs for free, then pay per resource with x402 v2 and receive JSON after settlement. Sending PAYMENT-SIGNATURE accepts the EXVIV Terms of Service for that purchase.
  x-guidance: Start with GET /api/agent/v1/catalog to discover valid company and market slugs. Call a paid GET endpoint without PAYMENT-SIGNATURE to receive its x402 v2 challenge, apply the wallet spend policy to the exact requirement, then retry the identical URL with PAYMENT-SIGNATURE. Retain PAYMENT-RESPONSE as the settlement receipt. Do not guess slugs or retry an indeterminate settlement without checking the transaction.
  x-privacy-policy: https://exviv.com/privacy
  x-refund-policy: https://exviv.com/refunds#agent-purchases
servers:
- url: https://exviv.com
tags:
- name: Paid market data
  description: Fixed-price x402 service-directory queries.
paths:
  /api/x402/v1/query:
    get:
      operationId: buyX402DirectoryQuery
      summary: Buy one filtered x402 service-directory query
      description: Returns EXVIV's normalized business-level view of public x402 listings filtered by intent, network, price, reported calls, payer observations, activity state, and input-schema evidence. Sorting is explicit and does not imply an EXVIV endorsement. Without PAYMENT-SIGNATURE, returns an x402 v2 challenge for $0.05 USDC.
      tags:
      - Paid market data
      parameters:
      - name: q
        in: query
        required: false
        description: Service capability or buyer intent.
        schema:
          type: string
          maxLength: 200
        example: competitive intelligence
      - name: network
        in: query
        required: false
        schema:
          type: string
          enum:
          - base
          - solana
      - name: maxPrice
        in: query
        required: false
        description: Maximum published USDC price per listed endpoint.
        schema:
          type: string
          pattern: ^\d{1,6}(?:\.\d{1,6})?$
      - name: minCalls30d
        in: query
        required: false
        description: Minimum reported calls summed across the business endpoints.
        schema:
          type: integer
          minimum: 0
          maximum: 1000000000
          default: 0
      - name: minPayers30d
        in: query
        required: false
        description: Minimum reported payer observations summed across the business endpoints.
        schema:
          type: integer
          minimum: 0
          maximum: 1000000000
          default: 0
      - name: activity
        in: query
        required: false
        description: 'Exact EXVIV activity state: active means called within 24 hours; observed means older reported calls; listed means no reported calls.'
        schema:
          type: string
          enum:
          - active
          - observed
          - listed
      - name: hasInputSchema
        in: query
        required: false
        description: When true, require at least one endpoint with published input-schema evidence.
        schema:
          type: boolean
          default: false
      - name: sort
        in: query
        required: false
        schema:
          type: string
          enum:
          - calls30d
          - payers30d
          - price
          - recent
          default: calls30d
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 20
          default: 10
      - $ref: '#/components/parameters/PaymentSignature'
      x-exviv-product-id: x402_directory_query
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402: {}
      x-payment-protocol:
        name: x402
        version: 2
        priceUsd: '0.05'
        settlementAsset: USDC
      responses:
        '200':
          description: Payment settled and intel delivered.
          headers:
            PAYMENT-RESPONSE:
              description: Base64-encoded x402 settlement receipt.
              schema:
                type: string
            EXTENSION-RESPONSES:
              description: Base64-encoded facilitator extension outcomes, including Bazaar indexing status when returned.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentIntel'
        '400':
          description: Invalid input or payment payload.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentError'
        '402':
          description: Payment Required
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 PaymentRequired object.
              schema:
                type: string
            PAYMENT-RESPONSE:
              description: Base64-encoded x402 settlement result when settlement was attempted.
              schema:
                type: string
            EXTENSION-RESPONSES:
              description: Base64-encoded facilitator extension outcomes, including Bazaar indexing status when returned.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentError'
        '404':
          description: Requested market or reviewed pricing company not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentError'
        '503':
          description: Agent commerce is not configured on this deployment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentError'
components:
  schemas:
    AgentIntel:
      type: object
      required:
      - schemaVersion
      - productId
      - generatedAt
      - purchase
      - dataset
      - evidencePolicy
      - intel
      properties:
        schemaVersion:
          const: exviv.agent-intel.v1
        productId:
          enum:
          - x402_directory_query
          - pricing_snapshot
          - pricing_comparison
          - market_brief
        generatedAt:
          type: string
          format: date-time
        purchase:
          type: object
          required:
          - protocol
          - protocolVersion
          - productId
          - transaction
          - settledAt
          properties:
            protocol:
              const: x402
            protocolVersion:
              const: 2
            productId:
              type: string
            priceUsd:
              type: string
            amountAtomic:
              type: string
            asset:
              type: string
            network:
              type: string
            transaction:
              type: string
            payer:
              type:
              - string
              - 'null'
            settledAt:
              type: string
              format: date-time
        dataset:
          type: object
        evidencePolicy:
          type: object
        intel:
          type: object
    AgentError:
      type: object
      required:
      - schemaVersion
      - error
      properties:
        schemaVersion:
          const: exviv.agent-error.v1
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
            message:
              type: string
            productId:
              type: string
            price:
              type: object
        links:
          type: object
  parameters:
    PaymentSignature:
      name: PAYMENT-SIGNATURE
      in: header
      required: false
      description: Base64-encoded x402 v2 PaymentPayload. Omit on the first request to receive payment requirements.
      schema:
        type: string