Apiosk — 基于 USDC 微支付的无密钥 API 访问

面向智能体的按请求付费 API 接入：无需 API 密钥，无需账户，即付即用。

Apiosk 使智能体能够通过 x402 协议（基于 Base 区块链的 USDC 微支付）直接调用生产环境 API。告别 API 密钥管理，开启按请求付费新范式。

🎯 本技能功能概览

• 发现 API — 浏览 9+ 个已上线的生产级 API（天气、行情、新闻、地理编码等）
• 按请求付费 — 自动执行 USDC 微支付（每次调用 $0.001–$0.10）
• 零配置接入 — 无需 API 密钥、无需注册账户、无需订阅计划
• 即时访问 — 发起 x402 支付后立即调用 API

📦 安装方式

# 通过 ClawHub 安装
clawhub install apiosk

# 或手动克隆仓库
git clone https://github.com/apiosk/apiosk-skill

⚙️ 配置说明

1. 钱包初始化（仅需一次）

# 生成新钱包（或导入已有钱包）
./setup-wallet.sh

# 此操作将在 ~/.apiosk/wallet.json 中创建以下内容：
# - 私钥（本地明文存储，权限设为 chmod 600 以保障安全）
# - 公钥地址
# - Base 主网 RPC 地址

**重要提示：** 私钥以明文形式保存在 `~/.apiosk/wallet.json` 中（文件权限已严格限制）。请仅向该钱包注入少量资金用于测试。生产环境建议使用硬件钱包或外部密钥管理系统。

重要提示：请为您的钱包充值 Base 主网上的 USDC（建议最低充值 $1–$10）。

充值方式：

1. 通过 https://bridge.base.org 将 USDC 桥接到 Base 网络
2. 或在 Coinbase 购买 USDC → 提现至 Base 网络
3. 将 USDC 发送至您的 Apiosk 钱包地址

2. 查看可用 API 列表

# 列出全部 API
./list-apis.sh

# 输出示例：
# weather       $0.001/req   获取当前天气与预报
# prices        $0.002/req   加密货币/股票/外汇行情  
# news          $0.005/req   按主题/国家分类的全球新闻
# company       $0.01/req    公司信息、财务数据、相关新闻
# geocode       $0.001/req   地址 → 坐标转换
# ...

🚀 使用方法

基础 API 调用

# 调用 weather API
./call-api.sh weather --params '{"city": "Amsterdam"}'

# 输出示例：
# {
#   "temperature": 12,
#   "condition": "Cloudy",
#   "forecast": [...]
# }
# 
# ✅ 已支付：$0.001 USDC

在智能体代码中调用（Node.js）

const { callApiosk } = require('./apiosk-client');

// 调用 weather API
const weather = await callApiosk('weather', {
  city: 'Amsterdam'
});

console.log(`Temperature: ${weather.temperature}°C`);
// ✅ 自动支付 $0.001 USDC

在智能体代码中调用（Python）

from apiosk_client import call_apiosk

# 调用 prices API
prices = call_apiosk('prices', {
    'symbols': ['BTC', 'ETH']
})

print(f"BTC: ${prices['BTC']}")
# ✅ 自动支付 $0.002 USDC

📚 可用 API 列表

完整文档： https://apiosk.com/#docs

🔧 辅助脚本

list-apis.sh

#!/bin/bash
# 列出所有可用 API 及其定价信息

curl -s https://gateway.apiosk.com/v1/apis | jq -r '.apis[] | "(.id)t$(.price_usd)/reqt(.description)"'

call-api.sh

#!/bin/bash
# 调用任意 Apiosk API，并自动完成支付
# 使用方式：./call-api.sh  --params '{"key":"value"}'

API_ID=$1
PARAMS=$3

# 加载钱包信息
WALLET_ADDRESS=$(jq -r '.address' ~/.apiosk/wallet.json)

# 发起请求（x402 支付通过链上验证完成）
# 网关执行链上支付验证，客户端无需签名
curl -X POST "https://gateway.apiosk.com/$API_ID" 
  -H "Content-Type: application/json" 
  -H "X-Wallet-Address: $WALLET_ADDRESS" 
  -d "$PARAMS"

check-balance.sh

#!/bin/bash
# 查询您 Apiosk 钱包中的 USDC 余额

WALLET_ADDRESS=$(jq -r '.address' ~/.apiosk/wallet.json)

curl -s "https://gateway.apiosk.com/v1/balance?address=$WALLET_ADDRESS" | jq
# 输出示例： {"balance_usdc": 9.87, "spent_today": 0.13}

usage-stats.sh

#!/bin/bash
# 查看您的 API 使用统计

WALLET_ADDRESS=$(jq -r '.address' ~/.apiosk/wallet.json)

curl -s "https://gateway.apiosk.com/v1/usage?address=$WALLET_ADDRESS" | jq
# 输出示例：
# {
#   "total_requests": 142,
#   "total_spent_usdc": 1.89,
#   "by_api": {
#     "weather": {"requests": 87, "spent": 0.087},
#     "prices": {"requests": 55, "spent": 0.11}
#   }
# }

🎓 示例代码

示例 1：天气播报机器人

const { callApiosk } = require('./apiosk-client');

async function getWeatherReport(city) {
  const weather = await callApiosk('weather', { city });
  
  return `🌤️ ${city} 天气简报：
温度：${weather.temperature}°C
天气状况：${weather.condition}
预报摘要：${weather.forecast.map(f => f.summary).join(', ')}
  
💰 成本：$0.001 USDC`;
}

// 使用示例
console.log(await getWeatherReport('Amsterdam'));

示例 2：加密货币行情追踪器

from apiosk_client import call_apiosk
import time

def track_prices(symbols, interval=60):
    """使用 Apiosk 追踪加密货币行情"""
    while True:
        prices = call_apiosk('prices', {'symbols': symbols})
        
        for symbol, price in prices.items():
            print(f"{symbol}: ${price:,.2f}")
        
        print(f"✅ 已支付：$0.002 USDCn")
        time.sleep(interval)

# 每分钟追踪 BTC 和 ETH 行情
track_prices(['BTC', 'ETH'])

示例 3：新闻摘要智能体

const { callApiosk } = require('./apiosk-client');

async function getDailyDigest(topics) {
  const articles = [];
  
  for (const topic of topics) {
    const news = await callApiosk('news', { 
      topic, 
      limit: 3 
    });
    articles.push(...news.articles);
  }
  
  return `📰 每日新闻摘要（共 ${articles.length} 篇）
${articles.map(a => `- ${a.title} (${a.source})`).join('n')}

💰 总成本：$${(topics.length * 0.005).toFixed(3)} USDC`;
}

// 获取科技与商业类新闻
console.log(await getDailyDigest(['technology', 'business']));

🔐 x402 协议工作原理

传统 API 接入流程：

1. 注册账户
2. 获取 API 密钥
3. 安全存储密钥
4. 在请求中携带密钥
5. 监控速率限制
6. 按月缴纳订阅费用

Apiosk（x402 协议）：

1. 发起请求
2. 网关返回 402 Payment Required
3. 您的钱包签署支付凭证
4. 网关执行链上验证
5. 网关将请求转发至目标 API
6. 返回响应结果

耗时：毫秒级；计费：按实际用量精确结算；准备时间：零配置。

🛠️ 高级配置

自定义 RPC 节点

# 编辑 ~/.apiosk/config.json
{
  "rpc_url": "https://mainnet.base.org",
  "chain_id": 8453,
  "usdc_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

设置消费限额

# 设置日消费上限
./set-limit.sh --daily 10.00

# 设置单次请求最高费用
./set-limit.sh --per-request 0.10

启用通知提醒

# 当余额低于阈值时触发通知
./configure.sh --alert-balance 1.00 --alert-webhook "https://hooks.slack.com/..."

📊 监控与分析

查看消费明细

# 今日消费
./usage-stats.sh --today

# 本月消费
./usage-stats.sh --month

# 各 API 分项统计
./usage-stats.sh --by-api

导出使用数据

# 导出 CSV 格式账单数据（供财务对账）
./export-usage.sh --start 2026-01-01 --end 2026-01-31 --format csv > january_usage.csv

🆘 故障排查

“USDC 余额不足”

# 查询当前余额
./check-balance.sh

# 若余额过低，请为钱包充值：
# 1. 通过 https://bridge.base.org 将 USDC 桥接到 Base 网络
# 2. 发送至：[您的钱包地址]

“支付验证失败”

# 验证钱包签名功能是否正常
./test-signature.sh

# 若验证失败，请重新生成钱包：
./setup-wallet.sh --regenerate

“API 未找到”

# 刷新 API 列表缓存
./list-apis.sh --refresh

# 检查指定 API 是否已上线
curl https://gateway.apiosk.com/v1/apis | jq '.apis[] | select(.id=="weather")'

🌐 开发者指南：接入您自己的 API

希望借助 Apiosk 实现您自有 API 的商业化？

# 1. 注册开发者账号
curl -X POST https://dashboard.apiosk.com/api/register 
  -d '{"email":"you@example.com","api_name":"My API"}'

# 2. 添加您的 API 接口
curl -X POST https://dashboard.apiosk.com/api/add 
  -H "Authorization: Bearer $TOKEN" 
  -d '{
    "name": "my-api",
    "endpoint": "https://my-api.com",
    "price_usd": 0.01,
    "description": "My awesome API"
  }'

# 3. 开始盈利！
# 智能体通过 Apiosk 网关调用您的 API
# 您将自动获得 90–95% 的收入分成

更多详情： https://docs.apiosk.com/developers

📖 相关资源

• 官网： https://apiosk.com
• 控制台： https://dashboard.apiosk.com
• 文档中心： https://docs.apiosk.com
• GitHub 仓库： https://github.com/apiosk
• 技术支持： support@apiosk.com
• Moltbook： @ApioskAgent

💡 为什么选择 Apiosk？

面向智能体用户：

• ✅ 无需管理 API 密钥
• ✅ 按实际用量付费
• ✅ 即刻接入 9+ 个 API
• ✅ 定价完全透明
• ✅ 所有支付凭证均上链可验证

面向开发者：

• ✅ 快速将任意 API 变现
• ✅ 无需自行处理支付逻辑
• ✅ 收益分成高达 90–95%
• ✅ 结算即时到账
• ✅ 覆盖全球用户

网络效应： API 数量越多 → 吸引更多智能体 → 收入增长 → 激励更多 API 上线

🦞 关于我们

由 Apiosk 团队为智能体经济构建。

x402 协议： 基于加密货币微支付的无密钥 API 接入协议。
使命： 让每一个 API 都能被每一个智能体即时访问。

“停止管理 API 密钥，开始按请求付费。”

📝 许可协议

MIT 协议 — 您可在智能体项目中自由使用！

🔗 快速入门命令

# 安装
clawhub install apiosk

# 初始化配置
cd ~/.openclaw/skills/apiosk && ./setup-wallet.sh

# 调用示例
./call-api.sh weather --params '{"city": "Amsterdam"}'

# 监控使用情况
./usage-stats.sh

祝您开发愉快！🚀