name: pay-for-service description: Access paid API endpoints and content using the x402 payment protocol. Use when you or the user want to call a paid API, access gated content, make an x402 payment, use a paid service, or retrieve content that requires payment. Covers "fetch this paid resource", "access x402 content", "pay for this API call". user-invocable: true disable-model-invocation: false allowed-tools: ["Bash(fdx status)", "Bash(fdx call getX402Content)", "Bash(fdx call authorizePayment)", "Bash(fdx call getWalletOverview)"]

Paying for Services (x402)

Use the Finance District wallet to access paid API endpoints and gated content via the x402 HTTP payment protocol. The wallet handles payment authorization and signing automatically — the agent fetches the content in a single call.

How x402 Works

x402 is an HTTP-native payment protocol:

1. A server returns HTTP 402 with payment requirements
2. The wallet signs a payment and retries the request with a payment header
3. The facilitator verifies and settles the payment

   小葱技能站7w4.net每天更新，海量AI技能等你发现。

4. The server returns the content

The Finance District wallet supports x402 payments on multiple chains and assets, not just a single network.

Confirm wallet is authenticated

fdx status

If the wallet is not authenticated, refer to the authenticate skill.

Check Balance

Ensure the wallet has sufficient funds to cover the payment:

fdx call getWalletOverview

Fetching Paid Content

getX402Content — Fetch content from a paid endpoint

The primary command for accessing x402 resources. It discovers payment requirements, authorizes payment, and retrieves the content in one step:

fdx call getX402Content --url <endpoint-url>

Parameters

authorizePayment — Pre-authorize a payment

For cases where you want to inspect payment requirements or authorize without fetching:

fdx call authorizePayment --url <endpoint-url>

Parameters

Same as getX402Content.

Examples

# Fetch content from a paid API (auto-discovers requirements and pays)
fdx call getX402Content \
  --url https://api.example.com/premium/data

# Prefer paying with USDC on Base
fdx call getX402Content \
  --url https://api.example.com/premium/data \
  --preferredNetworkName base \
  --preferredAsset USDC

# Set a max payment cap
fdx call getX402Content \
  --url https://api.example.com/premium/data \
  --maxPaymentAmount 1000000

# Just authorize without fetching
fdx call authorizePayment \
  --url https://api.example.com/premium/data

Flow

1. Check authentication with fdx status
2. Check wallet balance with fdx call getWalletOverview
3. Call fdx call getX402Content --url <endpoint> to fetch paid content
4. If the payment amount seems high, use fdx call authorizePayment first to inspect, then confirm with the human before proceeding
5. Return the fetched content to the human

Important: Always inform your human about the payment before executing, especially for unfamiliar endpoints or amounts that seem high. Let them confirm they want to proceed.

Difference from Coinbase x402

The Finance District wallet supports multi-chain and multi-asset x402 payments. You can specify a preferred network and asset, giving flexibility to pay from whichever chain and token has available balance. Coinbase's implementation is limited to Base USDC.

Prerequisites

• Must be authenticated (fdx status to check, see authenticate skill)
• Wallet must have sufficient balance in the required payment asset on the required network
• If insufficient funds, suggest using the fund-wallet skill or swap-tokens skill

Error Handling

• "Not authenticated" — Run fdx setup first, or see authenticate skill
• "Insufficient balance" — Check balance; see fund-wallet skill
• "No x402 payment requirements found" — The URL may not be an x402-enabled endpoint
• "Payment failed" — May be a network issue; retry or try a different preferred network

这个 Skill 整体质量良好，文档清晰易懂，提供了详细的使用步骤和示例，对错误情况的处理建议也很实用。不足之处在于缺少示例文件或常见问题解答等补充内容，可能导致用户在遇到问题时缺乏进一步指引。功能覆盖较为基础，但满足核心支付场景需求。