DefaultBench Protocol discovery API
Machine-readable service metadata.
Machine-readable service metadata.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/defaultbench-com:defaultbench-com-protocol-discovery-api"
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.
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: 3.2.0
info:
title: DefaultBench Protocol discovery 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: Protocol discovery
description: Machine-readable service metadata.
paths:
/openapi.json:
get:
operationId: getOpenApi
tags:
- Protocol discovery
summary: Get this OpenAPI 3.1.1 document
responses:
'200':
description: OpenAPI document generated from the trusted APP_ORIGIN configuration.
content:
application/openapi+json:
schema:
type: object
/llms.txt:
get:
operationId: getLlmsText
tags:
- Protocol discovery
summary: Get concise LLM-oriented service discovery
responses:
'200':
description: Parser-friendly Markdown following the llms.txt convention.
content:
text/plain:
schema:
type: string
/llms-full.txt:
get:
operationId: getLlmsFullText
tags:
- Protocol discovery
summary: Get comprehensive autonomous-client instructions
responses:
'200':
description: Complete machine-facing Markdown documentation.
content:
text/plain:
schema:
type: string
/.well-known/api-catalog:
get:
operationId: getApiCatalog
tags:
- Protocol discovery
summary: Discover API descriptions using RFC 9727
responses:
'200':
description: RFC 9264 JSON linkset API catalog.
content:
application/linkset+json:
schema:
$ref: '#/components/schemas/ApiCatalog'
head:
operationId: headApiCatalog
tags:
- Protocol discovery
summary: Inspect API catalog metadata without a body
responses:
'200':
description: Same representation headers as GET, without a body.
/.well-known/agent-card.json:
get:
operationId: getAgentCard
tags:
- Protocol discovery
summary: Get the A2A 1.0 Agent Card
responses:
'200':
description: A2A card advertising the actual HTTP+JSON interface at /a2a.
content:
application/json:
schema:
$ref: '#/components/schemas/AgentCard'
components:
schemas:
AgentCard:
type: object
additionalProperties: true
required:
- protocolVersion
- name
- description
- version
- supportedInterfaces
- capabilities
- defaultInputModes
- defaultOutputModes
- skills
properties:
protocolVersion:
type: string
const: '1.0'
name:
type: string
const: DefaultBench
description:
type: string
version:
type: string
documentationUrl:
type: string
format: uri
supportedInterfaces:
type: array
minItems: 1
items:
type: object
additionalProperties: false
required:
- url
- protocolBinding
- protocolVersion
properties:
url:
type: string
format: uri
protocolBinding:
type: string
const: HTTP+JSON
protocolVersion:
type: string
const: '1.0'
capabilities:
type: object
additionalProperties: true
defaultInputModes:
type: array
items:
type: string
defaultOutputModes:
type: array
items:
type: string
skills:
type: array
minItems: 1
items:
type: object
additionalProperties: true
ApiCatalog:
type: object
additionalProperties: false
required:
- linkset
properties:
linkset:
type: array
minItems: 1
items:
type: object
additionalProperties: true
required:
- anchor
- service-desc
properties:
anchor:
type: string
format: uri
service-desc:
type: array
minItems: 1
items:
type: object
additionalProperties: true
required:
- href
- type
properties:
href:
type: string
format: uri
type:
type: string
const: application/openapi+json
title:
type: string
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.