AI एजंटना तुमचा API विका.
AI एजंट क्रेडिट कार्ड फॉर्म भरू शकत नाहीत. ते तुम्हाला USDC मध्ये पैसे देऊ शकतात. Blockchain0x एक API कॉल करते.
तुमची API मानवांसाठी डिझाइन केलेली होती. तुमचे कॉल करणारे आता एजंट आहेत.
API महसुलाचा पुढील दशक मानव साइनअपमधून येणार नाही. हे AI एजंट्स त्यांच्या वापरकर्त्यांच्या वतीने API कॉल करणार आहेत, बहुतेक वेळा प्रोग्रामेटिक पद्धतीने आणि कोणत्याही मानवाशिवाय. त्या एजंट्स तुमच्या विद्यमान चेकआउटचा वापर करू शकत नाहीत. ते क्रेडिट कार्ड फॉर्म भरू शकत नाहीत, खाते तयार करू शकत नाहीत, पुष्टीकरण ईमेलवर क्लिक करू शकत नाहीत, पासवर्ड लक्षात ठेवू शकत नाहीत.
ते 402 Payment Required response वाचू शकतात, JSON body मधून USDC amount आणि recipient parse करू शकतात, Base वर pay करू शकतात, आणि payment proof सह call पुन्हा पाठवू शकतात. agent-driven API commerce चे हेच संपूर्ण स्वरूप आहे. Cost model सुद्धा (stablecoin मध्ये per-call billing) card-based subscriptions पेक्षा agent usage pattern ला खूपच चांगले बसते: $1 पेक्षा कमी transactions मध्ये cards अपयशी ठरतात; Base वरील USDC gas मध्ये काही सेंट्स खर्च करतो; आणि machines मध्ये chargebacks होत नाहीत.
Blockchain0x हा पूल आहे. किंमतीच्या टेबलात तुम्हाला चार्ज करायच्या मार्गांची यादी करा आणि x402 अडॅप्टर माउंट करा. जेव्हा एक अनपेड कॉल किंमतीच्या मार्गावर येतो, तेव्हा अडॅप्टर 402 परत करतो जो नेमके काय पैसे द्यायचे ते वर्णन करतो. एजंट Base वर पैसे देतो आणि X-Payment हेडरसह पुन्हा प्रयत्न करतो; अडॅप्टर ते पडताळतो आणि तुमचा हँडलर चालतो. तुम्ही USDC गोळा करता आणि तुमचा API पूर्वीप्रमाणे चालवता. तुमच्या व्यवसायाच्या तर्कात काहीही बदलत नाही; बिलिंग स्तर एकत्रितपणे कार्य करते.
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[] requirement चा अर्थ काय
- योजना - पेमेंट योजना. exact-usdc म्हणजे EVM चेनवर अचूक USDC रक्कम. क्लायंट पैसे देण्यापूर्वी यावर जुळतो.
- नेटवर्क / चेनआयडी - सेटल करण्यासाठीची चेन (मुख्य नेटवर्क म्हणजे Base, CAIP-2 eip155:8453). एक स्थलांतर स्वीकारण्यात दोन आवश्यकता सूचीबद्ध करून दोन्ही नेटवर्कचा उल्लेख करू शकते.
- payToAddress / amountWeiUsdc - प्राप्तकर्ता वॉलेट आणि USDC बेस युनिटमध्ये अचूक रक्कम (500000 = 0.50 USDC, 6 दशांश). क्लायंट पैसे देण्यापूर्वी दोन्हीची पुष्टी करतो.
- paymentRequestId - या कोटशी पैसे जोडतो. अडॅप्टर एक X-Payment नाकारतो जो मार्ग उद्धृत केलेल्या पेक्षा भिन्न paymentRequestId चा संदर्भ घेतो.
- maxAgeSeconds - पैसे किती ताजे असावे लागतात. या विंडोपेक्षा जुने पैसे नाकारले जातात आणि कॉलरने पुन्हा पैसे द्यावे लागतात.
x402 मशीन-ते-मशीन आहे: एक x402-जानकार क्लायंट accepts वाचतो, ऑन-चेन निवडलेली आवश्यकता भरणा करतो, मग अडॅप्टर पडताळणारा X-Payment हेडरसह विनंती पुन्हा जारी करतो. एक क्लायंट जो x402 बोलत नाही तो फक्त 402 प्राप्त करतो आणि कोणताही परिणाम मिळवत नाही, जो योग्य परिणाम आहे (कॉल भरणा केलेला नाही). या प्रवाहात कोणतीही होस्ट केलेली चेकआउट पृष्ठ नाही; भरणा कॉलरच्या वॉलेटद्वारे प्रोग्रामेटिकली निपजवला जातो.
एक किंमत टेबल. तीन भाषांमध्ये. एकाच आकारात.
तुम्ही एक adapter mount करता आणि त्याला METHOD plus path नुसार keyed pricing table देता. तो फक्त तुम्ही सूचीबद्ध केलेल्या routes वरच gate लावतो; तुमचा handler कधीही unpaid call पाहत नाही, कारण तो चालतो तेव्हा X-Payment header आधीच verified झालेला असतो. Python, TypeScript, आणि Go मध्ये हा shape एकसारखाच आहे - X-Payment wire format तोच असतो, त्यामुळे Go server Python client ने तयार केलेले headers स्वीकारतो.
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 साठी server adapters देतो. इतर frameworks साठी, 402 body आणि X-Payment header हे साधे HTTP आहेत ज्यांना @blockchain0x/x402 मधील wire helpers build आणि parse करतात - तुमच्या stack च्या idiom मध्ये तपासणी स्वतः लिहा. Client side साठी Ruby आणि JVM x402 packages प्रकाशित केले आहेत.
प्रत्येक टूलसाठी केव्हा पोहचायचे.
Stripe मानव चेकआउटसाठी योग्य साधन आहे. Blockchain0x एजंट चेकआउटसाठी योग्य साधन आहे. ते वेगवेगळ्या समस्यांचे समाधान करतात आणि अनेकदा समान API वर सामोरे सामोरे बसतात.
| आयाम | Blockchain0x | Stripe Checkout |
|---|---|---|
| खरेदीदार | कोणताही HTTP क्लायंट (मानव किंवा AI एजंट) | ब्राउझरवर मानव |
| पेमेंटपूर्वी प्रमाणीकरण आवश्यक आहे | नाही - पहिला कॉल पेमेंट आवश्यकतांसह 402 परत करतो | होय - ईमेल + कार्ड फॉर्म |
| निव्वळ गती | 5 सेकंद (USDC on Base) | 2-7 दिवस (कार्ड नेटवर्क) |
| चार्जबॅक जोखमी | काहीही नाही (USDC अंतिम आहे) | 120 दिवसांच्या चार्जबॅक विंडोपर्यंत |
| प्रति-व्यवहार खर्च अर्थशास्त्र | $0.01-$0.10 प्रति कॉलवर कार्य करते (Base गॅस + आमची फी) | कार्ड शुल्क $1 च्या खालील व्यवहारांना आर्थिकदृष्ट्या अशक्य बनवतात. |
| परत | हाताने - तुमचा कोड USDC परत भरणार्या पत्त्यावर पाठवतो | Stripe डॅशबोर्डद्वारे स्वयंचलित. |
| आंतरराष्ट्रीय समर्थन | समान वॉलेट, कोणतीही देश, अतिरिक्त कॉन्फिग नाही | प्रत्येक देशासाठी परवाना, चलन रूपांतरण, प्रादेशिक नियम |
| सर्वात चांगले | प्रोग्रामेटिक एजंट-चालित API वापर | मानव-चालित चेकआउट (SaaS साइनअप, ई-कॉमर्स) |
ज्याच्यावर बहुतेक API प्रदाते उतरतात तो पॅटर्न: मानवी साइनअप प्रवाहासाठी Stripe ठेवा (तुमचा डॅशबोर्ड, तुमचा सदस्यता उत्पादन पृष्ठ); प्रोग्रामेटिक एजंट प्रवेशासाठी API कडेला Blockchain0x जोडा. x402 अडॅप्टर फक्त तुम्ही त्याच्या किंमत टेबलात ठेवलेल्या मार्गांना गेट करतो, त्यामुळे तुमचे मानवी, Stripe-प्रमाणित मार्ग अनछुई राहतात. एजंट्सना किंमत असलेल्या मार्गांकडे आणि इतर सर्वांकडे मानवांकडे निर्देशित करा, आणि दोन्ही प्रेक्षकांना एकाच API कोडने सेवा दिली जाते.
प्रो प्रारंभिक ट्रॅफिकसाठी. ऑडिट लॉग्स आवश्यक झाल्यावर व्यवसाय.
API प्रदाता नेहमीच पहिल्या दिवशी प्रो वर सुरू करतात: फ्री वाचनासाठीच आहे, आणि x402 अडॅप्टरला पेमेंट्सची पडताळणी आणि निपटारा करण्यासाठी API प्रवेश आवश्यक आहे तसेच त्यांना ट्रॅक करण्यासाठी वेबहुक्स आवश्यक आहेत. उच्च-वाहनक्षमता असलेल्या API व्यवसाय क्षेत्रात जातात जेव्हा मासिक प्रमाण वाढते. प्रत्येक एजंटच्या खर्चासाठी आणि स्तर कुठे आहेत हे पाहण्यासाठी किंमतीच्या पानावर पहा.
- Free: केवळ dashboard आणि metadata exploration साठी उपयुक्त. Read-only असल्यामुळे adapter payments settle करू शकत नाही.
- Pro: live API monetization साठी default. Full API access, webhooks, exports.
- Business: जेव्हा compliance साठी audit logs हवे असतात, किंवा जास्त API rate limits आवश्यक असतात.