DefaultBench Operations API

Non-secret service health.

Operations 2

GET /api/v1/discovery/sources Inspect organic source synchronization status #
GET /api/v1/health Check service and database availability #

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/defaultbench-com:defaultbench-com-operations-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

defaultbench-com-operations-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: DefaultBench Operations API
  version: 1.0.0
  summary: Machine-first paid placement and discovery for autonomous agents.
  description: DefaultBench exposes transparent sponsored rankings. Listings are ordered by cumulative verified USDC payment descending, then by the time the current cumulative total was reached ascending. Rank is paid placement, not an endorsement or quality signal. Monetary values are decimal strings containing integer USDC base units (six decimals).
  termsOfService: https://defaultbench.com/terms
  license:
    name: Proprietary service API; public protocol documentation
    url: https://defaultbench.com/terms
servers:
- url: https://defaultbench.com
  description: Configured DefaultBench origin
tags:
- name: Operations
  description: Non-secret service health.
paths:
  /api/v1/discovery/sources:
    get:
      operationId: listDiscoverySources
      tags:
      - Operations
      summary: Inspect organic source synchronization status
      description: Returns non-secret freshness and operational telemetry for each approved organic source. Error categories are coarse and no upstream URL, credential, or internal exception text is exposed.
      responses:
        '200':
          description: Current source status and active/stale inventory counts.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscoverySourceStatusResponse'
        '429':
          description: The applicable bounded rate limit is exhausted.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimitLimit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimitRemaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimitReset'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: rate_limit_exceeded
                  message: Rate limit exceeded. Retry after the indicated delay.
                  details: {}
                  retry_after_seconds: 30
        '500':
          description: An unexpected server error occurred; no uncertain payment is credited.
          headers:
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: internal_error
                  message: The request could not be completed.
                  details: {}
        '503':
          description: A dependency is unavailable, one identical request owns the settlement claim, settlement is uncertain, or a confirmed settlement is awaiting atomic ranking credit. These responses never authorize a replacement payment. Retry the identical paid request after Retry-After unless the code says otherwise.
          headers:
            Retry-After:
              $ref: '#/components/headers/RetryAfter'
            PAYMENT-RESPONSE:
              $ref: '#/components/headers/PaymentResponse'
            X-Request-Id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                dependencyUnavailable:
                  value:
                    error:
                      code: service_unavailable
                      message: A required dependency is temporarily unavailable.
                      details:
                        retryable: true
                settlementInProgress:
                  value:
                    error:
                      code: payment_settlement_in_progress
                      message: An identical settlement attempt is already in progress. Retry this request shortly.
                      details:
                        idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
                        settlement_state: settling
                        transaction_id: null
                        retryable: true
                settlementUncertain:
                  value:
                    error:
                      code: payment_settlement_uncertain
                      message: The settlement outcome is being reconciled and will not be submitted again automatically. Retry this identical request for the durable result.
                      details:
                        idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
                        settlement_state: settlement_uncertain
                        transaction_id: null
                        retryable: true
                settledPendingCredit:
                  value:
                    error:
                      code: payment_settled_pending_credit
                      message: Settlement succeeded, but ranking credit is pending durable recovery. Retry the identical request.
                      details:
                        idempotency_key: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
                        transaction_id: '0x0000000000000000000000000000000000000000000000000000000000000001'
                        retryable: true
                bidConfigurationUnavailable:
                  value:
                    error:
                      code: bid_configuration_unavailable
                      message: Bidding is temporarily unavailable while payment policy configuration is synchronized.
                      details:
                        retryable: true
  /api/v1/health:
    get:
      operationId: getHealth
      tags:
      - Operations
      summary: Check service and database availability
      description: Performs an inexpensive database check and exposes no credentials or blockchain RPC details.
      responses:
        '200':
          description: Service is ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
        '503':
          description: Service or database is not ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
components:
  schemas:
    ErrorResponse:
      type: object
      additionalProperties: false
      required:
      - error
      properties:
        error:
          type: object
          additionalProperties: false
          required:
          - code
          - message
          - details
          properties:
            code:
              type: string
              pattern: ^[a-z][a-z0-9_]*$
              description: Stable machine-readable code.
            message:
              type: string
              description: Human-readable, non-stable explanation.
            details:
              $ref: '#/components/schemas/ErrorDetail'
            retry_after_seconds:
              type: integer
              minimum: 1
    HealthResponse:
      type: object
      additionalProperties: false
      required:
      - status
      - version
      - database
      - checked_at
      properties:
        status:
          type: string
          enum:
          - ok
          - degraded
        version:
          type: string
        database:
          type: object
          additionalProperties: false
          required:
          - healthy
          - latency_ms
          - database_time
          - migration_count
          properties:
            healthy:
              type: boolean
            latency_ms:
              type: number
              minimum: 0
            database_time:
              oneOf:
              - type: string
                format: date-time
              - type: 'null'
            migration_count:
              oneOf:
              - type: integer
                minimum: 0
              - type: 'null'
        checked_at:
          type: string
          format: date-time
      examples:
      - status: ok
        version: 1.0.0
        database:
          healthy: true
          latency_ms: 2
          database_time: '2000-01-01T00:00:00Z'
          migration_count: 1
        checked_at: '2000-01-01T00:00:00Z'
    DiscoverySourceStatusResponse:
      type: object
      additionalProperties: false
      required:
      - sources
      - checked_at
      properties:
        sources:
          type: array
          minItems: 2
          maxItems: 2
          items:
            $ref: '#/components/schemas/DiscoverySourceStatus'
        checked_at:
          type: string
          format: date-time
    ErrorDetail:
      type: object
      description: Code-specific bounded details; clients must branch on error.code, not message text.
      additionalProperties: true
    DiscoverySourceStatus:
      type: object
      additionalProperties: false
      required:
      - source
      - source_name
      - active_resource_count
      - stale_resource_count
      - last_attempted_sync
      - last_complete_successful_sync
      - last_failed_sync
      - last_error_category
      - last_duration_ms
      - last_record_count
      - last_page_count
      - last_malformed_count
      - current_sync_state
      properties:
        source:
          type: string
          enum:
          - mcp_registry
          - x402_bazaar
        source_name:
          type: string
        active_resource_count:
          type: integer
          minimum: 0
        stale_resource_count:
          type: integer
          minimum: 0
        last_attempted_sync:
          oneOf:
          - type: string
            format: date-time
          - type: 'null'
        last_complete_successful_sync:
          oneOf:
          - type: string
            format: date-time
          - type: 'null'
        last_failed_sync:
          oneOf:
          - type: string
            format: date-time
          - type: 'null'
        last_error_category:
          oneOf:
          - type: string
            pattern: ^[a-z][a-z0-9_]{0,63}$
          - type: 'null'
        last_duration_ms:
          oneOf:
          - type: integer
            minimum: 0
          - type: 'null'
        last_record_count:
          oneOf:
          - type: integer
            minimum: 0
          - type: 'null'
        last_page_count:
          oneOf:
          - type: integer
            minimum: 0
          - type: 'null'
        last_malformed_count:
          oneOf:
          - type: integer
            minimum: 0
          - type: 'null'
        current_sync_state:
          type: string
          enum:
          - idle
          - running
          - succeeded
          - failed
          - stalled
  headers:
    RetryAfter:
      description: Seconds until the caller should retry.
      schema:
        type: integer
        minimum: 1
    RateLimitLimit:
      description: Maximum requests in the current policy window.
      schema:
        type: integer
        minimum: 1
    RateLimitRemaining:
      description: Requests remaining in the current policy window.
      schema:
        type: integer
        minimum: 0
    PaymentResponse:
      description: Base64-encoded JSON x402 v2 settlement response/receipt. It may also be present on a non-200 facilitator failure or uncertain response; header presence alone is never evidence of success or ranking credit.
      schema:
        type: string
        contentEncoding: base64
    RequestId:
      description: Opaque request correlation identifier; safe to include in an incident report.
      schema:
        type: string
    RateLimitReset:
      description: Unix epoch timestamp in seconds when the current policy window resets.
      schema:
        type: integer
        minimum: 0
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: Base64-encoded x402 v2 payment payload. It is intentionally absent on the initial request that obtains HTTP 402 requirements.
    sellerAnalyticsBearer:
      type: http
      scheme: bearer
      bearerFormat: DefaultBench signed token
      description: Five-minute token issued only after consuming a listing-bound, origin-bound EIP-712 wallet challenge.
    operatorBearer:
      type: http
      scheme: bearer
      description: Operator secret for private revenue and purchase-funnel metrics.
externalDocs:
  description: Full autonomous-client instructions
  url: https://defaultbench.com/llms-full.txt
x-defaultbench-payment:
  protocol: x402
  version: 2
  sdkVersion: 2.24.0
  scheme: exact
  network: eip155:8453
  networkLabel: Base mainnet
  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
  symbol: USDC
  decimals: 6
  minimumBidBaseUnits: '10000'
  requestHeader: PAYMENT-SIGNATURE
  challengeHeader: PAYMENT-REQUIRED
  settlementHeader: PAYMENT-RESPONSE
x-defaultbench-ranking:
  primary: cumulative verified payment descending
  tieBreaker: timestamp current cumulative total was reached ascending
  qualitySignal: false
x-defaultbench-examples: Synthetic documentation examples; never production activity.