x402 协议集成

AI 代理
即时代理访问

x402 使用 HTTP 的 402 Payment Required 状态码实现即时、无需许可的代理访问。AI 代理使用 USDC 支付，在单个请求中接收凭证——无需注册。

适合代理

自动化工作流

即时访问

无需注册

USDC 支付

Base 和 Solana

无需许可

无需 KYC

快速开始 x402 协议文档

在线 x402 端点

发现端点（无需认证）

主信息新

/v1/x402/info

一次调用获取所有信息 - 价格、网络、限制

可用国家及设备数量

检查 x402 集成是否启用

所有层级和网络的当前定价

计算时长和流量的费用

交互式 API 文档

购买和会话管理

代理购买402

/v1/x402/proxy

付费购买代理凭证

会话管理

/v1/x402/manage/session

Header: X-Session-Token: x402s_...

端口状态

/v1/x402/manage/ports/:id/status

Header: X-Session-Token: x402s_...

动态定价和可用性

所有 x402 响应包含实时数据：

• 可用国家 - 每5分钟根据设备库存更新
• 按层级区分 - 私有层级可能可用国家较少
• 响应中包含定价 - 共享和私有层级费率
• 库存水平 - 每个国家的实时设备数量

工作原理

支付流程

代理请求

GET /v1/x402/proxy?country=US&duration=3600&traffic=1

服务器响应 (402 需要付款)

状态: 402

头部:

X-PAYMENT-REQUIRED: eyJhbW91... (支付要求)

代理签署支付

代理使用钱包签署 USDC 支付授权

代理重试并附带支付

GET /v1/x402/proxy?country=US&duration=3600&traffic=1

头部:

X-PAYMENT-SIGNATURE: eyJzaWdu... (已签名支付)

服务器验证并返回凭证

状态: 200 OK
{ proxy: { http, socks5, ... }, rotationUrl, sessionId }

402 需要付款响应

调用 /v1/x402/proxy 未付款时，您会收到包含付款要求的 402 响应。

动态国家列表

每5分钟从实际库存更新

按层级区分

私有层级可能可用国家较少

AI兼容

遵循 x402scan 验证模式，适用于AI代理

查看完整 402 响应结构

{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact",
    "network": "base",
    "maxAmountRequired": "4100000",
    "resource": "https://api.proxies.sx/v1/x402/proxy",
    "description": "真实 4G/5G 移动代理 - 5个国家可用...",
    "payTo": "0xC6C3a87363D5b37d9510202015369086e25558f1",
    "extra": {
      "availableCountries": ["DE", "PL", "US", "FR", "GB"],
      "pricing": {
        "shared": {"portPerMonth": 18, "trafficPerGB": 3.5},
        "private": {"portPerMonth": 40, "trafficPerGB": 3.7}
      },
      "limits": {
        "minDurationSeconds": 3600,
        "maxDurationSeconds": 2592000,
        "minTrafficGB": 0.1
      }
    }
  }]
}

快速开始

Python 与 x402 SDK

from x402 import X402Client

# 使用您的钱包初始化 x402 客户端
client = X402Client(
    private_key="0xYourPrivateKey...",
    network="base"
)

# 请求代理 - 自动处理 402 流程
response = client.get(
    "https://api.proxies.sx/v1/x402/proxy",
    params={
        "country": "US",
        "duration": 3600,  # 1 小时
        "traffic": 1,      # 1 GB
        "tier": "shared"
    }
)

# 使用代理
proxy = response.json()
print(f"HTTP 代理: {proxy['proxy']['http']}")
print(f"SOCKS5 代理: {proxy['proxy']['socks5']}")
print(f"过期时间: {proxy['proxy']['expiresAt']}")

# 需要时轮换 IP
import requests
requests.get(proxy['rotationUrl'])

JavaScript/TypeScript

import { createX402Client } from '@x402/evm';
import { privateKeyToAccount } from 'viem/accounts';

// 创建 x402 客户端
const account = privateKeyToAccount('0xYourPrivateKey...');
const x402Client = createX402Client({
  account,
  network: 'base',
});

// 获取代理并自动支付
const response = await x402Client.fetch(
  'https://api.proxies.sx/v1/x402/proxy?country=US&duration=3600&traffic=1'
);

const data = await response.json();
console.log('代理:', data.proxy.http);
console.log('轮换 URL:', data.rotationUrl);

定价模型

共享层

端口端点$18/月

流量$3.50/GB

共享移动代理端口

私有层

端口端点$40/月

流量$3.70/GB

专用设备访问

最低购买

最短时长

1 小时 (3600秒)

最低流量

0.1 GB (100 MB)

共享最低

~$0.375

私有最低

~$0.425

钱包地址

B
Base 网络 (EVM)

0xC6C3a87363D5b37d9510202015369086e25558f1

USDC 合约: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

S
Solana 网络

6qJVQ61ygwjuB7DK94ccrAcxgiQkc2tbbWeNCr3FT2HY

Solana 上的 USDC: 原生 SPL 代币

安全考虑

重放防护

每个 txHash 只能使用一次

支付过期

要求在 5 分钟后过期

钱包验证

每个会话记录支付钱包

速率限制

支付端点每分钟 10 个请求

金额验证

服务器验证支付与请求匹配

可用国家（实时动态）

国家列表从实际设备库存动态获取 - 随着设备添加/移除或达到容量而变化。

查询端点

GET /v1/x402/countries                    # 所有可用国家
GET /v1/x402/countries?tier=shared        # 仅共享层级
GET /v1/x402/countries?tier=private       # 仅私有层级

响应示例

[
  {"code": "US", "name": "United States", "availableDevices": 88, "tier": "both"},
  {"code": "DE", "name": "Germany", "availableDevices": 27, "tier": "both"},
  {"code": "GB", "name": "United Kingdom", "availableDevices": 22, "tier": "shared"},
  {"code": "PL", "name": "Poland", "availableDevices": 22, "tier": "both"},
  {"code": "FR", "name": "France", "availableDevices": 18, "tier": "both"}
]

层级可用性

私有层级可用的国家可能比共享层级少。例如，GB 可能仅适用于共享层级。请始终检查响应中的 tier 字段以确认可用性。

准备集成 x402？

让您的 AI 代理能够使用 USDC 支付即时购买和使用移动代理。

x402 协议文档 API 文档

支持: support@proxies.sx | Swagger: api.proxies.sx/api

AI 代理即时代理访问