agentwallet

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

AgentWallet

AgentWallet

AgentWallet provides server wallets for AI agents. Wallets are provisioned after email OTP verification. All signing happens server-side and is policy-controlled.

AgentWallet为AI Agent提供服务端钱包。钱包需通过邮箱OTP验证后才能开通。所有签名操作在服务端完成,并受策略控制。

TL;DR - Quick Reference

快速参考(TL;DR)

FIRST: Check if already connected by reading
~/.agentwallet/config.json
. If file exists with
apiToken
, you're connected - DO NOT ask user for email.
Need to connect (no config file)? Ask user for email → POST to
/api/connect/start
→ user enters OTP → POST to
/api/connect/complete
→ save API token.
x402 Payments? Use the ONE-STEP
/x402/fetch
endpoint (recommended) - just send target URL + body, server handles everything.

首先:检查是否已连接,读取
~/.agentwallet/config.json
文件。如果文件存在且包含
apiToken
,说明已连接——请勿再向用户索要邮箱。
需要连接(无配置文件)? 向用户索要邮箱 → 发送POST请求至
/api/connect/start
→ 用户输入OTP → 发送POST请求至
/api/connect/complete
→ 保存API令牌。
x402支付? 使用推荐的一键式
/x402/fetch
端点——只需发送目标URL和请求体,服务端会处理所有操作。

x402/fetch - ONE-STEP PAYMENT PROXY (RECOMMENDED)

x402/fetch - 一键式支付代理(推荐)

This is the simplest way to call x402 APIs. Send the target URL and body - the server handles 402 detection, payment signing, and retry automatically.
bash
curl -s -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/x402/fetch" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://enrichx402.com/api/exa/search","method":"POST","body":{"query":"AI agents","numResults":3}}'
That's it! The response contains the final API result:
json
{
  "success": true,
  "response": {
    "status": 200,
    "body": {"results": [...]},
    "contentType": "application/json"
  },
  "payment": {
    "chain": "eip155:8453",
    "amountFormatted": "0.01 USDC",
    "recipient": "0x..."
  },
  "paid": true,
  "attempts": 2,
  "duration": 1234
}
这是调用x402 API最简单的方式。 发送目标URL和请求体即可,服务端会自动处理402检测、支付签名和重试逻辑。
bash
curl -s -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/x402/fetch" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://enrichx402.com/api/exa/search","method":"POST","body":{"query":"AI agents","numResults":3}}'
操作完成! 响应结果包含最终的API返回数据:
json
{
  "success": true,
  "response": {
    "status": 200,
    "body": {"results": [...]},
    "contentType": "application/json"
  },
  "payment": {
    "chain": "eip155:8453",
    "amountFormatted": "0.01 USDC",
    "recipient": "0x..."
  },
  "paid": true,
  "attempts": 2,
  "duration": 1234
}

x402/fetch Request Options

x402/fetch 请求选项

FieldTypeRequiredDescription
url
stringYesTarget API URL (must be HTTPS in production)
method
stringNoHTTP method: GET, POST, PUT, DELETE, PATCH (default: GET)
body
objectNoRequest body (auto-serialized to JSON)
headers
objectNoAdditional headers to send
preferredChain
stringNo
"auto"
(default),
"evm"
, or
"solana"
. Auto selects chain with sufficient USDC balance
dryRun
booleanNoPreview payment cost without paying
timeout
numberNoRequest timeout in ms (default: 30000, max: 120000)
idempotencyKey
stringNoFor deduplication
字段类型是否必填描述
url
string目标API URL(生产环境必须为HTTPS)
method
stringHTTP方法:GET、POST、PUT、DELETE、PATCH(默认:GET)
body
object请求体(自动序列化为JSON格式)
headers
object需额外发送的请求头
preferredChain
string
"auto"
(默认)、
"evm"
"solana"
。自动选择USDC余额充足的链
dryRun
boolean预览支付成本但不实际支付
timeout
number请求超时时间(毫秒,默认:30000,最大值:120000)
idempotencyKey
string用于请求去重

Dry Run (Preview Cost)

试运行(预览成本)

Add
"dryRun": true
to the request body. Returns payment details without executing:
json
{
  "success": true,
  "dryRun": true,
  "payment": {
    "required": true,
    "chain": "eip155:8453",
    "amountFormatted": "0.01 USDC",
    "policyAllowed": true
  }
}
在请求体中添加
"dryRun": true
,返回支付详情但不执行实际支付:
json
{
  "success": true,
  "dryRun": true,
  "payment": {
    "required": true,
    "chain": "eip155:8453",
    "amountFormatted": "0.01 USDC",
    "policyAllowed": true
  }
}

Error Codes

错误码

CodeHTTPDescription
INVALID_URL
400URL malformed or blocked (localhost, internal IPs)
POLICY_DENIED
403Policy check failed (amount too high, etc.)
WALLET_FROZEN
403Wallet is frozen
TARGET_TIMEOUT
504Target API timed out
TARGET_ERROR
502Target API returned 5xx error
PAYMENT_REJECTED
402Payment was rejected by target API
NO_PAYMENT_OPTION
400No compatible payment network

代码HTTP状态码描述
INVALID_URL
400URL格式错误或被拦截(如本地主机、内部IP)
POLICY_DENIED
403策略校验失败(如金额过高)
WALLET_FROZEN
403钱包已冻结
TARGET_TIMEOUT
504目标API请求超时
TARGET_ERROR
502目标API返回5xx错误
PAYMENT_REJECTED
402支付被目标API拒绝
NO_PAYMENT_OPTION
400无兼容的支付网络

Config File Reference

配置文件参考

Store credentials at
~/.agentwallet/config.json
:
json
{
  "username": "your-username",
  "email": "your@email.com",
  "evmAddress": "0x...",
  "solanaAddress": "...",
  "apiToken": "mf_...",
  "moltbookLinked": false,
  "moltbookUsername": null,
  "xHandle": null
}
FieldDescription
username
Your unique AgentWallet username
email
Email used for OTP verification
evmAddress
EVM wallet address
solanaAddress
Solana wallet address
apiToken
Fund API token for authenticated requests (starts with
mf_
)
moltbookLinked
Whether a Moltbook account is linked
moltbookUsername
Linked Moltbook username (if any)
xHandle
X/Twitter handle from Moltbook (if linked)
Security: Never commit to git. Set
chmod 600
. Treat
apiToken
like a password.

凭证存储在
~/.agentwallet/config.json
路径下:
json
{
  "username": "your-username",
  "email": "your@email.com",
  "evmAddress": "0x...",
  "solanaAddress": "...",
  "apiToken": "mf_...",
  "moltbookLinked": false,
  "moltbookUsername": null,
  "xHandle": null
}
字段描述
username
你的AgentWallet唯一用户名
email
用于OTP验证的邮箱
evmAddress
EVM钱包地址
solanaAddress
Solana钱包地址
apiToken
用于鉴权请求的Fund API令牌(以
mf_
开头)
moltbookLinked
是否关联了Moltbook账户
moltbookUsername
关联的Moltbook用户名(如有)
xHandle
来自Moltbook的X/Twitter账号(如有关联)
安全提示: 请勿将该文件提交至git仓库。设置权限为
chmod 600
。请像对待密码一样保管
apiToken

Connect Flow

连接流程

Web flow: Ask user for email → direct to
https://agentwallet.mcpay.tech/connect?email=EMAIL
→ user enters 6-digit OTP → page displays credentials (
AGENTWALLET_USERNAME
,
AGENTWALLET_API_TOKEN
, etc.). User should save the API token securely.
API flow (for CLI/agents):
Step 1 - Send OTP:
bash
curl -X POST https://agentwallet.mcpay.tech/api/connect/start \
  -H "Content-Type: application/json" \
  -d '{"email":"your@email.com"}'
Returns
username
in response. For referrals, add
"ref":"REFERRER_USERNAME"
to body.
Step 2 - Ask user for OTP, then complete:
bash
curl -X POST https://agentwallet.mcpay.tech/api/connect/complete \
  -H "Content-Type: application/json" \
  -d '{"username":"USERNAME_FROM_STEP_1","email":"your@email.com","otp":"USER_OTP"}'
Returns
apiToken
,
evmAddress
,
solanaAddress
. Save the
apiToken
for all wallet operations.

网页流程: 向用户索要邮箱 → 跳转至
https://agentwallet.mcpay.tech/connect?email=EMAIL
→ 用户输入6位OTP → 页面显示凭证(
AGENTWALLET_USERNAME
AGENTWALLET_API_TOKEN
等)。用户需安全保存API令牌。
API流程(适用于CLI/Agent):
步骤1 - 发送OTP:
bash
curl -X POST https://agentwallet.mcpay.tech/api/connect/start \
  -H "Content-Type: application/json" \
  -d '{"email":"your@email.com"}'
响应结果中返回
username
。若为推荐注册,可在请求体中添加
"ref":"REFERRER_USERNAME"
步骤2 - 向用户索要OTP,完成连接:
bash
curl -X POST https://agentwallet.mcpay.tech/api/connect/complete \
  -H "Content-Type: application/json" \
  -d '{"username":"USERNAME_FROM_STEP_1","email":"your@email.com","otp":"USER_OTP"}'
返回
apiToken
evmAddress
solanaAddress
。保存
apiToken
用于后续所有钱包操作。

Referral & Airdrop Program

推荐与空投计划

Share your referral link:
https://agentwallet.mcpay.tech/connect?ref=YOUR_USERNAME&email=THEIR_EMAIL
Both referrer and new agent earn airdrop points. Points: referral (200), first tx (50), daily active (10), weekly streak (100).
Tiers: Bronze (0-4, 1x), Silver (5-24, 1.5x), Gold (25-99, 2x), Diamond (100+, 3x).
Check rewards:
bash
curl https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/referrals \
  -H "Authorization: Bearer FUND_API_TOKEN"

分享你的推荐链接:
https://agentwallet.mcpay.tech/connect?ref=YOUR_USERNAME&email=THEIR_EMAIL
推荐者和新用户均可获得空投积分。积分规则:推荐成功(200分)、首次交易(50分)、每日活跃(10分)、连续周活跃(100分)。
等级划分:青铜(0-4分,1倍倍率)、白银(5-24分,1.5倍倍率)、黄金(25-99分,2倍倍率)、钻石(100分以上,3倍倍率)。
查询奖励:
bash
curl https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/referrals \
  -H "Authorization: Bearer FUND_API_TOKEN"

Network Pulse

网络状态

Public network stats:
GET https://agentwallet.mcpay.tech/api/network/pulse
— returns active agents, transaction counts, volume, trending APIs.
Personal stats (authenticated):
GET https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/stats
— returns rank, transaction history, volume, referral info, streak.

公开网络统计数据:
GET https://agentwallet.mcpay.tech/api/network/pulse
—— 返回活跃Agent数量、交易次数、交易量及热门API信息。
个人统计数据(需鉴权):
GET https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/stats
—— 返回排名、交易历史、交易量、推荐信息及连续活跃天数。

Skill Files

Skill文件

FileURL
SKILL.md (this file)
https://agentwallet.mcpay.tech/skill.md
HEARTBEAT.md
https://agentwallet.mcpay.tech/heartbeat.md
package.json (metadata)
https://agentwallet.mcpay.tech/skill.json
文件链接
SKILL.md(本文档)
https://agentwallet.mcpay.tech/skill.md
HEARTBEAT.md
https://agentwallet.mcpay.tech/heartbeat.md
package.json(元数据)
https://agentwallet.mcpay.tech/skill.json

Heartbeat

心跳检测

Run periodically to check for skill updates, wallet status, and recent activity:
bash
curl https://agentwallet.mcpay.tech/heartbeat.md
Base URL:
https://agentwallet.mcpay.tech/api/v1

定期运行以检查Skill更新、钱包状态及近期活动:
bash
curl https://agentwallet.mcpay.tech/heartbeat.md
基础URL:
https://agentwallet.mcpay.tech/api/v1

Authentication

鉴权方式

Use your Fund API token (starts with
mf_
) as:
Authorization: Bearer FUND_API_TOKEN
Check connection (public, no auth):
GET https://agentwallet.mcpay.tech/api/wallets/USERNAME
— returns
connected: true/false
with wallet addresses if connected.

使用你的Fund API令牌(以
mf_
开头),格式为:
Authorization: Bearer FUND_API_TOKEN
检查连接状态(公开接口,无需鉴权):
GET https://agentwallet.mcpay.tech/api/wallets/USERNAME
—— 返回
connected: true/false
,若已连接则同时返回钱包地址。

Funding Wallets

钱包充值

Direct users to
https://agentwallet.mcpay.tech/u/YOUR_USERNAME
to fund via Coinbase Onramp (card, bank, or Coinbase account). Supports Base (USDC) and Solana (SOL).
Check balance after funding:
bash
curl https://agentwallet.mcpay.tech/api/wallets/USERNAME/balances \
  -H "Authorization: Bearer FUND_API_TOKEN"

引导用户访问
https://agentwallet.mcpay.tech/u/YOUR_USERNAME
,通过Coinbase Onramp进行充值(支持银行卡、银行账户或Coinbase账户)。支持Base链(USDC)和Solana链(SOL)。
充值后查询余额:
bash
curl https://agentwallet.mcpay.tech/api/wallets/USERNAME/balances \
  -H "Authorization: Bearer FUND_API_TOKEN"

Wallet Operations

钱包操作

Balances:
GET /api/wallets/USERNAME/balances
(auth required)
Activity:
GET /api/wallets/USERNAME/activity?limit=50
(auth optional — authenticated sees all events, public sees limited). Event types:
otp.*
,
policy.*
,
wallet.action.*
,
x402.authorization.signed
.

余额查询:
GET /api/wallets/USERNAME/balances
(需鉴权)
活动记录:
GET /api/wallets/USERNAME/activity?limit=50
(可选鉴权——鉴权后可查看所有事件,未鉴权仅查看有限信息)。事件类型包括:
otp.*
policy.*
wallet.action.*
x402.authorization.signed

Actions (Policy Controlled)

策略控制操作

EVM Transfer

EVM转账

bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/transfer" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"0x...","amount":"1000000","asset":"usdc","chainId":8453}'
Fields:
to
(address),
amount
(smallest units — ETH: 18 decimals, USDC: 6 decimals),
asset
(
"eth"
or
"usdc"
),
chainId
,
idempotencyKey
(optional).
Supported USDC chains: Ethereum (1), Sepolia (11155111), Optimism (10), Polygon (137), Arbitrum (42161), Base (8453), Base Sepolia (84532).
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/transfer" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"0x...","amount":"1000000","asset":"usdc","chainId":8453}'
字段说明:
to
(接收地址)、
amount
(最小单位——ETH:18位小数,USDC:6位小数)、
asset
"eth"
"usdc"
)、
chainId
idempotencyKey
(可选)。
支持USDC的EVM链:以太坊(1)、Sepolia(11155111)、Optimism(10)、Polygon(137)、Arbitrum(42161)、Base(8453)、Base Sepolia(84532)。

Solana Transfer

Solana转账

bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/transfer-solana" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"RECIPIENT","amount":"1000000000","asset":"sol","network":"devnet"}'
Fields:
to
(address),
amount
(smallest units — SOL: 9 decimals, USDC: 6 decimals),
asset
(
"sol"
or
"usdc"
),
network
(
"mainnet"
or
"devnet"
),
idempotencyKey
(optional).
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/transfer-solana" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"RECIPIENT","amount":"1000000000","asset":"sol","network":"devnet"}'
字段说明:
to
(接收地址)、
amount
(最小单位——SOL:9位小数,USDC:6位小数)、
asset
"sol"
"usdc"
)、
network
"mainnet"
"devnet"
)、
idempotencyKey
(可选)。

EVM Contract Call

EVM合约调用

bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/contract-call" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"0x...","data":"0x...","value":"0","chainId":8453}'
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/contract-call" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"to":"0x...","data":"0x...","value":"0","chainId":8453}'

Sign Message

消息签名

bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/sign-message" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"chain":"solana","message":"hello"}'
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/sign-message" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{"chain":"solana","message":"hello"}'

Solana Devnet Faucet

Solana测试网水龙头

Request free devnet SOL for testing. Sends 0.1 SOL to your Solana wallet on devnet. Rate limited to 3 requests per 24 hours.
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/faucet-sol" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{}'
Response:
{"actionId":"...","status":"confirmed","amount":"0.1 SOL","txHash":"...","explorer":"...","remaining":2}
Response format for all actions:
{"actionId":"...","status":"confirmed","txHash":"...","explorer":"..."}

申请免费的测试网SOL用于测试。向你的Solana测试网钱包发送0.1 SOL。每24小时最多请求3次。
bash
curl -X POST "https://agentwallet.mcpay.tech/api/wallets/USERNAME/actions/faucet-sol" \
  -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" \
  -d '{}'
响应示例:
{"actionId":"...","status":"confirmed","amount":"0.1 SOL","txHash":"...","explorer":"...","remaining":2}
所有操作的响应格式:
{"actionId":"...","status":"confirmed","txHash":"...","explorer":"..."}

x402 Manual Flow (Advanced)

x402手动流程(进阶)

Use this only if you need fine-grained control. For most cases, use x402/fetch above.
仅当需要精细控制时使用此流程。大多数场景下推荐使用上述x402/fetch。

Protocol Versions

协议版本

VersionPayment HeaderNetwork Format
v1
X-PAYMENT
Short names (
solana
,
base
)
v2
PAYMENT-SIGNATURE
CAIP-2 (
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
)
版本支付请求头网络格式
v1
X-PAYMENT
短名称(
solana
base
v2
PAYMENT-SIGNATURE
CAIP-2格式(
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp

Flow

流程

  1. Call target API → get 402 response. Payment info is in the
    payment-required
    HEADER (body may be empty
    {}
    ).
  2. Sign:
    POST /api/wallets/USERNAME/actions/x402/pay
    with
    {"requirement": "<header value or JSON>", "preferredChain": "evm"}
    . The
    requirement
    field accepts both base64 strings and JSON objects.
  3. Retry original request with the header from
    usage.header
    response field and
    paymentSignature
    value.
Signing endpoint:
/api/wallets/{USERNAME}/actions/x402/pay
(x402/pay with SLASH, not dash)
  1. 调用目标API → 收到402响应。支付信息位于
    payment-required
    请求头中(响应体可能为空
    {}
    )。
  2. 签名:发送POST请求至
    /api/wallets/USERNAME/actions/x402/pay
    ,请求体为
    {"requirement": "<请求头值或JSON>", "preferredChain": "evm"}
    requirement
    字段支持base64字符串或JSON对象。
  3. 使用响应中
    usage.header
    字段指定的请求头和
    paymentSignature
    值,重试原请求。
签名端点:
/api/wallets/{USERNAME}/actions/x402/pay
(注意使用斜杠而非短横线)

Sign Request Options

签名请求选项

FieldTypeDescription
requirement
string or objectPayment requirement (base64 or JSON)
preferredChain
"evm"
or
"solana"
Preferred blockchain
preferredChainId
numberSpecific EVM chain ID
idempotencyKey
stringFor deduplication
dryRun
booleanSign without storing (for testing)
字段类型描述
requirement
string或object支付要求(base64格式或JSON)
preferredChain
"evm"
"solana"
首选区块链
preferredChainId
number特定EVM链ID
idempotencyKey
string用于请求去重
dryRun
boolean仅签名不存储(用于测试)

Key Rules

关键规则

  • Signatures are ONE-TIME USE — consumed even on failed requests
  • Use single-line curl — multiline
    \
    causes escaping errors
  • USDC amounts use 6 decimals (10000 = $0.01)
  • Always use
    requirement
    field (not deprecated
    paymentRequiredHeader
    )
  • 签名为一次性使用——即使请求失败也会被消耗
  • 使用单行curl命令——多行
    \
    会导致转义错误
  • USDC金额使用6位小数(10000 = 0.01美元)
  • 始终使用
    requirement
    字段(而非已废弃的
    paymentRequiredHeader

Supported Networks

支持的网络

NetworkCAIP-2 IdentifierToken
Base Mainnet
eip155:8453
USDC
Base Sepolia
eip155:84532
USDC
Solana Mainnet
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
USDC
Solana Devnet
solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
USDC
网络CAIP-2标识符代币
Base主网
eip155:8453
USDC
Base测试网
eip155:84532
USDC
Solana主网
solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
USDC
Solana测试网
solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1
USDC

Common Errors

常见错误

ErrorSolution
404/405 on signingUse
/api/wallets/{USERNAME}/actions/x402/pay
(slash not dash)
blank argument
Use single-line curl, not multiline with
\
AlreadyProcessed
Get a NEW signature for each request
insufficient_funds
Fund wallet at
https://agentwallet.mcpay.tech/u/USERNAME

错误解决方案
签名时返回404/405使用
/api/wallets/{USERNAME}/actions/x402/pay
(斜杠而非短横线)
blank argument
使用单行curl命令,而非带
\
的多行命令
AlreadyProcessed
为每个请求获取新的签名
insufficient_funds
访问
https://agentwallet.mcpay.tech/u/USERNAME
为钱包充值

Policies

策略管理

Get current policy:
bash
curl https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/policy \
  -H "Authorization: Bearer FUND_API_TOKEN"
Update policy:
bash
curl -X PATCH https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/policy \
  -H "Authorization: Bearer FUND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"max_per_tx_usd":"25","allow_chains":["base","solana"],"allow_contracts":["0x..."]}'
查询当前策略:
bash
curl https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/policy \
  -H "Authorization: Bearer FUND_API_TOKEN"
更新策略:
bash
curl -X PATCH https://agentwallet.mcpay.tech/api/wallets/YOUR_USERNAME/policy \
  -H "Authorization: Bearer FUND_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"max_per_tx_usd":"25","allow_chains":["base","solana"],"allow_contracts":["0x..."]}'

Response Format

响应格式

Success:
json
{"success": true, "data": {...}}
Error:
json
{"success": false, "error": "Description", "hint": "How to fix"}
成功响应:
json
{"success": true, "data": {...}}
错误响应:
json
{"success": false, "error": "错误描述", "hint": "修复建议"}