Overview

DCDN Cloud supports the x402 protocol — an open standard for internet-native payments built on HTTP 402. AI agents can access GPU inference, browser APIs, and other services by paying per-request with USDC stablecoins on Base (Coinbase L2).

How It Works

API Endpoints

Paid Endpoints (402)

Method	Endpoint	Price	Description
POST	/api/v1/x402/inference	sh.0005	GPU inference — text generation, chat, completion
POST	/api/v1/x402/browser	sh.002	Browser API — screenshot, scrape, navigate

Free Endpoints

Method	Endpoint	Description
GET	/api/v1/x402/info	Protocol info, configuration
GET	/api/v1/x402/pricing	Detailed pricing for all endpoints
GET	/api/v1/x402/nodes	List available GPU nodes
GET	/api/v1/x402/models	List available AI models
GET	/api/v1/x402/stats	Payment statistics

Quick Start (Python)

1. Install the x402 SDK

pip install "x402[httpx,evm]"

2. Run Inference

import asyncio
from x402 import x402Client
from x402.mechanisms.evm.exact import ExactEvmScheme
from eth_account import Account

# Your wallet (needs USDC on Base)
wallet = Account.from_key("YOUR_PRIVATE_KEY")
signer = wallet  # eth_account signer

# Setup x402 client
client = x402Client()
client.register("eip155:*", ExactEvmScheme(signer=signer))

async def run_inference():
    import httpx

    url = "https://dcdncloud.com/api/v1/x402/inference"
    payload = {
        "messages": [{"role": "user", "content": "What is DCDN Cloud?"}],
        "max_tokens": 256
    }

    async with httpx.AsyncClient() as http:
        # Step 1: Get 402 response
        resp = await http.post(url, json=payload)

        if resp.status_code == 402:
            # Step 2: Create payment from 402 requirements
            payment = await client.create_payment_payload(resp)

            # Step 3: Retry with payment
            resp = await http.post(url, json=payload, headers={
                "PAYMENT-SIGNATURE": payment
            })

        print(resp.json())

asyncio.run(run_inference())

3. Browser API

# Same pattern — just change the endpoint and payload
url = "https://dcdncloud.com/api/v1/x402/browser"
payload = {"url": "https://example.com", "action": "screenshot"}

Configuration

Response Format

402 Payment Required

HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: <base64-encoded requirements>
Content-Type: application/json

{
  "error": "Payment Required",
  "protocol": "x402",
  "version": "2.0",
  "price_usd": "0.0005",
  "network": "eip155:8453",
  "asset": "USDC",
  "pay_to": "0xb839eB6a2611Fc668D9597B16e6AAdb83dC3Ad72",
  "facilitator": "https://x402.org/facilitator",
  "requirements": [{...}]
}

Success (after payment)

HTTP/1.1 200 OK

{
  "status": "success",
  "payment": {
    "protocol": "x402",
    "amount_usd": "0.0005",
    "network": "eip155:8453",
    "verified": true
  },
  "node": {"id": "...", "name": "gpu-eu-01", "gpu": "NVIDIA RTX 4090"},
  "result": {
    "choices": [{"message": {"content": "..."}}],
    "usage": {"total_tokens": 128}
  }
}

FAQ