AI एजेंटों को अपना API बेचें।
AI एजेंट क्रेडिट कार्ड फॉर्म भर नहीं सकते। वे आपको USDC में भुगतान कर सकते हैं। Blockchain0x वह एक API कॉल करता है।
आपकी API मनुष्यों के लिए डिज़ाइन की गई थी। आपके कॉलर अब एजेंट हैं।
API राजस्व का अगला दशक मानव साइनअप से नहीं आएगा। यह AI एजेंटों से आएगा जो अपने उपयोगकर्ताओं की ओर से APIs को कॉल करते हैं, अक्सर प्रोग्रामेटिक रूप से और बिना किसी मानव के लूप में। वे एजेंट आपके मौजूदा चेकआउट का उपयोग नहीं कर सकते। वे क्रेडिट कार्ड फॉर्म भर नहीं सकते, खाता नहीं बना सकते, पुष्टि ईमेल पर क्लिक नहीं कर सकते, पासवर्ड याद नहीं कर सकते।
वे जो कर सकते हैं वह है 402 Payment Required प्रतिक्रिया को पढ़ना, JSON बॉडी से USDC राशि और प्राप्तकर्ता को पार्स करना, Base पर भुगतान करना, और भुगतान के प्रमाण के साथ कॉल को फिर से जारी करना। यही एजेंट-चालित API वाणिज्य का पूरा आकार है। लागत मॉडल (स्थिर मुद्रा में प्रति-कॉल बिलिंग) एजेंट उपयोग के आकार के लिए कार्ड-आधारित सब्सक्रिप्शन की तुलना में बेहतर फिट बैठता है: कार्ड $1 से कम लेनदेन में विफल होते हैं; Base पर USDC गैस में सेंट खर्च करता है; मशीनों के बीच चार्जबैक नहीं होते।
Blockchain0x पुल है। मूल्य निर्धारण तालिका में उन मार्गों की सूची बनाएं जिनके लिए आप शुल्क लेना चाहते हैं और x402 एडेप्टर को माउंट करें। जब एक अनपेक्षित कॉल एक मूल्यित मार्ग पर पहुँचता है, तो एडेप्टर एक 402 लौटाता है जो यह बताता है कि क्या भुगतान करना है। एजेंट बेस पर भुगतान करता है और 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[] आवश्यकता का क्या अर्थ है
- scheme - भुगतान योजना। exact-usdc का अर्थ है EVM श्रृंखला पर एक सटीक USDC राशि। ग्राहक भुगतान करने से पहले इस पर मेल खाता है।
- network / chainId - जिस श्रृंखला पर सेटल करना है (मुख्य नेटवर्क 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 प्राप्त करता है और कोई परिणाम नहीं मिलता है, जो सही परिणाम है (कॉल का भुगतान नहीं किया गया था)। इस प्रवाह में कोई होस्टेड चेकआउट पृष्ठ नहीं है; भुगतान कॉल करने वाले के वॉलेट द्वारा प्रोग्रामेटिक रूप से निपटाया जाता है।
एक मूल्य निर्धारण तालिका। तीन भाषाएँ। एक ही आकार।
आप एक एडेप्टर को माउंट करते हैं और इसे 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 पैकेज क्लाइंट साइड के लिए प्रकाशित किए गए हैं।
हर टूल के लिए कब पहुंचें।
Stripe मानव चेकआउट के लिए सही उपकरण है। Blockchain0x एजेंट चेकआउट के लिए सही उपकरण है। वे विभिन्न समस्याओं को हल करते हैं और अक्सर एक ही API पर साथ-साथ होते हैं।
| आयाम | Blockchain0x | Stripe चेकआउट |
|---|---|---|
| खरीदार | कोई भी HTTP क्लाइंट (मानव या AI एजेंट) | ब्राउज़र पर मानव |
| भुगतान से पहले प्रमाणीकरण आवश्यक है | नहीं - पहली कॉल भुगतान आवश्यकताओं के साथ 402 लौटाती है | हाँ - ईमेल + कार्ड फॉर्म |
| सेटलमेंट गति | 5 सेकंड (USDC पर Base) | 2-7 दिन (कार्ड नेटवर्क) |
| चार्जबैक जोखिम | कोई नहीं (USDC अंतिम है) | चार्जबैक विंडो के लिए 120 दिन तक |
| प्रति-लेनदेन लागत अर्थशास्त्र | प्रति कॉल $0.01-$0.10 पर काम करता है (बेस गैस + हमारा शुल्क) | कार्ड शुल्क $1 से कम लेनदेन को आर्थिक रूप से अस्थिर बनाते हैं। |
| धनवापसी | मैनुअल - आपका कोड USDC को भुगतानकर्ता पते पर वापस भेजता है | Stripe डैशबोर्ड के माध्यम से स्वचालित |
| अंतरराष्ट्रीय समर्थन | एक ही वॉलेट, कोई भी देश, कोई अतिरिक्त कॉन्फ़िगरेशन नहीं | प्रति-देश लाइसेंसिंग, मुद्रा रूपांतरण, क्षेत्रीय नियम |
| के लिए सबसे अच्छा | प्रोग्रामेटिक एजेंट-चालित API उपभोग | मानव-प्रेरित चेकआउट (SaaS साइनअप, ई-कॉमर्स) |
विधि जिस पर अधिकांश API प्रदाता पहुँचते हैं: मानव साइनअप प्रवाह के लिए स्ट्राइप को बनाए रखें (आपका डैशबोर्ड, आपका सदस्यता उत्पाद पृष्ठ); प्रोग्रामेटिक एजेंट पहुंच के लिए API किनारे पर Blockchain0x जोड़ें। x402 एडेप्टर केवल उन मार्गों को गेट करता है जिन्हें आप इसकी मूल्य निर्धारण तालिका में डालते हैं, इसलिए आपके मानव, स्ट्राइप-प्रमाणित मार्ग अप्रभावित रहते हैं। एजेंटों को मूल्य निर्धारण मार्गों पर इंगित करें और मानवों को बाकी पर, और दोनों दर्शकों को एक ही 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 चाहिए, या higher API rate limits चाहिए।