APITOLL (Tasnid Chain)

API收费

AI代理经济的支付层。

通过USDC小额支付将API货币化。控制代理人支出。立即在Base&Solana定居。

网站 • API文件 • 仪表盘 • • 快速开始

______________________________________________________________________

什么是API收费？

API Toll允许人工智能代理在上使用USDC稳定币支付API呼叫 基础 和 索拉纳 --由 x402协议 （需要HTTP 402付款）。

API销售商：添加3行中间件，通过按请求微支付将任何端点货币化。

对于代理商建设者：给你的代理人一个有预算控制的钱包，他们就会自动处理付款。

Agent calls API  ─────►  402 Payment Required  ─────►  Agent pays USDC
                                                             │
         ◄─────  200 OK + data  ◄─────  Facilitator verifies on-chain

快速开始

卖方：将您的API货币化

npm install @apitoll/seller-sdk

import express from "express";
import { paymentMiddleware } from "@apitoll/seller-sdk";

const app = express();

app.use(
  paymentMiddleware({
    walletAddress: "0xYourUSDCWallet",
    endpoints: {
      "GET /api/data": {
        price: "0.005",        // $0.005 USDC per request
        chains: ["base"],
        description: "Premium data feed",
      },
    },
  })
);

app.get("/api/data", (req, res) => {
  res.json({ data: "premium content" });
});

未付款的请求 HTTP 402 有付款要求。代理自动付款并重试。

买方：部署具有预算控制的代理

npm install @apitoll/buyer-sdk

import { createAgentWallet, createFacilitatorSigner } from "@apitoll/buyer-sdk";

const agent = createAgentWallet({
  name: "ResearchBot",
  chain: "base",
  policies: [
    { type: "budget", dailyCap: 50, maxPerRequest: 0.10 },
    { type: "vendor_acl", allowedVendors: ["*"] },
    { type: "rate_limit", maxPerMinute: 60 },
  ],
  signer: createFacilitatorSigner(
    "https://pay.apitoll.com",
    process.env.FACILITATOR_API_KEY!,
    process.env.AGENT_WALLET!
  ),
});

// Auto-handles 402 → policy check → sign → retry
const data = await agent.fetch("https://api.apitoll.com/api/search?q=AI+agents");

MCP服务器：货币化工具

npm install @apitoll/mcp-server

import { z } from "zod";
import { createPaidMCPServer } from "@apitoll/mcp-server";

const server = createPaidMCPServer({
  walletAddress: "0xYourWallet",
});

// Paid tool — $0.01 per call
server.paidTool(
  "analyze_data",
  "AI-powered data analysis",
  z.object({ data: z.string() }),
  { price: 0.01, chains: ["base"] },
  async ({ data }) => {
    return { analysis: "..." };
  }
);

包裹

运作原理

1. Agent requests resource          →  GET /api/data
2. Server returns 402              ←  HTTP 402 + payment requirements (PAYMENT-REQUIRED header)
3. Agent's policy engine checks    →  Budget OK? Vendor allowed? Rate limit?
4. Agent signs USDC payment        →  via facilitator, local wallet, or direct transfer
5. Agent retries with payment      →  GET /api/data + X-PAYMENT header
6. Facilitator verifies on-chain   →  Confirms USDC transfer on Base or Solana
7. Server returns data             ←  200 OK + data
8. Transaction indexed             →  Dashboard updates in real-time

签名者模式

买方SDK支持代理签署付款的5种方式：

策略引擎

买方SDK执行政策 之前 任何付款均已签署：

// Budget — daily/weekly caps, per-request maximums
{ type: "budget", dailyCap: 50, weeklyCap: 200, maxPerRequest: 0.10 }

// Vendor ACL — whitelist/blacklist sellers
{ type: "vendor_acl", allowedVendors: ["api.weather.pro", "neynar.com"] }

// Rate Limits — per-endpoint request throttling
{ type: "rate_limit", maxPerMinute: 60, maxPerHour: 1000 }

实时部署

仪表盘

分析仪表板位于 apitoll.com/dashboard 提供：

• 概述 --总支出、每日支出图表、成功率、平均延迟
• 交易 --可搜索、可过滤的交易历史记录
• 代理 --管理代理钱包、政策、支出
• 卖方 --注册API，跟踪每个端点的收入
• 发现 --浏览市场上的付费工具
• 操场 -使用实时支付流测试API调用
• 计费 --通过Stripe提供免费/专业/企业级别
• 收入 --平台费用分析（管理员）
• Webhooks，API密钥，政策，争议，存款 --全套管理套件

项目结构

APITOLL/
├── packages/
│   ├── shared/           Core types, USDC utilities, chain configs, security helpers
│   ├── seller-sdk/       Express & Hono payment middleware for API monetization
│   ├── buyer-sdk/        Agent wallet with auto-402 handling, policy engine, 5 signers
│   ├── facilitator/      x402 payment relay with custodial wallet (Base + Solana)
│   ├── mcp-server/       MCP server with paid tools support
│   └── langchain/        LangChain and CrewAI adapters for paid tool execution
├── apps/
│   ├── dashboard/        Next.js analytics dashboard (Convex + Clerk + Stripe)
│   ├── seller-api/       Production seller API with 75 paid endpoints
│   ├── agent-client/     Example agent that auto-pays for APIs
│   ├── indexer/          PostgreSQL transaction indexer (Hono)
│   └── discovery/        Tool discovery & marketplace API (Hono)
├── convex/               Serverless backend — 29 tables, real-time queries
├── examples/             Working examples for sellers, agents, MCP, LangChain
├── docs/                 Quick start, architecture, deployment, self-custody guides
├── scripts/              Wallet setup, seed data, testing utilities
└── infra/                PostgreSQL schema for optional indexer

发展

git clone https://github.com/TasnidChain/APITOLL.git
cd APITOLL
npm install
npm run build
npm test

环境变量

复制 .env.example 并填写你的价值观。关键变量：

看 .env.example 查看完整列表。

文档

• 快速入门指南 --5分钟后开始
• 建筑 --系统设计和支付流程
• 自我监护指南 --用你自己的密钥运行代理
• 部署指导 --部署到Railway、Fly.io或Render
• 安全 --安全策略和报告

建立在

• x402协议 --互联网原生支付的开放HTTP标准
• 基础 --Coinbase L2，用于快速、廉价的USDC支付（约0.001美元/tx）
• 索拉纳 --SPL代币支付的高吞吐量链
• Coinbase CDP --引导者和钱包基础设施
• 凸 --实时无服务器后端
• 职员 --身份验证和用户管理
• 条纹 --菲亚特计费和USDC入口

许可证

麻省理工学院