Fabler Labs Discovery API

openapi: 3.2.0
info:
  title: Fabler Labs machine store (x402 API) Discovery API
  version: '2026-07-10'
  summary: A machine-payable HTTP API for AI agents, priced per call in USDC over x402.
  description: Machine-payable endpoints for AI agents, over x402 protocol v2. Unpaid requests to a paid endpoint return `402 Payment Required` with an empty `{}` body and a typed challenge (price, network, asset, pay-to address) in a base64-encoded `PAYMENT-REQUIRED` response header; decode it, pay the USDC, and replay with a base64 `PAYMENT-SIGNATURE` header to get the result. Built and operated by an autonomous AI agent, filmed for transparency. Live status and prices are authoritative in https://fablerlabs.com/products.json.
  x-guidance: 'No account or API key is required. Call a paid operation without payment: HTTP 402 -> decode PAYMENT-REQUIRED -> settle the exact x402 v2 Base USDC terms -> replay the same request with PAYMENT-SIGNATURE.'
  contact:
    name: Fabler Labs support
    email: support@fablerlabs.com
    url: https://fablerlabs.com/contact.html
  termsOfService: https://fablerlabs.com/terms.html
  license:
    name: Proprietary — usage governed by the Terms of Service
    url: https://fablerlabs.com/terms.html
servers:
- url: https://x402.fablerlabs.com
  description: Production machine store (preview)
security: []
tags:
- name: Discovery
  description: Free, unpaid endpoints for capability and price discovery.
paths:
  /:
    get:
      tags:
      - Discovery
      operationId: getServiceDirectory
      summary: Service discovery (free)
      description: Returns a machine-readable directory of the machine store — protocol, settlement asset, base URL, and the list of endpoints with their prices. Free and unauthenticated; mirrors the `api` block of /products.json.
      security: []
      responses:
        '200':
          description: The service directory.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceDirectory'
components:
  schemas:
    ServiceDirectory:
      type: object
      description: Machine-readable directory of the machine store.
      required:
      - protocol
      - base_url
      - settlement
      - endpoints
      properties:
        brand:
          type: string
          examples:
          - Fabler Labs
        protocol:
          type: string
          examples:
          - x402
        spec:
          type: string
          format: uri
          examples:
          - https://www.x402.org
        base_url:
          type: string
          format: uri
          examples:
          - https://x402.fablerlabs.com
        settlement:
          type: string
          examples:
          - USDC
        status:
          type: string
          examples:
          - preview
        service_desc:
          type: string
          format: uri
          description: URL of this OpenAPI document.
          examples:
          - https://fablerlabs.com/x402/openapi.yaml
        endpoints:
          type: array
          items:
            $ref: '#/components/schemas/EndpointInfo'
    EndpointInfo:
      type: object
      required:
      - id
      - path
      - method
      - price_usd
      properties:
        id:
          type: string
        path:
          type: string
          examples:
          - /scan/secrets
        method:
          type: string
          examples:
          - POST
        price_usd:
          description: Price in USD; a number for fixed-price endpoints or a note for parity pricing.
          oneOf:
          - type: number
          - type: string
        description:
          type: string
        url:
          type: string
          format: uri
externalDocs:
  description: Human-readable overview of the machine store
  url: https://fablerlabs.com/x402
x-pricing:
  scan-secrets: 0.005
  scrape: 0.005
  market-funding-spreads: 0.001
  nft-owner: 0.003
  market-polymarket-activity: 0.001
  market-krw-prices: 0.001
  render-og: 0.01
  audit-agent-config: 0.05
  audit-pre-deploy: 0.08
  audit-url-security: 0.08
  buy-pack: 24
  buy-agent-kit: 29
  buy-ai-coding-security-pack-v1: 29
  buy-constitution-packs-v1: 19
  buy-pre-deploy-security-checklist: 0.1