Install the client.
Keep the boundary visible.

curl -sS https://api.clervo.dev/v1/search/free \
  -H 'content-type: application/json' \
  -d '{"query":"what is the x402 payment protocol","maxResults":3,"synthesize":false}' \
  -H 'idempotency-key: clervo-first-call-0001'

Over the free cap the route answers 429 free_quota_exceeded rather than executing. Paid requests return a 402 carrying the exact maximum charge before anything runs.

npx @clervo/router search "World Wide Web"
clervo wallet create
clervo limits

clervo proxy
# base URL: http://127.0.0.1:8402/v1
# add --auto-pay only after reviewing clervo limits

Supported OpenAI-compatible endpoints are models, chat completions (ordinary and SSE), and embeddings. Canonical model IDs are exact or fail. Usage comes from durable operation and receipt records; it is never a hand-written financial counter.

clervo wallet create
# Store the recovery phrase offline.

clervo wallet restore "<recovery phrase>"
clervo wallet address
clervo wallet balance
# Send USDC on Base mainnet to the displayed address.

clervo limits
clervo limits set --per-operation 0.05 --daily 1.00

# Automatic payment remains off by default.
clervo proxy --auto-pay

clervo receipt <receipt-id-or-key>
clervo replay <idempotency-key>
clervo reconcile
clervo usage
clervo doctor

wallet create never overwrites an existing wallet. wallet restore refuses to replace a wallet that holds a balance. If settlement is unknown, reconcile performs a retrieval-only check with no new authorization and paid work stays frozen.

• search.webNormalized ranked retrieval evidence without synthesized prose.max 0.006 USDClive
• search.answerEvidence-grounded synthesized answer with citations. Not publicly available.no public pricelive
• aiProvider-neutral chat, embeddings, image, speech, video, music, and virtual try-on with stable identities, normalized results, truthful usage, paid receipts, and no-charge replay.no public pricelive
• sandbox.runBounded Node.js execution in a pinned gVisor image with no network, strict resource ceilings, cleanup, receipt, and no-charge replay.max 0.01 USDClive
• prediction.marketsSearch and paginate fresh normalized markets and conservative canonical events.max 0.002 USDClive
• prediction.marketRead one stable Clervo market identity with normalized probabilities, freshness, evidence, and supply attribution.max 0.002 USDClive
• prediction.compareCompare two conservatively matched markets and return normalized disagreement evidence.max 0.002 USDClive
• prediction.historyRead a bounded hash-linked history of Clervo normalized observations.max 0.003 USDClive
• prediction.signalDerive bounded movement or disagreement signals only when the evidence is sufficient.max 0.003 USDClive
• crypto.wallet.balancesRead exact native balances and bounded holding coverage across requested supported chains.max 0.002 USDClive
• crypto.wallet.tokensRead bounded ERC-20 holdings with exact atomic amounts and explicit missing valuation.max 0.002 USDClive
• crypto.wallet.transactionsRead bounded normalized native and ERC-20 activity with direction, status, freshness, and evidence.max 0.003 USDClive
• crypto.wallet.reportDerive one bounded multichain wallet report with holdings, activity, flows, counterparties, deterministic signals, coverage, freshness, and provenance.max 0.004 USDClive

• 400refusedThe request was rejected before execution. Nothing ran and nothing was charged.
• 402refusedA typed challenge carrying the exact maximum charge. Connect signs only after explicit local auto-pay opt-in and limit checks.
• 409refusedThe idempotency key is already bound to a different request. Change the key or send the original request.
• 429refusedThe free entry quota is exhausted. The request was not executed.
• 502unresolvedThe executor or contract verification failed closed. Reconcile the settlement state before retrying.

Read the full recovery contractRead replay semantics