Machine Payments

Let agents pay per request—no account, no API key.

View as MarkdownOpen in Claude

The Web Search and Finance Research APIs accept machine payments. A client can call either one and settle payment for that call inside the same HTTP exchange, with no signup, no API key, and no prepaid credit balance.

The index, the latency, and the response shape are identical to key-authenticated requests. Only the way you pay changes.

Machine payments are built for programmatic consumption. If a human is provisioning access once and using it repeatedly, an API key with credits costs less to operate and gives you usage analytics, team roles, and Zero Data Retention. ZDR is not available on keyless requests.


Supported Protocols

ProtocolMaintainerSettles inWeb Search per call
x402x402 Foundation, founded by Coinbase and CloudflareUSDC on Base or Solana$0.005
MPPTempo and Stripe, specified at paymentauth.orgUSDC on Tempo$0.01

Both protocols use HTTP 402 Payment Required, both complete in two round trips, and both are advertised on the same endpoint. A single unpaid request returns terms for both, so your client picks whichever it can satisfy.


Choosing a Protocol

Today the practical question is where your agent already holds funds, because both protocols settle in USDC.

Use x402 if your wallet is on Base or Solana. It costs half as much on Web Search, the same on Finance Research, and it is the shortest path to a first paid request: one wallet, one stablecoin, one signature.

Use MPP if your wallet is on Tempo, or if you want the client integration that will pick up additional payment methods as we enable them. MPP is payment-method neutral by design, so a card or fiat rail can be added later without changing your code.

Cards and fiat are not currently enabled on either protocol. MPP supports them at the protocol level, but the only method we advertise today is tempo. If you need to pay by card, use an API key with credits.

If you already have a working x402 client, there is no reason to migrate. Both remain supported.


Pricing

Endpointx402MPPPer 1,000 calls (x402)
Web Search$0.005$0.01$5.00
Finance Research, deep$0.11$0.11$110.00
Finance Research, exhaustive$0.50$0.50$500.00

Both protocols match the standard credit prices, so machine payments are not a surcharge.

The two protocols differ on Web Search only, and the reason is the rail. MPP settles through Stripe, where one cent is the smallest chargeable amount, so it rounds the underlying price up to the next whole cent. A half-cent Web Search call becomes one cent. Finance Research already lands on a whole cent at both tiers, so there is nothing to round and the prices match.

Adding livecrawl raises the Web Search quote by $0.001 per result on both protocols, and the same rounding applies, which is why a $0.015 x402 call is $0.02 on MPP. Always read the amount out of the terms you were handed rather than assuming the base price.

If per-call cost is the thing you are optimizing, use x402 for Web Search. For Finance Research, pick on where your funds are.

Machine payments settle to the payment rail directly. They do not consume credits, they do not trigger Auto Top-Up, and they do not appear in your credit balance.


Supported Endpoints

Machine payments cover the Web Search and Finance Research APIs. The method matters: each endpoint offers terms on one verb only, and the other returns 401.

EndpointMachine paymentsNotes
GET /v1/searchYesWeb Search. Query-string parameters
POST /v1/finance_researchYesFinance Research. JSON body, deep or exhaustive
POST /v1/searchNoReturns 401. Use the GET form
GET /v1/finance_researchNoReturns 401. Use the POST form
POST /v1/contentsNoAPI key required
POST /v1/researchNoAPI key required

What You Need

  • A funded wallet. USDC on Base or Solana for x402, or USDC on Tempo for MPP.
  • A client that speaks the protocol. Both protocols ship official SDKs that wrap fetch and handle the 402 retry for you, so you never implement the handshake by hand.
  • No You.com account. That is the point. Nothing to provision, nothing to rotate.

Free Access Without Payment

If you are evaluating rather than running production traffic, the keyless MCP endpoint is free and needs no wallet:

https://api.you.com/mcp?profile=free

It exposes you-search at 100 queries per day with no credentials. See the MCP Server for Web Search guide.


Next Steps


Questions & Support

For machine payments questions, reach us in Discord or contact [email protected].