DefaultBench

Know the market. Don’t move the ranking.

One bounded keyword-market snapshot, paid once with exact USDC over x402. Market Intelligence revenue is financially separate from sponsored bids and never creates a listing or changes rank.

Per immutable report1.000000USDC1000000 base unitsBase mainnet

Search stays free.

Discovery creates the marketplace. Anyone can search, inspect public listing counts, read current sponsored ranking, and check whether a fuller report has enough data.

Search the marketplace

Intelligence is paid.

Sellers and market participants pay for aggregate trends, demand, referral signals, competitive movement, and under-served opportunities—without buying placement.

Read machine pricing

What one report contains

Every analytic field declares its evidence state and sample size. If the evidence is too thin, the value is withheld as insufficient_data—never fabricated.

Demand
Search-demand index, supported-period trends, and no-result share.
Supply
Organic resource count, sponsored listing count, verified sponsored spend, and rank distribution.
Competition
Current amounts to reach selected ranks and recent competitive movement.
Outcomes
Estimated sponsored impression share by rank and aggregate referral-rate ranges.
Opportunity
Related under-served canonical keywords that independently clear privacy thresholds.
Evidence
Coverage, freshness, sample sizes, measurement classes, limitations, and typed suppression states.

Inspect before any wallet signs.

The preview and initial 402 challenge spend nothing. Decode and validate the exact network, asset, recipient, amount, expiry, and payment identifier before authorizing one capped transfer.

# 1. Free preview
GET /api/v1/market-intelligence/keywords/research

# 2. Non-spending challenge inspection
POST /api/v1/market-intelligence/keywords/{keyword}/report
Content-Type: application/json

{"periods_days":[7,30,90],"target_ranks":[1,3,5,10]}

# Response: 402 + PAYMENT-REQUIRED
# Decode and validate. Do not sign yet.

The safe purchase sequence

A successful response can be replayed indefinitely from its stored result. Retrying the same paid request does not settle again or refresh the snapshot.

  1. Preview.Confirm market existence and data availability for free.
  2. Challenge.Send the bounded selectors without a payment signature.
  3. Validate.Check exact USDC terms and the payment identifier locally.
  4. Authorize once.Sign only the exact challenge within a wallet-side spend cap.
  5. Retry identically.Use the same body, payment identifier, signature, and Idempotency-Key.
  6. Keep replaying.On uncertainty or lost responses, retry—never create a replacement payment.

Machine contracts

PricingGET /api/v1/market-intelligence/pricingReport schemaGET /api/v1/market-intelligence/schemaIntegration guide/docs