DefaultBench Market Intelligence API
Pay-per-report aggregate market snapshots with a product ledger that is financially separate from sponsored bids.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/defaultbench-com:defaultbench-com-market-intelligence-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
openapi: 3.2.0
info:
title: DefaultBench Market Intelligence 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: Market Intelligence
description: Pay-per-report aggregate market snapshots with a product ledger that is financially separate from sponsored bids.
paths:
/api/v1/market-intelligence/pricing:
get:
operationId: getMarketIntelligencePricing
tags:
- Market Intelligence
summary: Read exact machine pricing for one report
responses:
'200':
description: Configured pay-per-report x402 price and schema location.
content:
application/json:
schema:
type: object
'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: {}
/api/v1/market-intelligence/schema:
get:
operationId: getMarketIntelligenceSchema
tags:
- Market Intelligence
summary: Read the Market Intelligence v1 JSON Schema
responses:
'200':
description: JSON Schema defining typed available and insufficient_data fields.
content:
application/json:
schema:
type: object
/api/v1/market-intelligence/metrics:
get:
operationId: getMarketIntelligenceOperatorMetrics
tags:
- Market Intelligence
summary: Read operator-only product revenue and purchase funnel metrics
security:
- operatorBearer: []
responses:
'200':
description: Aggregate product revenue, buyer, repeat-purchase and funnel counters.
content:
application/json:
schema:
type: object
'404':
description: The requested resource does not exist.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: not_found
message: The requested resource was not found.
details: {}
'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: {}
/api/v1/market-intelligence/keywords/{keyword}:
get:
operationId: previewKeywordMarketIntelligence
tags:
- Market Intelligence
summary: Preview a keyword market for free
parameters:
- $ref: '#/components/parameters/Keyword'
responses:
'200':
description: Free market existence, public counts/ranking, availability, schema and price.
content:
application/json:
schema:
$ref: '#/components/schemas/MarketIntelligencePreview'
'400':
description: The request is malformed or a query parameter is invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKeyword:
value:
error:
code: invalid_keyword
message: Keyword must normalize to 1–64 valid characters.
details: {}
validationError:
value:
error:
code: validation_error
message: Request validation failed.
details:
fields:
- path: limit
message: 'Too big: expected number to be <=100'
'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/market-intelligence/keywords/{keyword}/report:
post:
operationId: purchaseKeywordMarketIntelligence
tags:
- Market Intelligence
summary: Purchase one immutable keyword-market report
description: The unsigned request returns a non-spending x402 challenge. Validate exact terms, then retry the identical body with PAYMENT-SIGNATURE and an Idempotency-Key equal to payment-identifier. A completed retry replays the stored result without resettlement.
security:
- {}
- x402Payment: []
parameters:
- $ref: '#/components/parameters/Keyword'
- $ref: '#/components/parameters/PaymentSignature'
- $ref: '#/components/parameters/IdempotencyKey'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/MarketIntelligenceRequest'
responses:
'200':
description: Immutable paid report or idempotent replay.
headers:
PAYMENT-RESPONSE:
$ref: '#/components/headers/PaymentResponse'
content:
application/json:
schema:
$ref: '#/components/schemas/MarketIntelligencePurchaseResponse'
'400':
description: The request is malformed or a query parameter is invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKeyword:
value:
error:
code: invalid_keyword
message: Keyword must normalize to 1–64 valid characters.
details: {}
validationError:
value:
error:
code: validation_error
message: Request validation failed.
details:
fields:
- path: limit
message: 'Too big: expected number to be <=100'
'402':
description: No acceptable x402 v2 payment signature was supplied. Decode PAYMENT-REQUIRED, satisfy one offered exact-payment requirement, then retry the identical request with PAYMENT-SIGNATURE and the same Idempotency-Key.
headers:
PAYMENT-REQUIRED:
$ref: '#/components/headers/PaymentRequired'
X-Request-Id:
$ref: '#/components/headers/RequestId'
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: payment_required
message: Supply a valid x402 v2 PAYMENT-SIGNATURE for the declared exact USDC requirement.
details:
idempotency: The payment-identifier extension is required and must be reused on retry.
'409':
description: The operation conflicts with current idempotency or payment-intent state. Follow the code-specific retry instruction; never replace a key merely because a paid response was lost.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
idempotencyConflict:
value:
error:
code: idempotency_conflict
message: This Idempotency-Key was already used for a different request.
details: {}
paymentIntentExpired:
value:
error:
code: payment_intent_expired
message: The stored payment intent expired before settlement. Request a fresh challenge with a new payment identifier.
details:
new_payment_identifier_required: true
paymentIntentNotSettleable:
value:
error:
code: payment_intent_not_settleable
message: The stored payment intent cannot be settled. Request a fresh challenge with a new payment identifier.
details:
new_payment_identifier_required: true
'413':
description: The request body exceeds the 64 KiB limit.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: payload_too_large
message: Request body exceeds 64 KiB.
details: {}
'415':
description: The request Content-Type is unsupported.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: unsupported_media_type
message: Content-Type must be application/json.
details: {}
'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: {}
'502':
description: Pre-settlement verification identity or requirements contradicted the configured payment requirement; no settlement is submitted or credited.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: payment_requirement_mismatch
message: Verified payment requirements did not match this bid.
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
components:
headers:
PaymentRequired:
description: Base64-encoded JSON x402 v2 PaymentRequired object. The 402 body separately uses the stable DefaultBench error envelope.
schema:
type: string
contentEncoding: base64
RateLimitRemaining:
description: Requests remaining in the current policy window.
schema:
type: integer
minimum: 0
RateLimitLimit:
description: Maximum requests in the current policy window.
schema:
type: integer
minimum: 1
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
RetryAfter:
description: Seconds until the caller should retry.
schema:
type: integer
minimum: 1
RateLimitReset:
description: Unix epoch timestamp in seconds when the current policy window resets.
schema:
type: integer
minimum: 0
RequestId:
description: Opaque request correlation identifier; safe to include in an incident report.
schema:
type: string
schemas:
DataFieldAvailable:
type: object
required:
- state
- value
- sample_size
properties:
state:
type: string
const: available
value: {}
sample_size:
$ref: '#/components/schemas/CountString'
MarketIntelligencePreview:
type: object
required:
- product_code
- canonical_keyword
- market_exists
- current_listing_count
- current_public_ranking
- data_availability
- report_schema
- price
properties:
product_code:
type: string
const: market_intelligence_v1
canonical_keyword:
$ref: '#/components/schemas/KeywordSlug'
market_exists:
type: boolean
current_listing_count:
type: object
current_public_ranking:
type: array
items:
type: object
data_availability:
oneOf:
- $ref: '#/components/schemas/DataFieldAvailable'
- $ref: '#/components/schemas/DataFieldInsufficient'
report_schema:
type: string
price:
type: object
MarketIntelligencePurchaseResponse:
type: object
required:
- purchase
- report
- idempotent_replay
properties:
purchase:
type: object
report:
type: object
idempotent_replay:
type: boolean
KeywordSlug:
type: string
minLength: 1
maxLength: 64
pattern: ^[\p{L}\p{N}]+(?:-[\p{L}\p{N}]+)*$
examples:
- research
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
ErrorDetail:
type: object
description: Code-specific bounded details; clients must branch on error.code, not message text.
additionalProperties: true
MarketIntelligenceRequest:
type: object
additionalProperties: false
properties:
periods_days:
type: array
minItems: 1
maxItems: 3
uniqueItems: true
items:
type: integer
enum:
- 7
- 30
- 90
default:
- 7
- 30
- 90
target_ranks:
type: array
minItems: 1
maxItems: 4
uniqueItems: true
items:
type: integer
enum:
- 1
- 3
- 5
- 10
default:
- 1
- 3
- 5
- 10
DataFieldInsufficient:
type: object
required:
- state
- reason
- publication_threshold
properties:
state:
type: string
const: insufficient_data
reason:
type: string
enum:
- publication_threshold_not_met
- no_observations
- not_enough_history
publication_threshold:
type: integer
minimum: 1
CountString:
type: string
pattern: ^(0|[1-9][0-9]*)$
description: Exact non-negative aggregate count encoded as a decimal integer string.
parameters:
IdempotencyKey:
name: Idempotency-Key
in: header
required: false
description: Caller-generated opaque key for one logical bid. It may be omitted on the initial unsigned challenge request, but is REQUIRED on the paid retry and every later retry. Its value MUST equal the id carried by the required x402 payment-identifier extension. Use a new key only for a genuinely new additional bid.
schema:
type: string
minLength: 1
maxLength: 128
example: bid_01JQ4Z6W2YW1FVD5QAPGMF6M4Q
PaymentSignature:
name: PAYMENT-SIGNATURE
in: header
required: false
description: Base64-encoded x402 v2 payment payload. Omit on the first request; include when retrying after 402. The payload must satisfy the advertised payment-identifier extension with the same value as Idempotency-Key.
schema:
type: string
minLength: 1
Keyword:
name: keyword
in: path
required: true
description: A display label or canonical slug. Normalization is NFKC, trim, lowercase, whitespace collapse, spaces to hyphens, and a Unicode letter/number/hyphen allowlist; mixed Latin/Cyrillic/Greek scripts and reserved routes are rejected.
schema:
type: string
minLength: 1
maxLength: 128
example: ai-research
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.