మీ APIని AI ఏజెంట్లకు విక్రయించండి.
AI ఏజెంట్లు క్రెడిట్ కార్డ్ ఫారమ్ను నింపలేరు. వారు మీకు USDC లో చెల్లించవచ్చు. Blockchain0x ఆ ఒక్క API కాల్ను చేస్తుంది.
మీ APIని మానవుల కోసం రూపొందించారు. మీ కాలర్లు ఇప్పుడు ఏజెంట్లు.
API ఆదాయానికి వచ్చే తదుపరి దశాబ్దం మానవ సైన్-అప్ల నుండి రాదు. ఇది AI ఏజెంట్లు వారి వినియోగదారుల తరఫున APIs ను కాల్ చేయడం నుండి వస్తుంది, సాధారణంగా ప్రోగ్రామాటిక్గా మరియు చక్రంలో ఎలాంటి మానవుడూ లేకుండా. ఆ ఏజెంట్లు మీ ఉన్న చెక్ అవుట్ను ఉపయోగించలేరు. వారు క్రెడిట్ కార్డ్ ఫారమ్ను నింపలేరు, ఖాతాను సృష్టించలేరు, నిర్ధారణ ఇమెయిల్ను క్లిక్ చేయలేరు, పాస్వర్డును గుర్తు చేసుకోలేరు.
వారు చేయగలది 402 Payment Required ప్రతిస్పందనను చదవడం, JSON శరీరంలో USDC మొత్తం మరియు గ్రహీతను పార్స్ చేయడం, Base పై చెల్లించడం మరియు చెల్లింపు యొక్క నిరూపణతో కాల్ను పునఃజారీ చేయడం. ఇది ఏజెంట్-చాలించిన API వాణిజ్యానికి మొత్తం ఆకారంగా ఉంది. ఖర్చు మోడల్ (స్థిర నాణెంలో ప్రతి కాల్ బిల్లింగ్) కూడా ఏజెంట్ వినియోగ ఆకారానికి కార్డ్ ఆధారిత సభ్యత్వాల కంటే బాగా సరిపోతుంది: కార్డులు $1 కంటే తక్కువ లావాదేవీలలో విఫలమవుతాయి; Base పై USDC గ్యాస్లో సెంట్లను ఖర్చు చేస్తుంది; చార్జ్బ్యాక్లు యంత్రాల మధ్య జరగవు.
Blockchain0x అనేది bridge. మీరు charge చేయాలనుకునే routes ను pricing table లో list చేసి x402 adapter ను mount చేయండి. ఒక unpaid call priced route కు వచ్చినప్పుడు, adapter ఖచ్చితంగా ఏమి pay చేయాలో వివరించే 402 ను return చేస్తుంది. Agent Base లో pay చేసి X-Payment header తో retry చేస్తుంది; adapter దాన్ని verify చేస్తుంది మరియు మీ handler run అవుతుంది. మీరు USDC collect చేసి మీ API ను మునుపటిలాగే run చేస్తారు. మీ business logic లో ఏదీ మారదు; billing layer పక్కనే పనిచేస్తుంది.
HTTP స్థితి కోడ్ చివరకు ఉపయోగం ఉంది.
HTTP 402 was reserved in the original spec for "future use" and never standardized. For thirty years it sat unused while the internet built per-account subscription billing on top of 200/401/403. With Coinbase's x402 protocol, 402 finally has a standard implementation: any API that needs payment-before-it-runs can return a structured 402, and any client that understands the spec can pay and retry.
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"resource": "POST /api/expensive-operation",
"accepts": [
{
"scheme": "exact-usdc",
"network": "mainnet",
"chainId": "eip155:8453",
"payToAddress": "0xYourAgentWalletAddress",
"amountWeiUsdc": "500000",
"paymentRequestId": "pr_demo",
"maxAgeSeconds": 60
}
]
}accepts[] అవసరం ఏమిటి
- స్కీమ్ - చెల్లింపు స్కీమ్. exact-usdc అంటే EVM చైన్పై ఖచ్చితమైన USDC మొత్తం. చెల్లించడానికి ముందు క్లయింట్ దీని పై సరిపోతుంది.
- నెట్వర్క్ / చైన్ ID - సర్దుబాటు చేయాల్సిన చైన్ (మైన్నెట్ బేస్, CAIP-2 eip155:8453). ఒక మైగ్రేషన్ రెండు అవసరాలను ఆమోదాలలో జాబితా చేయడం ద్వారా రెండు నెట్వర్క్లను ఉల్లేఖించవచ్చు.
- payToAddress / amountWeiUsdc - గ్రహీత వాలెట్ మరియు USDC ప్రాథమిక యూనిట్లలో ఖచ్చితమైన మొత్తం (500000 = 0.50 USDC, 6 డెసిమల్స్). చెల్లించడానికి ముందు క్లయింట్ రెండింటిని నిర్ధారిస్తుంది.
- paymentRequestId - చెల్లింపును ఈ ఉల్లేఖనానికి కట్టిస్తుంది. అడాప్టర్ ఉల్లేఖించిన మార్గానికి వేరే paymentRequestIdని సూచించే X-Paymentను తిరస్కరించును.
- maxAgeSeconds - చెల్లింపు ఎంత తాజాగా ఉండాలి. ఈ విండో కంటే పాత చెల్లింపు తిరస్కరించబడుతుంది మరియు కాలర్ మళ్లీ చెల్లించాలి.
x402 యంత్రం-యంత్రం: x402-అవగాహన కలిగిన క్లయింట్ acceptsను చదువుతుంది, ఆన్-చైన్లో ఎంపిక చేసిన అవసరాన్ని చెల్లిస్తుంది, తరువాత అడాప్టర్ ధృవీకరించే X-Payment హెడ్డర్తో అభ్యర్థనను మళ్లీ జారీ చేస్తుంది. x402ని మాట్లాడని క్లయింట్ కేవలం 402ని స్వీకరిస్తుంది మరియు ఫలితం పొందదు, ఇది సరైన ఫలితం (కాల్ చెల్లించబడలేదు). ఈ ప్రవాహంలో హోస్టెడ్ చెకౌట్ పేజీ లేదు; చెల్లింపు పిలువువారి వాలెట్ ద్వారా ప్రోగ్రామాటిక్గా పరిష్కరించబడుతుంది.
ఒక ధర పట్టిక. మూడు భాషలు. ఒకే ఆకారం.
మీరు ఒక అడాప్టర్ను మౌంట్ చేస్తారు మరియు METHOD మరియు పథం ద్వారా కీ చేయబడిన ధరల పట్టికను అందిస్తారు. మీరు జాబితా చేసిన మార్గాలను మాత్రమే ఇది గేట్స్ చేస్తుంది; మీ హ్యాండ్లర్ ఎప్పుడూ చెల్లించని కాల్ను చూడదు, ఎందుకంటే ఇది X-Payment హెడ్డర్ ఇప్పటికే ధృవీకరించబడినప్పుడు నడుస్తుంది. ఆకారం Python, TypeScript మరియు Goలో సమానంగా ఉంటుంది - X-Payment వైర్ ఫార్మాట్ ఒకే విధంగా ఉంటుంది, కాబట్టి Go సర్వర్ Python క్లయింట్ ద్వారా నిర్మించిన హెడ్డర్లను ఆమోదిస్తుంది.
from flask import Flask
from blockchain0x import Client
from blockchain0x_x402.server import x402_before_request_factory, PricingEntry
sdk = Client() # reads BLOCKCHAIN0X_API_KEY
app = Flask(__name__)
# Only routes named in the pricing table are gated.
app.before_request(x402_before_request_factory(
sdk=sdk,
pricing={
"POST /api/expensive-operation": PricingEntry(
amount_usdc="0.50",
pay_to_address="0xYourAgentWalletAddress",
payment_request_id="pr_demo",
),
},
))
@app.route("/api/expensive-operation", methods=["POST"])
def expensive_operation():
return run_the_work() # only runs after X-Payment verifiesimport express from "express";
import { createClient } from "@blockchain0x/node";
import { createX402Middleware } from "@blockchain0x/x402/server/express";
const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });
const app = express();
// Only routes named in the pricing table are gated.
app.use(createX402Middleware({
sdk,
pricing: {
"POST /api/expensive-operation": {
amountUsdc: "0.50",
payToAddress: "0xYourAgentWalletAddress",
paymentRequestId: "pr_demo",
},
},
}));
app.post("/api/expensive-operation", async (req, res) => {
res.json(await runTheWork()); // req.x402Payment holds the verified payment
});import (
"net/http"
x402 "tosh-labs/blockchain0x-x402-go"
)
func main() {
pricing := map[string]x402.PricingEntry{
"POST /api/expensive-operation": {
AmountUSDC: "0.50",
PayToAddress: "0xYourAgentWalletAddress",
PaymentRequestID: "pr_demo",
},
}
// serverSdk is your Blockchain0x Go SDK client.
h := x402.Middleware(x402.ServerOptions{Sdk: serverSdk, Pricing: pricing})(
http.HandlerFunc(expensiveOperation))
http.Handle("/api/expensive-operation", h)
http.ListenAndServe(":8080", nil)
}మేము Express మరియు Fastify (Node), ASGI (Starlette మరియు FastAPI) మరియు Flask (Python) కోసం సర్వర్ అడాప్టర్లను పంపిస్తాము, మరియు Go యొక్క net/http. ఇతర ఫ్రేమ్వర్క్ల కోసం, 402 బాడీ మరియు X-Payment హెడ్డర్ సాధారణ HTTP, @blockchain0x/x402 లో వైర్ సహాయాలు నిర్మించబడతాయి మరియు పార్స్ చేయబడతాయి - మీ స్టాక్ యొక్క భాషలో చెక్ను చేతితో రాయండి. క్లయింట్ పక్కకు Ruby మరియు JVM x402 ప్యాకేజీలు ప్రచురించబడ్డాయి.
ప్రతి టూల్ కోసం ఎప్పుడు చేరుకోవాలి.
స్ట్రైప్ మానవ చెక్ఔట్కు సరైన సాధనం. Blockchain0x ఏజెంట్ చెక్ఔట్కు సరైన సాధనం. అవి విభిన్న సమస్యలను పరిష్కరిస్తాయి మరియు తరచుగా ఒకే APIలో పక్కపక్కనే ఉంటాయి.
| మాపు | Blockchain0x | Stripe Checkout |
|---|---|---|
| కొనుగోలుదారు | ఏ HTTP క్లయింట్ (మానవ లేదా AI ఏజెంట్) | బ్రౌజర్లో మానవుడు |
| చెల్లింపుకు ముందు ధృవీకరణ అవసరం | లేదు - మొదటి కాల్ చెల్లింపు అవసరాలతో 402ని తిరిగి ఇస్తుంది | అవును - ఇమెయిల్ + కార్డు ఫారం |
| సమాప్తి వేగం | 5 సెకన్లు (USDC on Base) | 2-7 రోజులు (కార్డ్ నెట్వర్క్లు) |
| చార్జ్బ్యాక్ ప్రమాదం | ఏదీ లేదు (USDC తుది) | 120 రోజుల చార్జ్బ్యాక్ విండో వరకు |
| ప్రతి లావాదేవీ ఖర్చు ఆర్థిక శాస్త్రం | $0.01-$0.10 ప్రతి కాల్కు పనిచేస్తుంది (Base గ్యాస్ + మా ఫీజు) | కార్డు ఫీజులు $1 కంటే తక్కువ లావాదేవీలను ఆర్థికంగా అనుకూలంగా మారుస్తాయి |
| రీఫండ్లు | మాన్యువల్ - మీ కోడ్ USDCని చెల్లింపుదారుని చిరునామాకు తిరిగి పంపుతుంది | స్ట్రైప్ డాష్బోర్డ్ ద్వారా ఆటోమేటెడ్ |
| అంతర్జాతీయ మద్దతు | అదే వాలెట్, ఏ దేశం, అదనపు కాన్ఫిగరేషన్ లేదు | ప్రతి దేశానికి అనుగుణంగా లైసెన్సింగ్, కరెన్సీ మార్పిడి, ప్రాంతీయ నియమాలు |
| ఉత్తమం కోసం | ప్రోగ్రామాటిక్ ఏజెంట్-చాలించిన API వినియోగం | మానవ-నడిచే చెక్ అవుట్ (SaaS సైన్ అప్, ఈ-కామర్స్) |
చాలా API providers అనుసరించే pattern ఇది: human signup flow కోసం Stripe ను ఉంచండి (మీ dashboard, మీ subscription product page); programmatic agent access కోసం API edge వద్ద Blockchain0x ను జోడించండి. x402 adapter మీ pricing table లో పెట్టిన routes ను మాత్రమే gate చేస్తుంది, కాబట్టి మీ human, Stripe-authenticated routes కు ఎలాంటి ప్రభావం ఉండదు. agents ను priced routes కు, humans ను మిగతావాటికి point చేయండి, అప్పుడు రెండు audiences కు కూడా అదే API code ద్వారా service అందుతుంది.
ప్రారంభ ట్రాఫిక్ కోసం ప్రో. ఆడిట్ లాగ్లు అవసరం అయ్యేటప్పుడు వ్యాపారం.
API providers దాదాపు ఎప్పుడూ day one నుంచే Pro లో ప్రారంభిస్తారు: Free read-only, మరియు x402 adapter payments ను verify చేసి settle చేయడానికి API access తో పాటు వాటిని track చేయడానికి webhooks కూడా అవసరం. Monthly volume పెరుగుతున్న కొద్దీ high-traffic APIs Business territory లోకి వెళ్తాయి. ఖచ్చితమైన per-agent cost మరియు tiers ఎక్కడ ఉన్నాయో pricing page చూడండి.
- Free: dashboard మరియు metadata explorationకే ఉపయోగకరం. Read-only కాబట్టి adapter payments settle చేయలేడు.
- Pro: live API monetization కోసం default. Full API access, webhooks, exports.
- Business: compliance కోసం audit logs కావాలి లేదా higher API rate limits కావాలనుకున్నప్పుడు.